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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "nameOnCard": string,
  "nameOnCardNotPresent": {
    object (Empty)
  }
  // End of mutually exclusive fields.
}
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.
REQUIRED: The option for providing the cardholder name. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response:
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.
End of mutually exclusive fields.