<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "ApplePayontheWeb",
  "identifier" : "/documentation/ApplePayontheWeb/ApplePayPaymentRequest/multiTokenContexts",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "Apple Pay on the Web"
    ],
    "preciseIdentifier" : "instp/ApplePayPaymentRequest/multiTokenContexts"
  },
  "title" : "multiTokenContexts"
}
-->

# multiTokenContexts

An array of payment token contexts that requests multiple payment tokens to support a multimerchant payment.

```
sequence <ApplePayPaymentTokenContext> multiTokenContexts;
```

## Discussion

Use multitoken contexts to indicate payments for multiple merchants. The sum of the [`amount`](/documentation/ApplePayontheWeb/ApplePayPaymentTokenContext/amount) of all the payment token contexts must be less than or equal to the grand total amount of the enclosing payment request. Otherwise, the request results in an error and cancels the payment request.

> Important:
> You can’t use this array with ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePayPaymentRequest/recurringPaymentRequest`` or ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePayPaymentRequest/automaticReloadPaymentRequest`` properties. Simultaneous use of these properties results in an error and cancels the payment request.

---

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)