Create an Apple Pay session | TTG Developer Portal

Apple Pay requires a server-side merchant validation step before the browser can open the payment sheet. Call this when the shopper taps the Apple Pay button, then pass the returned merchantSession unchanged to ApplePaySession.completeMerchantValidation. Sessions are short-lived, so mint one per payment attempt rather than caching. The Origin request header must carry the domain the shopper is paying on, and that domain must be registered with Apple Pay. Google Pay needs no equivalent — it initializes client-side.

Apple Pay requires a server-side merchant validation step before the browser can open the payment sheet. Call this when the shopper taps the Apple Pay button, then pass the returned `merchantSession` unchanged to `ApplePaySession.completeMerchantValidation`. Sessions are short-lived, so mint one per payment attempt rather than caching. The `Origin` request header must carry the domain the shopper is paying on, and that domain must be registered with Apple Pay. Google Pay needs no equivalent — it initializes client-side.

Authentication

X-TT-API-Keystring

API Key authentication via header

Request

This endpoint expects an object.

currencystringRequiredformat: "^[A-Z]{3}$">=1 character

ISO 4217 currency the shopper will pay in. Selects the merchant account the session is minted for, so Apple Pay must be enabled for this currency.

Response

Apple Pay merchant session.

merchantSessionmap from strings to objectsOptional

Opaque, time-limited merchant session issued by Apple. Pass it unchanged to the browser’s ApplePaySession.completeMerchantValidation to open the payment sheet.

$	curl -X POST https://stg.ttix.io/api/v3/apple-pay-sessions \
>	-H "X-TT-Platform: android" \
>	-H "X-TT-API-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"currency": "USD"
>	}'

Authentication

Headers

Request

Response