In-App Push Provisioning

In-app push provisioning lets a cardholder add a card to their wallet by tapping a button in your app, instead of typing card details. It converts far better than manual entry and removes the step where cardholders mistype a PAN. It is the one provisioning method that requires integration work: with the wallet provider’s SDK, and with Synctera to obtain the payload that SDK expects.

Before you build, your program needs push provisioning entitlements from Apple and Google, and must pass their UX reviews. See Program Setup.

Apple Pay

curl -X POST "$baseurl/v2/cards/{CARD_ID}/digital_wallet_tokens/applepay" \
  -H "Authorization: Bearer $apikey" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "device_type": "MOBILE_PHONE",
    "provisioning_app_version": "2.13.7",
    "certificates": [
      "MIIEPDCCA+KgAwIBAgICEAAwCQYHKoZIzj...",
      "MIIDZjCCAw2gAwIBAgIJAJx22AGaEPSgMA..."
    ],
    "nonce": "vXWJaBidcTLaJJCF",
    "nonce_signature": "jD4Aphu+93N2wbBn"
  }'

The certificates, nonce, and nonce_signature come from Apple’s SDK. The response returns encrypted_pass_data, activation_data, and ephemeral_public_key to pass back to it. See Create Digital Wallet Token for Apple Pay.

Google Wallet

curl -X POST "$baseurl/v2/cards/{CARD_ID}/digital_wallet_tokens/googlepay" \
  -H "Authorization: Bearer $apikey" \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "device_type": "MOBILE_PHONE",
    "provisioning_app_version": "2.13.3",
    "wallet_account_id": "ae25OGhjZTk2dsr452dgsr51",
    "device_id": "W85OGhjZTk2dsr452dgsr51j"
  }'

The response returns push_tokenize_request_data for Google’s SDK. See Create Digital Wallet Token for Google Pay.

Overview

Onboard a Personal Customer

Onboard a Business Customer

Create Accounts

Link External Accounts

Link External Cards

Issue Cards

Move Money

Get Transactions

Dispute Transactions

Platform Tools

Use Cases

In-App Push Provisioning

Apple Pay

Google Wallet

Next Steps

Token Lifecycle Management

Provisioning Decisions

​Apple Pay

​Google Wallet

​Next Steps

Token Lifecycle Management

Provisioning Decisions

Apple Pay

Google Wallet

Next Steps