# ApplePayPaymentMethodUpdate Updated transaction details to provide after the user changes the payment method in the payment sheet. ``` dictionary ApplePayPaymentMethodUpdate { required ApplePayLineItem newTotal; sequence newLineItems; sequence newMultiTokenContexts; ApplePayAutomaticReloadPaymentRequest newAutomaticReloadPaymentRequest; ApplePayRecurringPaymentRequest newRecurringPaymentRequest; ApplePayDeferredPaymentRequest newDeferredPaymentRequest; sequence errors; sequence newShippingMethods; }; ``` ## Overview If a user changes their payment method on the payment sheet, you respond by updating the payment request details in [`ApplePayPaymentMethodUpdate`](/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate). You must provide an updated total for the transaction in the `newTotal` line item. You can optionally provide updated line items if the change to the payment method changes the line items. ## Topics ### Updating payment method properties [`newLineItems`](/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate/newLineItems) An optional list of updated line items for the payment request that results from the user’s change to the payment method. [`newTotal`](/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate/newTotal) The new total that results from the user’s change to the payment method. [`errors`](/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate/errors) A list of customized errors you provide that results from the user’s change to the payment method. [`newShippingMethods`](/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate/newShippingMethods) The updated list of available shipping methods that results from the user’s change to the payment method. ### Updating automatic reload payments [`newAutomaticReloadPaymentRequest`](/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate/newAutomaticReloadPaymentRequest) An updated request for an automatic reload payment. [`ApplePayAutomaticReloadPaymentRequest`](/documentation/ApplePayontheWeb/ApplePayAutomaticReloadPaymentRequest) A dictionary that represents a request to set up an automatic reload payment, such as a store card top-up or a prepaid account. ### Updating deferred payments [`newDeferredPaymentRequest`](/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate/newDeferredPaymentRequest) An updated request for a deferred payment. ### Updating recurring payments [`newRecurringPaymentRequest`](/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate/newRecurringPaymentRequest) An updated request for a recurring payment. [`ApplePayRecurringPaymentRequest`](/documentation/ApplePayontheWeb/ApplePayRecurringPaymentRequest) A dictionary that represents a request to set up a recurring payment, typically a subscription. ### Updating multitoken or multimerchant payments [`newMultiTokenContexts`](/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate/newMultiTokenContexts) An array of updated multitoken contexts for a multimerchant payment request. [`ApplePayPaymentTokenContext`](/documentation/ApplePayontheWeb/ApplePayPaymentTokenContext) A dictionary that defines the context for a single payment token in a payment request for multimerchant payments. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)