---
title: ApplePayPaymentMethodUpdate
framework: applepayontheweb
role: symbol
role_heading: Structure
path: applepayontheweb/applepaypaymentmethodupdate
---

# ApplePayPaymentMethodUpdate

Updated transaction details to provide after the user changes the payment method in the payment sheet.

## Declaration

```data
dictionary ApplePayPaymentMethodUpdate {
	required ApplePayLineItem newTotal;
	sequence <ApplePayLineItem> newLineItems;
	sequence <ApplePayPaymentTokenContext> newMultiTokenContexts;
	ApplePayAutomaticReloadPaymentRequest newAutomaticReloadPaymentRequest;
	ApplePayRecurringPaymentRequest newRecurringPaymentRequest;
	ApplePayDeferredPaymentRequest newDeferredPaymentRequest;
	sequence <ApplePayError> errors;
	sequence <ApplePayShippingMethod> newShippingMethods;
};
```

## Mentioned in

Apple Pay on the Web Version 3 Release Notes

## Overview

Overview If a user changes their payment method on the payment sheet, you respond by updating the payment request details in 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](applepayontheweb/applepaypaymentmethodupdate/newlineitems.md)
- [newTotal](applepayontheweb/applepaypaymentmethodupdate/newtotal.md)
- [errors](applepayontheweb/applepaypaymentmethodupdate/errors.md)
- [newShippingMethods](applepayontheweb/applepaypaymentmethodupdate/newshippingmethods.md)

### Updating automatic reload payments

- [newAutomaticReloadPaymentRequest](applepayontheweb/applepaypaymentmethodupdate/newautomaticreloadpaymentrequest.md)
- [ApplePayAutomaticReloadPaymentRequest](applepayontheweb/applepayautomaticreloadpaymentrequest.md)

### Updating deferred payments

- [newDeferredPaymentRequest](applepayontheweb/applepaypaymentmethodupdate/newdeferredpaymentrequest.md)

### Updating recurring payments

- [newRecurringPaymentRequest](applepayontheweb/applepaypaymentmethodupdate/newrecurringpaymentrequest.md)
- [ApplePayRecurringPaymentRequest](applepayontheweb/applepayrecurringpaymentrequest.md)

### Updating multitoken or multimerchant payments

- [newMultiTokenContexts](applepayontheweb/applepaypaymentmethodupdate/newmultitokencontexts.md)
- [ApplePayPaymentTokenContext](applepayontheweb/applepaypaymenttokencontext.md)

## See Also

### Handling payment method updates

- [onpaymentmethodselected](applepayontheweb/applepaysession/onpaymentmethodselected.md)
- [completePaymentMethodSelection](applepayontheweb/applepaysession/completepaymentmethodselection.md)
- [ApplePayPaymentMethodSelectedEvent](applepayontheweb/applepaypaymentmethodselectedevent.md)
- [ApplePayPaymentMethod](applepayontheweb/applepaypaymentmethod.md)