Provision

Provision card (Digital Wallet)

post/v1/cards/{card_token}/provision

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.

Path Parameters

card_tokenstring

formatuuid

Body Parameters

certificatestring

optional

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.

formatbyte

client_device_idstring

optional

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.

client_wallet_account_idstring

optional

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.

digital_walletenum

optional

Accepts one of the following: "APPLE_PAY", "GOOGLE_PAY", "SAMSUNG_PAY"

Name of digital wallet provider.

Hide ParametersShow Parameters

"APPLE_PAY"

"GOOGLE_PAY"

"SAMSUNG_PAY"

noncestring

optional

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.

formatbyte

nonce_signaturestring

optional

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.

formatbyte

Returns

provisioning_payloadstring

optional

Request example Request

curl https://api.lithic.com/v1/cards/$CARD_TOKEN/provision \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{}'

200 Example

{
  "provisioning_payload": "provisioning_payload"
}