CardMetadata

  • CardMetadata provides details about the card used in a transaction, including issuer, country of issuance, network, and card type.

  • This metadata is intended for processing and debugging purposes and may not be displayed to the user.

  • CardType is a required field that specifies whether the card is a credit, debit, or prepaid card.

  • Payment integrators may optionally provide issuer name, issuing country code, and supported networks for the card.

Metadata about the card returned from the payment integrator that may be useful for future processing and debugging.

JSON representation 
{
  "issuerName": string,
  "issuingCountryCode": string,
  "networks": [
    string
  ],
  "cardType": enum (CardType)
}
Fields
issuerName

string

OPTIONAL: The name of the card issuer. This is for internal use only and can take whatever format is most convenient for the payment integrator. It will not be displayed to the user and does not have to be human readable.
issuingCountryCode

string

OPTIONAL: The country code of the country that this card was issued in using ISO-3166-1 Alpha-2 format.
networks[]

string

OPTIONAL: The networks that this card can be processed on. These should be in upper case. e.g. VISA, MASTERCARD, AMEX
cardType

enum (CardType)

REQUIRED: The type of card.

CardType

The type of card.

Enums
CARD_TYPE_UNSPECIFIED Do not ever set this default value!
INTEGRATOR_CANNOT_SPECIFY_CARD_TYPE The payment integrator is not able to specify the Card Class.
CREDIT_CARD This card is a CREDIT card
DEBIT_CARD This card is a DEBIT card
PREPAID_CARD This card is a PREPAID card