card:request
JSON object
card:request
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 | Condition | Description |
| securityCode | string | O | Card security value. |
| expiryDate | string | M | Card expiry in format YYYYMM. |
| startDate | string | C | Card start in format YYYYMM (only applicable to some UK debit cards). |
| 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. |
| issueNumber | string | C | Issue number of the card (only applicable to some UK debit cards). |
| number | string | M | Card number or card token. |
| brand | string | M | Card network. |
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
}
Sample
{
“securityCode”: “569”,
“expiryDate”: “202208”,
“cardholderName”: “William Thomas”,
“number”: “4186665161011901”,
“brand”: “VISA”
}
