All JSON objects

card:response

Key	Format	Condition	Description
cardholderName	string	C	Presence depends on merchant configuration. Name of the cardholder as printed on the card.
number	string	C	Presence depends on merchant configuration. If present this element entails either the masked card number or the 1cs Online Payment System card token.
expiryDate	string	C	Present if number entails the 1cs Online Payment System card token.
bin	object	M	Bank Identification Number including account range if applicable.
brand	string	M	Card network name (e.g. ‘Visa’, ‘MasterCard’).
product	string	C	Card product name (if available) (e.g. ‘Business Premium Debit’).
source	string	C	Card funding source (if available). Values accepted: · DEBIT · CREDIT · DEFERRED DEBIT · PREPAID · CHARGE
type	string	C	The card type specifies the program, application or card level attached to the card if any (e.g. Classic, Standard, Gold, Business etc.).
country	JSON	M	Country the card was issued in.
issuer	string	C	Card issuer (if available).

bin

Key	Format	Condition	Description
accountBIN	string	M	The leading six digits of the account number also known as bank identification number (BIN).
accountRangeLow	string	C	The account number at the low end of the account range.
accountRangeHigh	string	C	The account number at the high end of the account range.

Schema

{

    “$schema”: “http://json-schema.org/draft-07/schema#”,

    “$id”: “https://www.computop-paygate.com/schemas/card_response.json”,

    “title”: “card”,

    “description”: “Card Information”,

    “type”: “object”,

    “properties”: {

        “cardholderName”: {

            “type”: “string”,

            “maxLength” : 50,

            “minLength” : 1,

            “description” : “The name of the cardholder as printed on the card.”

        },

        “number”: {

            “type” : “string”,

            “maxLength” : 19,

            “minLength” : 12

        },

        “expiryDate”: {

            “type”: “string”,

            “description”: “YYYYMM”,

            “minLength”: 6,

            “maxLength”: 6

        },

        “bin”: {

            “type”: “object”,

            “properties”: {

                “accountBin”: { “type”: “string” },

                “accountRangeLow”: { “type”: “string” },

                “accountRangeHigh”: { “type”: “string” }

            },

            “additionalProperties”: false,

            “required”: [“accountBin”]

        },

        “brand”: {

            “type”: “string”,

            “enum”: [

                “MasterCard”,

                “VISA”,

                “AMEX”,

                “Diners”,

                “CBN”,

                “JCB”,

                “Dankort”,

                “Maestro”,

                “Cartes Bancaires”,

                “DISCOVER”,

                “Bancontact”,

                “Hipercard”,

                “Elo”,

                “Aura”,

                “Carte 4Etoiles”,

                “AirPlus”,

                “CUP”,

                “NARANJA”,

                “SHOPPING”,

                “CABAL”,

                “ARGENCARD”,

                “CENCOSUD”,

                “KOOKMIN”,

                “KEB”,

                “BC”,

                “SHINHAN”,

                “SAMSUNG”,

                “HYUNDAI”,

                “LOTTE”,

                “1euro”,

                “echequevacances”,

                “cofidis3xcb”,

                “cofidis4xcb”,

                “facilypay-3x”,

                “facilypay-3xsansfrais”,

                “facilypay-4x”,

                “facilypay-4xsansfrais”,

                “RuPay”

            ]

        },

        “product”: {

            “type”: “string”

        },

        “source”: {

            “type”: “string”,

            “enum”: [“DEBIT”, “CREDIT”, “DEFERRED DEBIT”, “PREPAID”, “CHARGE”]

        },

        “type”: {

            “type”: “string”

        },

        “country”: {

            “type”: “object”,

            “properties”: {

                “countryName”: {

                    “type”: “string”,

                    “description”: “Name of the country.”

                },

                “countryA2”: {

                    “type”: “string”,

                    “description”: “ISO-3166 alpha-2 code.”

                },

                “countryA3”: {

                    “type”: “string”,

                    “description”: “ISO 3166-1:2013 alpha-3”

                },

                “countryNumber”: {

                    “type”: “string”,

                    “description”: “ISO-3166 numeric code.”

                }

            },

            “required”: [“countryA3”],

            “additionalProperties”: false

        },

        “issuer”: {

            “type”: “string”

        }

    },

    “required”: [“bin”, “brand”, “country”],

    “additionalProperties”: false

}

Sample

{

    “cardholderName”: “John Doe”,

    “bin”: {

        “accountBin”: “492947”,

        “accountRangeLow”: “492947000000”,

        “accountRangeHigh”: “492948387999”

    },

    “brand”: “VISA”,

    “product”: “Business”,

    “source”: “CREDIT”,

    “type”: “CLASSIC”,

    “country”: {

        “countryName”: “United Kingdom of Great Britain and Northern Ireland”,

        “countryA2”: “GB”,

        “countryA3”: “GBR”,

        “countryNumber”: “826”

    },

    “issuer”: “BARCLAYS BANK PLC”

}