Datenelemente
Parameter | Format | Bedingung | Beschreibung | |
---|---|---|---|---|
1 | cardholderName | string | C | Das Vorhandensein hängt von der Händler-Konfiguration ab. Name des Karteninhabers, wie auf der Karte angegeben. |
2 | number | string | C | Das Vorhandensein hängt von der Händler-Konfiguration ab. Falls vorhanden, enthält dieses Element entweder die maskierte Kartennummer oder das Paygate-Kartentoken. |
3 | expiryDate | string | C | Vorhanden, falls number das Paygate-Kartentoken enthält |
4 | bin | object | M | Bankidentifizierungsnummer (BIN) einschließlich untere / obere Grenze, falls vorhanden |
5 | brand | string | M | Name des Kartennetzwerkes (z.B. 'Visa', 'MasterCard') |
6 | product | string | C | Kartenproduktname (falls verfügbar) (z.B. 'Business Premium Debit'). |
7 | source | string | C | Kartenfinanzierungsquelle (falls verfügbar) Zulässige Werte:
|
8 | type | string | C | Der Kartentyp gibt das zur Karte gehörige Programm, Anwendung oder Karten-Level an, falls vorhanden (z.B. Classic, Standard, Gold, Business usw.) |
9 | JSON | M | Land, in dem die Karte ausgestellt ist | |
10 | issuer | string | C | Kartenaussteller (falls verfügbar) |
bin
Parameter | Format | Bedingung | Beschreibung | |
---|---|---|---|---|
1 | accountBIN | string | M | Die ersten sechs Ziffern der Kartennummer, die auch als Bankidentifizierungsnummer bekannt sind (BIN). Die BIN umfasst zwischen 6 und 8 Ziffern - aus Gründen der PCI DSS Regeln dürfen maximal die ersten 6 Ziffern ausgegeben werden. |
2 | accountRangeLow | string | C | Die untere Grenze der Bankidentifizierungsnummer |
3 | accountRangeHigh | string | C | Die obere Grenze der Bankidentifizierungsnummer |
Schema
{ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://www.computop-paygate.com/schemas/card_response.json", "title": "card", "description": "Karteninformationen", "type": "object", "properties": { "cardholderName": { "type": "string", "maxLength" : 45, "minLength" : 2, "description" : "Name des Karteninhabers, wie auf der Karte angegeben. Alphanumerische Sonderzeichen gemäß EMV Book 4, “Appendix B”." }, "number": { "type" : "string", "maxLength" : 19, "minLength" : 12 }, "expiryDate": { "type": "string", "description": "JJJJMM", "minLength": 6, "maxLength": 6 }, "bin": { "type": "object", "properties": { "accountBin": { "type": "string" }, "accountRangeLow": { "type": "string" }, "accountRangeHigh": { "type": "string" } }, "additionalProperties": false, "required": ["accountBin"] }, "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", "cofidis4xcb", "facilypay-3x", "facilypay-3xsansfrais", "facilypay-4x", "facilypay-4xsansfrais", "RuPay" ] }, "product": { "type": "string" }, "source": { "type": "string", "enum": ["DEBIT", "CREDIT", "DEFERRED DEBIT", "PREPAID", "CHARGE"] }, "type": { "type": "string" }, "country": { "type": "object", "properties": { "countryName": { "type": "string", "description": "Name of the country." }, "countryA2": { "type": "string", "description": "ISO-3166 alpha-2 code." }, "countryA3": { "type": "string", "description": "ISO 3166-1:2013 alpha-3" }, "countryNumber": { "type": "string", "description": "ISO-3166 numeric code." } }, "required": ["countryA3"], "additionalProperties": false }, "issuer": { "type": "string" } }, "required": ["bin", "brand", "country"], "additionalProperties": false }
Beispiel
{ "cardholderName": "John Doe", "bin": { "accountBin": "492947", "accountRangeLow": "492947000000", "accountRangeHigh": "492948387999" }, "brand": "VISA", "product": "Business", "source": "CREDIT", "type": "CLASSIC", "country": { "countryName": "United Kingdom of Great Britain and Northern Ireland", "countryA2": "GB", "countryA3": "GBR", "countryNumber": "826" }, "issuer": "BARCLAYS BANK PLC" }