v66

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-042174421.1 MB

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 and the card is on the Visa network. Consumer ID that identifies the wallet account holder entity.

client_device_idstring

Only applicable if digital_wallet is GOOGLE_PAY or SAMSUNG_PAY and the card is on the Visa network. Stable device identification set by the wallet provider.

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.