card:request | Computop Documents

Beachten Sie bitte, dass die Daten innerhalb aller JSON-Objekte per UTF-8 kodiert werden und danach zusätzlich mit Base64-codiert sein müssen. Das betrifft insbesondere Sonderzeichen wie z.B. Umlaute.

Datenelemente

Key

Format

CND

Beschreibung

securityCode

string

Kartenprüfnummer

expiryDate

string

Kartenverfallsdarum im Format JJJJMM

startDate

string

Kartenanfangsdatum im Format JJJJMM (nur für einige Debitkarten in GB zutreffend)

cardholderName

string

Name des Karteninhabers, wie auf der Karte angegeben.

Hinweis: Alphanumerische Sonderzeichen gemäß EMV Book 4, „Anhang B“. Sonderzeichen wurden mit EMV 3DS Version 2.3 hinzugefügt, aber nicht alle Teilnehmer (Banken) unterstützen diesen Standard bereits.

issueNumber

string

Ausgabenummer der Karte (nur für einige Debitkarten in GB zutreffend)

number

string

Kartennummer oder Karten-Token

brand

string

Kartennetzwerk

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
}

Beispiel

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