<!--
{
  "availability" : [

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

# ApplePayPaymentTokenContext

A dictionary that defines the context for a single payment token in a payment request for multimerchant payments.

```
dictionary ApplePayPaymentTokenContext {
	required DOMString merchantIdentifier;
	required DOMString externalIdentifier;
	required DOMString merchantName;
	DOMString merchantDomain;
	required DOMString amount;
};
```

## Overview> Important:
> You must include the ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePayModifier/multiTokenContexts`` array in the ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePayPaymentRequest`` object to request multimerchant payments.

Use [`ApplePayPaymentTokenContext`](/documentation/ApplePayontheWeb/ApplePayPaymentTokenContext) to authorize a payment amount for each payment token in a multimerchant payment request. To enable multiple merchants for a transaction, use one [`ApplePayPaymentTokenContext`](/documentation/ApplePayontheWeb/ApplePayPaymentTokenContext) object for each merchant.

You can optionally associate each payment token with the merchant’s top-level domain.

## Topics

### Specifying the merchant

[`required DOMString merchantIdentifier;`](/documentation/ApplePayontheWeb/ApplePayPaymentTokenContext/merchantIdentifier)

The Apply Pay merchant identifier.

[`required DOMString merchantName;`](/documentation/ApplePayontheWeb/ApplePayPaymentTokenContext/merchantName)

The merchant’s display name that the Apple Pay server associates with the payment token.

[`DOMString merchantDomain;`](/documentation/ApplePayontheWeb/ApplePayPaymentTokenContext/merchantDomain)

The merchant’s top-level domain that the Apple Pay server associates with the payment token.

[`required DOMString externalIdentifier;`](/documentation/ApplePayontheWeb/ApplePayPaymentTokenContext/externalIdentifier)

An external identifier for the merchant.

### Indicating a payment amount

[`required DOMString amount;`](/documentation/ApplePayontheWeb/ApplePayPaymentTokenContext/amount)

The amount to authorize for the payment token context.


---

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)