Google In-App Push Provisioning - Field Descriptions
The following page details each of the fields sent in the request and received in the response when using the Google Unified Push Provisioning endpoint.
Request Fields
The following table describes fields that can be included in the body of the request when using the Google Unified Push Provisioning endpoint.
| Field | Description | Length | Type | Mandatory? |
|---|---|---|---|---|
| clientWalletProvider | The Token Requestor’s ID (TRID). Only required for Visa. | 50 | String | Conditional |
| clientWalletAccountID | Client-provided consumer ID that identifies the Wallet Account Holder entity. Only required for Visa. | 24 | String | Conditional |
| clientDeviceID | The stable device identifier set by the Wallet Provider. This can be a computer identifier or ID tied to hardware such as TEE_ID or SE_ID. Required by Visa push provisioning. | 24 | String | Conditional |
| clientAppID | Unique identifier for the client application, used to provide some of the encrypted values. Example: Issuer’s AppID used to select the PAN and the wallet. Required for Visa push provisioning. | 36 | String | Conditional |
| billing | Object that contains information on the cardholder's billing address. If Thredd holds no address information of Cardholder then this is mandatory. | Conditional | ||
| line1 | First line of the cardholder's billing address. | 64 | String | Conditional |
| line2 | Second line of the cardholder's billing address. | 64 | String | Conditional |
| city | The city for the cardholder's billing address. | 32 | String | Conditional |
| countrySubdivision | The country subdivision (for example, a county or state) of the cardholder's billing address. | 12 | String | Conditional |
| postalCode | The post code for the cardholder's billing address. | 26 | String | Conditional |
| country | The country for the cardholder's billing address, expressed as a 3-letter (alpha-3) country code as defined in ISO 3166-1. | 3 | String | Conditional |
| billing | End of the billing object. | |||
| serverSessionID | This value should be generated via the Google SDK. It is a unique value created on Google's servers. When populated, this field triggers the inclusion of a Google Opaque Payment Card in the response. | String | Optional |
Response Fields
A successful response for the Google Unified Push Provisioning endpoint will return a 200 response.
| Field | Description |
|---|---|
| opaquePaymentCard | Base64 encoded JSON object IssuerInitiatedDigitizationData containing both fundingAccountInfo and tokenizationAuthenticationValue. See Mastercard Developers. |
| last4digits | The last 4 digits of the account number. |
| name | First name and surname of the cardholder. |
| network | The name of network associated with card. For example, Visa or Mastercard. |
| address | Object that contains information on the cardholder's address. |
| line1 | First line of the cardholder's billing address. |
| line2 | Second line of the cardholder's billing address. |
| city | The city for the cardholder's billing address. |
| countrySubdivision | The country subdivision (for example, a county or state) of the cardholder's billing address. |
| postalCode | The post code for the cardholder's billing address. |
| country | The country for the cardholder's billing address, expressed as a 3-letter (alpha-3) country code as defined in ISO 3166-1. |
| address | End of the address object. |
| googleOpaquePaymentCard | Base64‑encoded bytes containing a PGP‑encrypted Google Opaque Payment Card associated with a Google account card‑on‑file. |