For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Pay

Storing Google Pay DPAN in CMP

Create Card API Request

CMP’s Create Card API also supports storing Google Pay digital wallet cards (DPANs), along with standard physical cards (PANs).

Cards classified as dpan from Google Pay do not activate downstream services like Account Updater or Network Token provisioning, even if onCreate enrollment type is enabled.

To add a Google Pay DPAN, include the wallet token in the pan field and provide the following fields in the card object:

  • wallet_type: google_pay

  • token_type: dpan

Google Pay Digital Wallet Fields

CMP can store decrypted Google Pay DPAN cards securely. While stored like regular PANs, these cards are flagged to indicate their Google Pay source.

  • wallet_type: google_pay

  • token_type: dpan

Merchants must use lowercase for these fields to pass validation checks.

Important: Google Pay wallet tokens are only accessible through GET /cards/{id}. Notifications will not include these cards, but the card object will clearly indicate DPAN using the token_type field.

Create Card - Validation Rules for Google Pay

  • If creating a DPAN from Google Pay, the wallet_type field is required. Omitting it results in a 422 Unprocessable Entity error.

  • For physical PANs, both wallet_type and token_type are optional, but token_type always appears as pan in the response.

  • You can also explicitly set "token_type": "pan" and "wallet_type": "google_pay" for a regular PAN. This allows you to indicate that the card is associated with Google Pay even if it isn’t a DPAN.

  • Both fields must be lowercase. Variations such as "Google Pay" or "google_Pay" will fail validation. Uppercase DPAN will also fail and return 400 Bad Request.

Sample request and response: VGS Card Management API – Create a Card.

Retrieve Card (GET /cards/{id})

Google Pay cards will return the wallet_type and token_type as originally sent (wallet_type: google_pay, token_type: dpan), confirming the card’s type and source.

Reference: VGS Card Management API – Get a Card.

Google Pay ECI Indicator Reference

Wallet
Network
ECI value
Authentication / liability meaning
What it means when passed to processor

Google Pay

Mastercard

"02"

Fully authenticated / successful authentication

Issuer liability. This is the expected successful Mastercard Google Pay cryptogram case.

Google Pay

Mastercard

"06"

Not fully authenticated / no issuer liability

Merchant/acquirer liable. Auth can still be processed, but liability does not shift to issuer.

Google Pay

Mastercard

Empty

Not authenticated / no issuer liability

Merchant/acquirer liable. Auth can still be processed, but no ECI-based liability shift.

Google Pay

Visa

"05"

Fully authenticated / successful authentication

Issuer liability. This is the expected successful Visa Google Pay cryptogram case.

Google Pay

Visa

"07"

Not authenticated / no issuer liability

Merchant/acquirer liable. Auth can still be processed, but liability does not shift to issuer.

Google Pay

Other networks

Empty

Not authenticated or ECI not provided by wallet/network

Merchant/acquirer liable. Auth can still be processed, but no ECI-based liability shift.

Onboarding Requirements

No additional onboarding is required. Any customer already able to create cards in CMP can start storing Google Pay cards immediately.

Card Attributes

Card Attributes are available for DPAN.

Last updated