Add a payment method to a device wallet
Provisions the payment method into the device wallet named by the wallet path parameter, returning the encrypted payload the platform wallet SDK needs to finish adding the card. Only apple_pay is supported today.
Your app must obtain the PassKit handshake before calling this endpoint. The certificates, nonce, and nonce_signature values come from the PKAddPaymentPassViewControllerDelegate callback and must be Base64-encoded — PassKit supplies them as Data, not strings.
The returned payload is single-use. Hand it straight to the wallet SDK; do not cache, log, or persist it. See the Add to Wallet guide for the full integration flow.
Required scope: CARD_WRITE
Authorizations
Basic HTTP authentication. Allowed headers-- Authorization: Basic <base64(api_key_id:api_key_secret)>
Path Parameters
The unique identifier of the payment method
"9ED4FE47-8E9C-48E9-BBEF-094DF1789012"
The target device wallet.
apple_pay "apple_pay"
Body
The Base64-encoded DER certificate chain from the PassKit delegate (generateRequestWithCertificateChain:), leaf first, then intermediate. PassKit supplies these as [Data] — Base64-encode each element.
1The Base64-encoded nonce from PassKit.
"3vT9Kw=="
The Base64-encoded nonce signature from PassKit.
"R0hJSktMTU5PUFE="