Sign in
Card

Provision card (Digital Wallet)

Allow your cardholders to directly add payment cards to the device's digital wallet (e.g. Apple Pay) with one touch from your app.

This requires some additional setup and configuration. Please Contact Us or your Customer Success representative for more information.

post/v1/cards/{card_token}/provision

Path parameters

card_tokenstring uuid required

The unique token of the card to add to the device's digital wallet.

Request body

certificatestring byte

Only applicable if digital_wallet is APPLE_PAY. Omit to receive only activationData in the response. Apple's public leaf certificate. Base64 encoded in PEM format with headers (-----BEGIN CERTIFICATE-----) and trailers omitted. Provided by the device's wallet.

client_wallet_account_idstring

Only applicable if digital_wallet is GOOGLE_PAY or SAMSUNG_PAY. Consumer ID that identifies the wallet account holder entity. Required for both wallets regardless of network, though the value is only used for cards on the Visa network and is ignored on Amex and Mastercard.

client_device_idstring

Only applicable if digital_wallet is GOOGLE_PAY or SAMSUNG_PAY. Stable device identification set by the wallet provider. Required for both wallets regardless of network, though the value is only used for cards on the Visa network and is ignored on Amex and Mastercard.

digital_wallet'APPLE_PAY' | 'GOOGLE_PAY' | 'SAMSUNG_PAY'

Name of digital wallet provider.

noncestring byte

Only applicable if digital_wallet is APPLE_PAY. Omit to receive only activationData in the response. Base64 cryptographic nonce provided by the device's wallet.

nonce_signaturestring byte

Only applicable if digital_wallet is APPLE_PAY. Omit to receive only activationData in the response. Base64 cryptographic nonce provided by the device's wallet.

Response

Returns provisioning_payload, a cryptographic payload representing a payment card that can be passed to a device's digital wallet. Each digital wallet has a different API; consult the wallet's documentation for more info.

Changes