# ApplePayShippingContactUpdate Updated transaction details that result from a change in shipping contact, including any errors. ``` dictionary ApplePayShippingContactUpdate { required ApplePayLineItem newTotal; sequence newLineItems; sequence newMultiTokenContexts; ApplePayAutomaticReloadPaymentRequest newAutomaticReloadPaymentRequest; ApplePayRecurringPaymentRequest newRecurringPaymentRequest; ApplePayDeferredPaymentRequest newDeferredPaymentRequest; sequence errors; sequence newShippingMethods; }; ``` ## Overview You must provide an updated total after shipping contact information changes. You can optionally provide a list of errors, updated shipping methods, or updated line items. The system assumes the shipping contact update is successful if you don’t provide any `errors` in the [`ApplePayShippingContactUpdate`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate). ## Topics ### Updating shipping contact properties [`sequence errors;`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate/errors) A list of custom errors to display on the payment sheet. [`sequence newLineItems;`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate/newLineItems) An optional list of updated line items. [`sequence newShippingMethods;`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate/newShippingMethods) A list of shipping methods that are available to the updated shipping contact. [`required ApplePayLineItem newTotal;`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate/newTotal) The new total that results from a change in the shipping contact. ### Updating recurrring payments [`ApplePayRecurringPaymentRequest newRecurringPaymentRequest;`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate/newRecurringPaymentRequest) An updated request for a recurring payment. [`dictionary ApplePayRecurringPaymentRequest { required DOMString paymentDescription; required ApplePayLineItem regularBilling; ApplePayLineItem trialBilling; DOMString billingAgreement; required DOMString managementURL; DOMString tokenNotificationURL; };`](/documentation/ApplePayontheWeb/ApplePayRecurringPaymentRequest) A dictionary that represents a request to set up a recurring payment, typically a subscription. ### Updating deferred payments [`ApplePayDeferredPaymentRequest newDeferredPaymentRequest;`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate/newDeferredPaymentRequest) An updated request for a deferred payment. ### Updating automatic reload payments [`ApplePayAutomaticReloadPaymentRequest newAutomaticReloadPaymentRequest;`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate/newAutomaticReloadPaymentRequest) An updated request for an automatic reload payment. [`dictionary ApplePayAutomaticReloadPaymentRequest { required DOMString paymentDescription; required ApplePayLineItem automaticReloadBilling; DOMString billingAgreement; required DOMString managementURL; DOMString tokenNotificationURL; };`](/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 multitoken or multimerchant payments [`sequence newMultiTokenContexts;`](/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate/newMultiTokenContexts) An array of updated multitoken contexts for a multimerchant payment request. [`dictionary ApplePayPaymentTokenContext { required DOMString merchantIdentifier; required DOMString externalIdentifier; required DOMString merchantName; DOMString merchantDomain; required DOMString amount; };`](/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)