FormOfPayment

  • FormOfPayment indicates the user's payment method, which can be 'noneChosen', 'issuerId', or 'card'.

  • 'noneChosen' means the user hasn't selected a payment method yet.

  • 'issuerId' represents a specific bank or e-wallet chosen by the user, identified by a unique Google-defined ID.

  • 'card' provides details about the user's payment card, including account number, name, and potentially expiry and CVN.

The form of payment (FOP) that the user already selected for this payment. If the user made no choice or it does not apply, this will be set to noneChosen.

JSON representation 
{

  // Union field fop can be only one of the following:
  "noneChosen": {
    object (Empty)
  },
  "issuerId": {
    object (IssuerId)
  },
  "card": {
    object (Card)
  }
  // End of list of possible types for union field fop.
}
Fields
Union field fop. REQUIRED: The form of payment the user selected for this payment. fop can be only one of the following:
noneChosen

object (Empty)

The user has not chosen any specific form of payment. For redirect payments where the user needs to select a FOP, the integrator should present a FOP selection UI upon redirect.
issuerId

object (IssuerId)

The Google-generated unique identifier of the issuer that the user wants to use for this payment. This identifier represents a specific bank / ewallet / etc. Google will maintain a hard-coded mapping of available issuers and their IDs. The payment integrator should notify Google when a change is required.
card

object (Card)

User's payment card account.

IssuerId

A unique identifier for an issuer of user accounts.

JSON representation 
{
  "value": string
}
Fields
value

string

REQUIRED: The string value of the identifier. This unique identifier is defined by Google. Google will share a list with the identifiers for all external issuers available through the payment integrator.

Card

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

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

string

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

string

REQUIRED: The customer's name as it appears on the card.
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.