v5

latestOpenAPI 3.1.02026-07-262421791.5 MB

digital-wallet

Push provisioning for Google Pay

Returns encrypted cardholder information and other metadata needed for Google Pay push provisioning.

{% admonition type="warning" %} This API is not available for sandbox testing. {% /admonition %}

post/twcard-data/v1/push-provisioning/encrypted-payload/google-pay

Headers

x-tw-twcard-card-tokenstring uuid required

The card token identifying which card to retrieve push provisioning data for.

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

clientDeviceIdstring required

Stable device identification set by Wallet Provider. Could be computer identifier or ID tied to hardware such as TEE_ID or SE_ID. This field must match the clientDeviceId wallet provider will send in token provision request.

clientWalletAccountIdstring required

Client-provided consumer ID that identifies the Wallet Account Holder entity.

Example request

{
  "clientDeviceId": "ed6abb56323ba656521ac476",
  "clientWalletAccountId": "walletid"
}

Response

Encrypted cardholder information for Google Pay.

opaquePaymentCardstring

Encrypted authentication and activation data following card scheme and wallet provider specifications. The response is encoded in Base64.

cardNetwork'CARD_NETWORK_VISA' | 'CARD_NETWORK_MASTERCARD'

Card network.

tokenServiceProvider'TOKEN_PROVIDER_VISA' | 'TOKEN_PROVIDER_MASTERCARD'

Token service provider.

cardDisplayNamestring

Default card name that will be displayed in wallet.

cardLastDigitsstring

Last 4 digits of the card PAN.

Example response

{
  "opaquePaymentCard": "eyJraWQiOiIwQk...",
  "cardNetwork": "CARD_NETWORK_VISA",
  "tokenServiceProvider": "TOKEN_PROVIDER_VISA",
  "cardDisplayName": "Wise Card",
  "cardLastDigits": "1234",
  "userAddress": {
    "addressLine1": "56 Shoreditch High St",
    "addressLine2": "The Tea Bldg",
    "countryCode": "GB",
    "locality": "London",
    "name": "John Smith",
    "phoneNumber": "+441234567890",
    "postalCode": "E1 6JJ"
  }
}