<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "ApplePayontheWeb",
  "identifier" : "/documentation/ApplePayontheWeb/ApplePayShippingMethodUpdate",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Apple Pay on the Web"
    ],
    "preciseIdentifier" : "struct/ApplePayShippingMethodUpdate"
  },
  "title" : "ApplePayShippingMethodUpdate"
}
-->

# ApplePayShippingMethodUpdate

Updated transaction details that result from a change in shipping method.

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

## Overview

Provide updated transaction details if the user changes the shipping method in the payment sheet. Recalculate the total for the payment, because it may change as a result of shipping method changes. The [`newTotal`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate/newTotal) value is required.

## Topics

### Updating shipping method properties

[`sequence <ApplePayLineItem> newLineItems;`](/documentation/ApplePayontheWeb/ApplePayShippingMethodUpdate/newLineItems)

An optional list of updated line items.

[`required ApplePayLineItem newTotal;`](/documentation/ApplePayontheWeb/ApplePayShippingMethodUpdate/newTotal)

The new total that results from a change in the shipping method.

[`sequence <ApplePayShippingMethod> newShippingMethods;`](/documentation/ApplePayontheWeb/ApplePayShippingMethodUpdate/newShippingMethods)

An updated list of new shipping methods.

### Updating automatic reload payments

[`ApplePayAutomaticReloadPaymentRequest newAutomaticReloadPaymentRequest;`](/documentation/ApplePayontheWeb/ApplePayShippingMethodUpdate/newAutomaticReloadPaymentRequest)

An updated request for an automatic reload payment.

### Updating multitoken or multimerchant payment

[`sequence <ApplePayPaymentTokenContext> newMultiTokenContexts;`](/documentation/ApplePayontheWeb/ApplePayShippingMethodUpdate/newMultiTokenContexts)

An array of updated multitoken contexts for a multimerchant payment request.

### Updating recurring payments

[`ApplePayRecurringPaymentRequest newRecurringPaymentRequest;`](/documentation/ApplePayontheWeb/ApplePayShippingMethodUpdate/newRecurringPaymentRequest)

An updated request for a recurring payment.

### Updating deferred payments

[`ApplePayDeferredPaymentRequest newDeferredPaymentRequest;`](/documentation/ApplePayontheWeb/ApplePayShippingMethodUpdate/newDeferredPaymentRequest)

An updated request for a deferred payment.



---

Copyright &copy; 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)