Card

  • Payment card account information is represented in JSON format, including details like account number, name on card, and optional fields for expiry, CVN, and issuance date.

  • The required fields for a payment card account are the account number (FPAN) and the cardholder's name as printed on the card.

  • Optional fields like expiry month and year, CVN, issuance month and year can be included for enhanced security and verification.

Description of a payment card account (i.e., credit card, debit card, charge card).

JSON representation 
{
  "accountNumber": string,
  "expiryMonth": string,
  "expiryYear": string,
  "cvn": string,
  "issuanceDateMonth": string,
  "issuanceDateYear": string,

  // Union field cardholder_name_option can be only one of the following:
  "nameOnCard": string,
  "nameOnCardNotPresent": {
    object (Empty)
  }
  // End of list of possible types for union field cardholder_name_option.
}
Fields
accountNumber

string

REQUIRED: The account number itself (i.e., the FPAN).
expiryMonth

string

OPTIONAL: Expiration month, formatted MM.
expiryYear

string

OPTIONAL: Expiration year, formatted YY.
cvn

string

OPTIONAL: If Google collected the CVN from the user it is provided here and should be verified.
issuanceDateMonth

string

OPTIONAL: Issuance month, formatted MM.
issuanceDateYear

string

OPTIONAL: Issuance year, formatted YY.
Union field cardholder_name_option. REQUIRED: The option for providing the cardholder name. cardholder_name_option can be only one of the following:
nameOnCard

string

The customer's name as it appears on the card.
nameOnCardNotPresent

object (Empty)

Indicates that the cardholder name is not present. This option is used specifically for certain regions (such as Korea) or cases where there is not a cardholder name associated with the card, or one is not expected to be sent with the transaction or verification.