Skip to main content
POST
Add a payment method to a device wallet

Authorizations

Authorization
string
header
required

Basic HTTP authentication. Allowed headers-- Authorization: Basic <base64(api_key_id:api_key_secret)>

Path Parameters

payment_method_id
string
required

The unique identifier of the payment method

Example:

"9ED4FE47-8E9C-48E9-BBEF-094DF1789012"

wallet
enum<string>
required

The target device wallet.

Available options:
apple_pay
Example:

"apple_pay"

Body

application/json
certificates
string[]
required

The Base64-encoded DER certificate chain from the PassKit delegate (generateRequestWithCertificateChain:), leaf first, then intermediate. PassKit supplies these as [Data] — Base64-encode each element.

Minimum array length: 1
Example:
nonce
string
required

The Base64-encoded nonce from PassKit.

Example:

"3vT9Kw=="

nonce_signature
string
required

The Base64-encoded nonce signature from PassKit.

Example:

"R0hJSktMTU5PUFE="

Response

Provisioning payload for PKAddPaymentPassRequest.

wallet
enum<string>
required

The wallet the payment method was provisioned into.

Available options:
apple_pay
provisioning_payload
object
required

Maps field-for-field onto PKAddPaymentPassRequest. All values are Base64-encoded.