## The UpdateDetails object


This object is passed to the `updateWith` callback on a [PaymentRequest's](/js/payment_request/create.md) `shippingaddresschange` and `shippingoptionchange` events.

- `status` (string)
  The browser uses this value to show an error message to the customer if they‘ve taken an action that invalidates the payment request.
The value must be one of the following:

  - `'success'` (value)
    Let the customer proceed.

  - `'fail'` (value)
    Prevent the customer from making the change they just made.

  - `'invalid_shipping_address'` (value)
    Equivalent to `fail`, except we show a more specific error message.
Can only be used in a [`shippingaddresschange`](/js/payment_request/events/on_shipping_address_change.md) handler.

- `total` (PaymentItem)
  The new total amount, if applicable, as a [PaymentItem](#payment_item_object) object.

- `displayItems` (array)
  An array of [PaymentItem](#payment_item_object) objects.
These PaymentItems are shown as line items in the browser‘s payment interface.
Note that the sum of the line item amounts does not need to add up to the total amount above.

- `shippingOptions` (array)
  An array of [ShippingOption](/js/appendix/shipping_option.md) objects.
The first shipping option listed appears in the browser payment interface as the default option.

- `applePay` (object)
  Specify Apple Pay specific options. These are passed through to the Apple Pay API.

  - `recurringPaymentRequest` (object)
    Specify a request to set up a recurring payment. See the [Apple Pay documentation](https://developer.apple.com/documentation/apple_pay_on_the_web/applepayrecurringpaymentrequest) for more details.

    - `paymentDescription` (string) **required**

    - `managementURL` (string) **required**

    - `regularBilling` (object) **required**

      - `amount` (number) **required**

      - `label` (string) **required**

      - `recurringPaymentStartDate` (Date)

      - `recurringPaymentEndDate` (Date)

      - `recurringPaymentIntervalUnit` ('year' | 'month' | 'day' | 'hour' | 'minute')

      - `recurringPaymentIntervalCount` (number)

    - `trialBilling` (object)

      - `amount` (number) **required**

      - `label` (string) **required**

      - `recurringPaymentStartDate` (Date)

      - `recurringPaymentEndDate` (Date)

      - `recurringPaymentIntervalUnit` ('year' | 'month' | 'day' | 'hour' | 'minute')

      - `recurringPaymentIntervalCount` (number)

  - `automaticReloadPaymentRequest` (object)
    Specify a request to set up an automatic reload payment. See the [Apple Pay documentation](https://developer.apple.com/documentation/apple_pay_on_the_web/applepayautomaticreloadpaymentrequest) for more details.

    - `paymentDescription` (string) **required**

    - `managementURL` (string) **required**

    - `automaticReloadBilling` (object) **required**

      - `amount` (number) **required**

      - `label` (string) **required**

      - `automaticReloadPaymentThresholdAmount` (number) **required**