card:request | Computop Documents

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

Key

Format

CND

Description

securityCode

string

Card security value

expiryDate

string

Card expiry in format YYYYMM

startDate

string

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

cardholderName

string

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.

issueNumber

string

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

number

string

Card number or card token

brand

string

Card network

Schema

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

1
{
2
    "$schema": "http://json-schema.org/draft-07/schema#",
3
    "$id": "BASEURL/card.json",
4
    "title": "card",
5
    "description": "Card Information",
6
    "type": "object",
7
    "properties": {
8
        "securityCode": {
9
            "type": "string",
10
            "minLength": 3,
11
            "maxLength": 4
12
        },
13
        "expiryDate": {
14
            "type": "string",
15
            "description": "YYYYMM",
16
            "minLength": 6,
17
            "maxLength": 6
18
        },
19
        "startDate": {
20
            "type": "string",
21
            "description": "YYYYMM (only applicable to some UK debit cards)",
22
            "minLength": 6,
23
            "maxLength": 6
24
        },
25
        "cardholderName": {
26
            "type": "string",
27
            "maxLength" : 45,
28
            "minLength" : 2,
29
            "description" : "The name of the cardholder as printed on the card. Alphanumeric special characters, listed in EMV Book 4, “Appendix B”."
30
        },
31
        "issueNumber" : {
32
            "type" : "string",
33
            "maxLength" : 2,
34
            "minLength" : 1,
35
            "description" : "only applicable to some UK debit cards"
36
        },
37
        "number": {
38
            "type" : "string",
39
            "maxLength" : 19,
40
            "minLength" : 12
41
        },
42
        "brand": {
43
            "type": "string",
44
            "enum": [
45
                "MasterCard",
46
                "VISA",
47
                "AMEX",
48
                "Diners",
49
                "CBN",
50
                "JCB",
51
                "Dankort",
52
                "Maestro",
53
                "Cartes Bancaires",
54
                "Discover",
55
                "Bancontact",
56
                "Hipercard",
57
                "Elo",
58
                "Aura",
59
                "Carte 4Etoiles",
60
                "AirPlus",
61
                "CUP",
62
                "NARANJA",
63
                "SHOPPING",
64
                "CABAL",
65
                "ARGENCARD",
66
                "CENCOSUD",
67
                "KOOKMIN",
68
                "KEB",
69
                "BC",
70
                "SHINHAN",
71
                "SAMSUNG",
72
                "HYUNDAI",
73
                "LOTTE",
74
                "1euro",
75
                "echequevacances",
76
                "cofidis3xcb",
77
                "facilypay-3x",
78
                "facilypay-3xsansfrais",
79
                "facilypay-4x",
80
                "facilypay-4xsansfrais",
81
                "RuPay"
82
            ]
83
        }
84
    },
85
    "required": ["expiryDate", "number", "brand"],
86
    "additionalProperties": false
87
}

Sample

1
{ 
2
    "securityCode": "569",
3
    "expiryDate": "202208",
4
    "cardholderName": "William Thomas",
5
    "number": "4186665161011901",
6
    "brand": "VISA"
7
}