Skip to main content
POST
Google Pay push provisioning

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-audit-user
string

Optional audit user header

Path Parameters

cardId
string<uuid>
required

CardId for the card that should be provisioned (returned from card operation)

Body

application/json
clientAppID
string

Only applicable for VTS customers

Maximum string length: 36
clientDeviceID
string

Only applicable for VTS customers. Unique identifier for the device being provisioned.

clientWalletAccountID
string

Only applicable for VTS customers. Wallet account identifier for the cardholder.

tokenRequestorID
string

Only applicable for VTS customers. Visa-assigned Token Requestor ID (TRID) for the target wallet.

Maximum string length: 11
Pattern: ^[0-9]{1,11}$
googleOpaquePaymentCardRequested
boolean

Unified Push Provisioning (UPP). Whether to also generate and return a Google OPC so the cardholder's FPAN can be saved to their Google Account.

serverSessionId
string

Unified Push Provisioning (UPP). Session identifier used by Google when generating the Google OPC. Required and must contain at least one non-whitespace character when googleOpaquePaymentCardRequested is true; otherwise ignored. Missing, empty, or whitespace-only values return HTTP 400 when OPC is requested.

Response

OK

digitizationData
string | null

Mastercard (MDES) path: Base64 encoded JSON containing card digitisation data. Populated when the card belongs to a Mastercard program; null on the Visa path.

Example:

