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.

Onboarding Requirements

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

Last updated