card:response

JSON Objekt

card:response

ParameterFormatBedingungBeschreibung
cardholderNamestringCDas Vorhandensein hängt von der Händler-Konfiguration ab. Name des Karteninhabers, wie auf der Karte angegeben.  Bitte wenden Sie sich an den 1cs Support, wenn Sie dieses Datenelement in der Antwort benötigen.
numberstringCDas Vorhandensein hängt von der Händler-Konfiguration ab. Falls vorhanden, enthält dieses Element entweder die maskierte Kartennummer oder das 1cs Online Bezahlsystem-Kartentoken. Bitte wenden Sie sich an den 1cs Support, wenn Sie dieses Datenelement in der Antwort benötigen.
expiryDatestringCVorhanden, falls number das 1cs Online Bezahlsystem-Kartentoken enthält
binobjectMBankidentifizierungsnummer (BIN) einschließlich untere / obere Grenze, falls vorhanden
brandstringMName des Kartennetzwerkes (z.B. ‚Visa‘, ‚MasterCard‘)
productstringCKartenproduktname (falls verfügbar) (z.B. ‚Business Premium Debit‘).
sourcestringCKartenfinanzierungsquelle (falls verfügbar) Zulässige Werte: · DEBIT · CREDIT · DEFERRED DEBIT · PREPAID · CHARGE
typestringCDer Kartentyp gibt das zur Karte gehörige Programm, Anwendung oder Karten-Level an, falls vorhanden (z.B. Classic, Standard, Gold, Business usw.)
countryJSONMLand, in dem die Karte ausgestellt ist
issuerstringCKartenaussteller (falls verfügbar)
Parameter card:response

bin

ParameterFormatBedingungBeschreibung
accountBINstringMDie 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.
accountRangeLowstringCDie untere Grenze der Bankidentifizierungsnummer
accountRangeHighstringCDie obere Grenze der Bankidentifizierungsnummer


Parameter card:response bin

Schema

{

    "$schema""http://json-schema.org/draft-07/schema#",

    "$id""BASEURL/card_response.json",

    "title""card",

    "description""Card Information",

    "type""object",

    "properties": {

        "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”."

        },

        "number": {

            "type" "string",

            "maxLength" 19,

            "minLength" 12

        },

        "expiryDate": {

            "type""string",

            "description""YYYYMM",

            "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",

                "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“

}

Kontakt

Wir sind täglich von 8:00 – 18:00 Uhr persönlich für Dich erreichbar.

+49 (0)7805 91696-0
service@1cs.de
Jetzt Anfrage senden