card:request
JSON Objekt
card:request
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.
| Parameter | Format | Bedingung | Beschreibung |
| securityCode | string | O | Kartenprüfnummer |
| expiryDate | string | M | Kartenverfallsdarum im Format JJJJMM. |
| startDate | string | C | Kartenanfangsdatum im Format JJJJMM (nur für einige Debitkarten in GB zutreffend) |
| cardholderName | string | M | 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 | C | Ausgabenummer der Karte (nur für einige Debitkarten in GB zutreffend) |
| number | string | M | Kartennummer oder Karten-Token |
| brand | string | M | Kartennetzwerk |
Schema
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
}
Beispiel
{
„securityCode“: „569“,
„expiryDate“: „202208“,
„cardholderName“: „William Thomas“,
„number“: „4186665161011901“,
„brand“: „VISA“
}
