Sign in

v1

latestOpenAPI 3.0.02026-07-2352269214.0 KB

Prepare Push Provisioning Bundle

API used for requesting D1 Transit to prepare a push provisioning bundle that is going to be provided by Transit Issuer mobile app to Digital Wallet SDK eventually.<br/><br/> This request can be used in 3 different cases:<br/> 1) initial provisioning: in such case, Transit Issuer shall neither provide cardAccountId nor digitalCardId. D1 Transit will create and return these identifiers in the response.<br/> 2) retry failed provisioning: in case of provisioning failure, Transit Issuer may retry the provisioning, assuming there was no refund/cancellation of customer card account.<br/> In such case, both cardAccountId and digitalCardId shall be provided.<br/> 3) restoring an existing cardAccount: in such case, Transit Issuer shall provide cardAccountId only. D1 Transit will assign new digitalCardId and return it along with cardAccountId in the response.<br/>

post/issuers/{issuerId}/wallets/{walletIndicator}/preparePushProvisioningBundle

Path parameters

issuerIdstring required

Issuer unique identifier. Assigned by Thales during onboarding.

walletIndicatornumber required

Indicates which digital wallet is involved in the use case.

ValueDescription
1Apple
2Google
3Samsung

Request body

cardAccountIdstring

The Card Account Identifier. Unique for each card account.

digitalCardIdstring

Unique identifier of the digital card.

Response

cardAccountIdstring

The Card Account Identifier. Unique for each card account.

digitalCardIdstring

Unique identifier of the digital card.

pushProvisioningBundlestring

Bundle generated as per Digital Wallet format specified in the request.<br/>It shall be used by the transit issuer app to trigger the provisioning.

Apple format<br/>

This is the string representation of JSON object defined as below:

Parameter nameTypeDescription
activationDatastringSee https://developer.apple.com/documentation/passkit/pkaddpaymentpassrequest/activationdata
encryptedPassDatastringSee https://developer.apple.com/documentation/passkit/pkaddpaymentpassrequest/encryptedpassdata
ephemeralPublicKeystringSee https://developer.apple.com/documentation/passkit/pkaddpaymentpassrequest/ephemeralpublickey

Google format<br/>

This is the OpaquePaymentCard (OPC) as described in https://developers.google.com/pay/issuers/apis/push-provisioning/android/wallet-operations

Not provided in case of error.