Digital Wallets (Enterprise)

Learn how to add cards to digital wallets.

Provision Card - Digital Wallet (Enterprise)

API Reference: 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.

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.

🚧

Provisioning digital wallets requires some additional setup and configuration. Please reach out to [e-mail] or your Customer Success rep for more information.

POST https://api.privacy.com/v1/cards/{card_token}/provision

Sample Request

Bash

curl https://api.privacy.com/v1/cards/f5f905f5-8a8e-49bf-a9b4-c0adaa401456/provision \
  -X POST \
  -H "Authorization: api-key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '
{
     "digital_wallet":"SAMSUNG_PAY"
}
'

Sample Response

JSON

{
     "provisioning_payload": "{\"activationData\":..."
}

card_token (required, path parameter)	Globally unique identifier for the card to be added to a device's digital wallet. String. Permitted values: 36-digit version 4 UUID (including hyphens).
digital_wallet (required)	Name of digital wallet to which the card will be added. String. Permitted values: APPLE_PAY, SAMSUNG_PAY. GOOGLE_PAY coming soon.
certificate (required only if digital_wallet is APPLE_PAY)	Apple's public leaf certificate, provided by the device's wallet. String. Permitted values: Base64 encoded in PEM format with headers (-----BEGIN CERTIFICATE-----) and trailers omitted.
nonce (required only if digital_wallet is APPLE_PAY)	Number provided by the device's wallet to prevent replay attacks. String. Permitted values: Base64 cryptographic nonce.
nonce_signature (required only if digital_wallet is APPLE_PAY)	Device-specific signature for the nonce provided by the device's wallet. String. Permitted values: Base64 nonce signature.