"eyJmdW5kaW5nQWNjb3VudEluZm8iOnsiZW5jcnlwdGVkUGF5bG9hZCI6eyJlbmNyeXB0ZWRLZXkiOiIwNDhmYjgyZDUzYmE1MjE4MDVhMWU3ZTAxMGZiYjQ2MTEyZWMzYzBiOWM3MjJhNWVkMDgwN2JhYTUyYmY3ZDFiMWMxZGFhYzVkNTQwOGVlZTc2MWIzODUwMTIxYjIwM2IyNmQwZTZiODYzNzIyNzUxY2I3NGE4YThiY2I3NDIxMmFiMDgxZGQ0ZjU1ZTM2ZDhiZjE2Mzc0Mzk0ZGQ3YjA2ZjRiYzAwZjM5YTUwZTI5NDk3MzRiYWMyZWVhY2Y3ZjIxMWFmMjQ0NGQwYmUxZTk2YzBhM2NkNjQwNmU3NGM2ZTkxZGI4OTRmNWE4MTBjOTY0ZGY4ODdjMDBjMzdkZTVkNTI5MTk3MGYyNDMyOTVlNGI3MzgzNmEyYzJiMDhmZTFmNjc5ZjRiMjkwMzhhODdjYTgwMjg3ZTExZDgzYzcxODkyMDk0NTEzNjIyYWU4OWM0NTk3ZmM1MWY0NDA3Y2ZhZWZiZmNkZTkxYjJhNDNhMTQ3NjNkY2E2Y2Q4YWM2MDk3MmRmZDUxNmZmNWI5YjQzZDliOGM5Yzg5ZjYxY2NkNmEyMzA3YTQ4YTVlYzRlNDZlYzE4MmI0Yjk1YmQ0ZGEyNTA3YjZjNzlhMjY1YzBjOWRkYThiYjZhNmM3M2U0NDhiY2E0OGFjZGMzY2U4YTQ1MGE3YjllYjVkYjQ3ZWFjZSIsIml2IjoiNzRlZGU5ZDUyNDc4Yjk4ZTQ1NDEzYzIyMDcwNzlkYmQiLCJvYWVwSGFzaGluZ0FsZ29yaXRobSI6IlNIQTI1NiIsInB1YmxpY0tleUZpbmdlcnByaW50IjoiMjI5MGExMzdiOTRiZmI3YWI0YzA2OTA5MWQ3Yjc5OWMzN2UyMWY1NGYzYmRhOGNiZDAwODZmNzk0YzE0OTkyZSIsImVuY3J5cHRlZERhdGEiOiI2YTgyYmJmMzNjZjZiMjk3MjY0ZDIwM2I1ZjU4YTMzZDdlM2NkMGU3YjNiY2E1NTJkYjQwY2NmZjg2NzI4ZDc3YjRjN2JhMzI3YTg3ZmI0MTg5ZmJjZGM5NTExYjZiZTJkZGZlOTRkODViMjBkNmFmOGRlYTM5OWE5MTAzYTQzYmRkOTc4YTNkOWM2MDlhZTQyYzUwMGJiYjNlNWVmMjhmNDg3ZmM4MDQzY2MwOWY3YTQzMjE2YzZjMWY1NDFhNTkxM2U5OGRmNzlmYzY3YjM3ZmFiY2RhNTliZDQ3Njk2YjFmMzlhYWM5NGE3ODQyNmRiOGZkNTY4NmY4NDFmNDZiZDNhMjEyMTdmYTYwYjAxMDQ0YWI4YmFkNjRmY2M0YTFhOGY2MDNkNGIzNGUyZmYwMmY1N2Y1OGQ4NzI3NWUwYTkzZDc1ZDVhOWQ2ZjIxN2M5MmEyZjZjNDViMzE3YjkzZTg2YmNlNzc5NDExM2I3ODEyYzY4NmNiODYzMzlhM2Y0MDVkMDNmZmVjZTg4NWQ4ODFlYjA5ZmM4NDQ5ZTgxMzgzYmM1ZTJhOGI0MWQ4MTUxNmRjMGI2OGExZGQxNTgyNzQwNmQ5OTNjNjU1MGZjNzA2MmNlNjZkZWVmNzAwNzNkMmNiMjQ3NmEyZjc2MGU0ODVmZDgxMzY1MTc1ZjczYTQ2ZWU4NzI4YzRjNGNhODhmMzljNTgwYzUwZjYwNDBjYWM2ZmYyZjVlNzZjZTAxYTg1YTUxYTI5NDBmMTQ4YWQ3YjFiNTRhZTM3MGY4NjlmYTJmOGFiNGVmOTE3ZjU4MjUyN2FjYjk1MTkwOGU3NTVkNmE0YmNjNzUwODBiMmFkYjMwZTg5MmMyZTM0ZDE0MTA3MGZiMjJhMWQzMmEwY2U4ZDg5Nzg3M2ZjYzFhNzRmMGFmYWE2MDU4MzZhMjY3YyJ9LCJwYW5VbmlxdWVSZWZlcmVuY2UiOm51bGwsInRva2VuVW5pcXVlUmVmZXJlbmNlIjpudWxsfSwidG9rZW5pemF0aW9uQXV0aGVudGljYXRpb25WYWx1ZSI6ImV5SjJaWEp6YVc5dUlqb2lOQ0lzSW1SaGRHRldZV3hwWkZWdWRHbHNWR2x0WlhOMFlXMXdJam9pTWpBeU5pMHdOUzB5TmxReE5qb3dPRG8wTmxvaUxDSnJaWGxCYkdsaGN5STZJakkwTVRVd05DMUZUa1pWUTBVdFRWbERUMUpGTFZSQlZpMHdOakkxSWl3aWMybG5ibUYwZFhKbElqb2liR3AwY1VSdVlYbEVUa2RhV0RWc2VYVlVjVkpyVlc1WFV6QjJZbXBKZGt3ME55dENkblJHT0UwdlR6UllUbFJGYnpjd1IxRXpZbGcxTVUxRVRUVTBSbWhJVkVZcmMwOWFjamR5YjBRelowVkpRMEpRVjI5M05qUTVLMDFuY2xseFpHSm5UMmhxVFZCVU0zZEpXWFZ3V1hSMFFqVlBVVE5CTkdKemVqUm9aMkU1WjBoNlNEUnpVazl3Ym01NGJIZE5OR0Z4VGtGUFJXVTJlRmsyU21kaFJVdzNaRTFCTTFaWGEzaEVUWEl3SzJaQ09ESmhNVTVPTTNsVFF6aFdTSGxCTmxGM2EybHhhbUZNVldFd2VTdGFNbmhIY0hBMkx6WndMM2h5T1cxSU9HSmFkbVJwTkhKUmIwUmpjMGxQUTAxbE5ETnBZVVphVERCc2FIcFJTVXhuWVVWVVpGUmxMMVo0UzFGVk0wOWFZbmN4YTFOTlZIZEVUbEYyTVZSSmIxRmhia1E0WXk4MGVuQXZOekIwU1M4NWFHSnNhME5EVWt0M1ltWjJUVUZOUzA1U1ZteFJWWFJsVWtodmFsVTFOVEpZVEhaS0x6Um5QVDBpTENKemFXZHVZWFIxY21WQmJHZHZjbWwwYUcwaU9pSlNVMEV0VTBoQk1qVTJJaXdpYVc1amJIVmtaV1JHYVdWc1pITkpiazl5WkdWeUlqb2laR0YwWVZaaGJHbGtWVzUwYVd4VWFXMWxjM1JoYlhCOFlXTmpiM1Z1ZEU1MWJXSmxjbnhoWTJOdmRXNTBSWGh3YVhKNUluMD0ifQ"

paymentInstrument
string

Visa (VTS) path: Compact JWE string (A256GCMKW/A256GCM) to pass to the VTS Enroll API. Populated when the card belongs to a Visa program. Absent on the Mastercard path. The wallet must call VTS Enroll within 3 minutes of receiving it (the encrypted data expires 20 minutes after issue) with panSource=ISSUER_PUSH_PROVISION, and the clientWalletAccountID / clientDeviceID in the Enroll request must match the values supplied in this provisioning request.

googleOpaquePaymentCard
string

Unified Push Provisioning (UPP). Present only when googleOpaquePaymentCardRequested was set on the request. PGP-signed, Google-encrypted payload used by Google to save the cardholder's FPAN to their Google Account.