Skip to main content

Card Identification

The Gateway will attempt to identify the type of each card number provided along with the associated Card Scheme (network) and, when available, the issuing institution and issuing country[1].

The Gateway primarily supports Mastercard, Visa and American Express branded cards. Some Acquirers may support JCB, Discover and Diners Club cards. Not all Acquirers support all types.

The card type and scheme codes will be returned in the cardTypeCode and cardSchemeCode response fields. When available, the issuer details will be returned in the cardIssuer and cardIssuerCountryCode response fields.

If the Gateway is unable to identify the card, then a code of ‘XX’ will be returned.

The following fields are returned by the Gateway to indicate a cards identity.

Field NameDescription
cardTypeCodeCard type identification code, eg ‘VD’.
cardTypeCard type name, eg ‘Visa Debit’.
cardSchemeCodeScheme identification code, eg ‘VC’.
cardSchemeScheme name, eg ‘Visa’.
cardIssuerCard Issuer’s name, eg ‘HSBC UK BANK PLC’.
cardIssuerCountryCodeIssuing country’s ISO-3166 2-letter code, eg ‘GB’.
cardIssuerCountryIssuing country’s name, eg ‘United Kingdom’.
cardFlags

Bitmask of flags where each bit number indicates the following:

01 – debit (not credit) card.

02 – alternative debit (not credit) card.

03 – prepaid card.

04 - virtual card.

09 – corporate card (not consumer) card.

10 - non-reloadable card.

11 - single use card.

12 – tokenised card (reserved for future use).

17 – ECOM use allowed (reserved for future use).

18 – MOTO use allowed (reserved for future use).

19 – EPOS use allowed(reserved for future use).

20 – CA use allowed (reserved for future use).

21 – LUHN conforming.

22 – 3-D Secure use allowed (doesn’t indicate card is enrolled).

29 - COF use allowed.

An unset bit may mean that the information is unavailable and not necessarily that the information doesn’t apply to the card.

[1] Issuing institution and country are primarily available for Visa and Mastercard issued cards only.

The following is a list of primary card types supported by the Gateway.

Card CodeScheme CodeCard Type
MCMCMastercard Credit
MDMCMastercard Debit
MAMCMastercard International Maestro
MIMCMastercard/Diners Club
MPMCMastercard Purchasing
MUMCMastercard Domestic Maestro (UK)
VCVCVisa Credit
VDVCVisa Debt
ELVCVisa Electron
VAVCVisa ATM
VPVCVisa Purchasing
AMAMAmerican Express
JCJCJCB
DSDSDiscover
DIDIDiners Club
DCDIDiners Club Carte Blanche
CUCUChina UnionPay
CCCUChina UnionPay Credit
CDCUChina UnionPay Debit

The following is a list of secondary card types recognised by the Gateway. These cards may be returned in response to a card lookup, but they are either deprecated or most likely not supported by any current Acquirer.

Card CodeScheme CodeCard Type
CFCFClydesdale Financial Services
BCBCBankCard
DKDKDankort
DEDIDiners Club Enroute
FCFCFlexCache
LSLSLaser
SOSOSolo
STSTStyle
SWSWSwitch
TPTPTempo Payments
IPIPInstaPayment

Footnotes​

  1. Issuing institution and country are primarily available for Visa and Mastercard issued cards only. ↩