Digital Wallet Push Provisioning

API for provisioning Apple Pay and Google Pay for Solid cards
Cards
Digital Wallet Push Provisioning
 last updated: 
December 14, 2023

The Provision API is used to enable in-app push provisioning for Apple Pay and Google Pay. Please also see this help center article on obtaining the necessary entitlements from Apple and Google.

Note: API is only operational in live mode.

Sample Code available here:

Apple Pay: GitHub - solidfi/ios-iap: iOS In App Push Provisioning Sample

Google Pay: GitHub - solidfi/android-iap: Android In App Push Provisioning Sample

Note: The header sd-device-id is optional.

ENDPOINT

  1. POST /v1/card/:id/provision

Note: The header sd-device-id is optional.

APPLE PAY REQUEST

  1. {
  2.   "wallet": "applePay",
  3.   "applepay": {
  4.     "deviceCert": "<apple-digitial-cert>",
  5.     "nonceSignature": "<nonce-signature>",
  6.     "nonce": "<nonce>"
  7.   }
  8. }

APPLE PAY RESPONSE

  1. {
  2.   "wallet": "applepay",
  3.   "applepay": {
  4.     "paymentAccountReference": "<account-ref>",
  5.     "activationData": "<activation-data>",
  6.     "encryptedPassData": "<pass-data>",
  7.     "ephemeralPublicKey": "<public-key>"
  8.   }
  9. }

GOOGLE PAY REQUEST

  1. {
  2.  "wallet": "googlePay",
  3.  "googlePay": {
  4.    "clientCustomerId": "",
  5.    "deviceId": ""
  6.  }
  7. }

GOOGLE PAY RESPONSE

  1. {
  2.   "wallet": "googlepay",
  3.   "googlepay": {
  4.     "paymentAccountReference": "",
  5.     "opaquePaymentCard": ""
  6.   }
  7. }