Please note that the data within all JSON objects is encoded using UTF-8 and then must be also Base64 encoded. This applies in particular to special characters such as "Umlaute" and diactrics.

Data Elements



KeyFormatCNDDescription
1

securityCode

string

O

Card security value

2

expiryDate

string

M

Card expiry in format YYYYMM

3

startDate

string

C

Card start in format YYYYMM (only applicable to some UK debit cards)

4

cardholderName

string

M

Name of the cardholder as printed on the card.

Notice: Alphanumeric special characters, listed in EMV Book 4, “Appendix B”. Special characters have been added with EMV 3DS Version 2.3, but not all participants (banks) already support that standard.

5

issueNumber

string

C

Issue number of the card (only applicable to some UK debit cards)

6

number

string

M

Card number or card token

7

brand

string

M

Card network


Schema

(info) BASEURL= https://www.computop-paygate.com/schemas

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "$id": "BASEURL/card.json",
    "title": "card",
    "description": "Card Information",
    "type": "object",
    "properties": {
        "securityCode": {
            "type": "string",
            "minLength": 3,
            "maxLength": 4
        },
        "expiryDate": {
            "type": "string",
            "description": "YYYYMM",
            "minLength": 6,
            "maxLength": 6
        },
        "startDate": {
            "type": "string",
            "description": "YYYYMM (only applicable to some UK debit cards)",
            "minLength": 6,
            "maxLength": 6
        },
        "cardholderName": {
            "type": "string",
            "maxLength" : 45,
            "minLength" : 2,
            "description" : "The name of the cardholder as printed on the card. Alphanumeric special characters, listed in EMV Book 4, “Appendix B”."
        },
        "issueNumber" : {
            "type" : "string",
            "maxLength" : 2,
            "minLength" : 1,
            "description" : "only applicable to some UK debit cards"
        },
        "number": {
            "type" : "string",
            "maxLength" : 19,
            "minLength" : 12
        },
        "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",
                "facilypay-3x",
                "facilypay-3xsansfrais",
                "facilypay-4x",
                "facilypay-4xsansfrais",
                "RuPay"
            ]
        }
    },
    "required": ["expiryDate", "number", "brand"],
    "additionalProperties": false
}

Sample

{ 
    "securityCode": "569",
    "expiryDate": "202208",
    "cardholderName": "William Thomas",
    "number": "4186665161011901",
    "brand": "VISA"
}