Start Technische Dokumentation Services im 1cs OBS EMV 3D-Secure JSON resultResponse

JSON Objekt

resultResponse

Alle JSON Objekte

resultResponse

Beachten Sie bitte, dass alle nachstehenden Datenelemente in resultsResponse vorhanden sind, aber je nach Bedingung einen Leerstring enthalten können.

ParameterFormatBedingungBeschreibung
threeDSServerTransIDstringM1cs Online Bezahlsystem PayID im kanonischen Format gemäß IETF RFC 4122.
acsTransIDstringMVom ACS vergebene universelle, eindeutige Transaktions-ID zur Identifikation einer Einzeltransaktion
acsRenderingTypeobjectCErforderlich, sofern nicht ACS Entkoppelte Bestätigung = true
authenticationTypestringCErforderlich, wenn der Transaktionsstatus = Y oder N ist. Gibt die Art der Authentisierungsmethode an, die der Issuer als Challenge für den Karteninhaber verwenden will. Erforderlich, wenn der Transaktionsstatus = C oder D ist. Zulässige Werte: · 01 = static · 02 = dynamic · 03 = oob Zukünftige Implementierung. Ab Protokollversion 2.2.0 aufwärts – · 04 = decoupled
authenticationValuestringCErfoderlich, wenn Transaktionsstatus = Y oder A
challengeCancelstringCIndikator, der darüber informiert, dass die Authentisierung abgebrochen wurde. Zulässige Werte: · 01 = Karteninhaber wählte “Abbrechen” · 02 = Reserviert für zukünftige EMVCo Verwendung (Werte ungültig, solange sie nicht durch EMVCo definiert sind) · 03 = Zeitüberschreitung der Transaktion — Entkoppelte Authentisierung · 04 = Zeitüberschreitung der Transaktion am ACS — andere Zeitüberschreitungen · 05 = Zeitüberschreitung der Transaktion am ACS — Erste CReq vom ACS nicht empfangen · 06 = Transaktionsfehler · 07 = Unbekannt · 08 = Zeitüberschreitung der Transaktion am SDK
dsTransIDstringMVom DS vergebene universelle, eindeutige Transaktions-ID zur Identifikation einer Einzeltransaktion
ecistringCVom ACS oder DS bereitgestellter zahlungssystemspezifischer Wert, der das Ergebnis des Versuchs zur Authentisierung des Karteninhabers angibt. Die Anforderungen für das Vorhandensein dieses Felds sind DS-spezifisch.
interactionCounterstringMGibt die Anzahl der durch den Karteninhaber versuchten Authentisierungs-Zyklen an
messageCategorystringMIdentifiziert die Kategorie der Nachricht für einen bestimmten Anwendungsfall. Zulässige Werte: · 01 = PA · 02 = NPA
messageExtensionstringCNötige Daten zur Unterstützung von Anforderungen, die nicht anderweitig in der 3-D Secure Nachricht definiert sind, werden in einer Nachrichten-Erweiterung transportiert. Bedingungen sind von jedem DS festzulegen.
messageTypestringCIdentifiziert die Art der gescheiterten Nachricht im Fehlerfall. Zulässige Werte: · ARes · RReq
messageVersionstringMKennung für die Protokollversion
sdkTransIDstringMZukünftige Verwendung. Vom 3DS SDK vergebene universelle, eideutige Transaktion-ID zur Ifentifikation einer Einzeltransaktion.
transStatusstringMGibt an, ob sich eine Transaktion als eine authentisierte Transaktion qualifiziert. Zulässige Werte: · Y = Authentisierungs-Überprüfung erfolreich · N = Nicht authentisiert /Konto nicht verifiziert; Transaktion abgelehnt · U = Authentisierung/ Kontoverifizierung konnte nicht ausgeführt werden; technisches oder anderes Problem, wie in ARes oder RReq angegeben · A = Verarbeitung der Versuche ausgeführt; Nicht authentisiert/verifiziert, aber Nachweis der versuchten Authentisierung/Verfizierung ist bereitgestellt · C = Challenge erfoderlich; zusätzliche Authentisierung mittels CReq/CRes ist erforderlich · D = Challenge erfoderlich; entkoppelte Authentisierung bestätigt · R = Authentisierung/ Kontoverifizierung abgelehnt; Issuer lehnt Authentisierung/Verifizierung ab und fordert, dass keine Autorisierung versucht wird · I = Nur zur Information; 3DS Requestor Challenge-Präferenz anerkannt
transStatusReasonstringCGibt Informationen darüber, warum das Feld Transaktionsstatus den angegebenen Wert hat. Erforderlich, wenn das Feld Transaktionsstatus = N, U oder R ist. Zulässige Werte: · 01 = Kartenauthentisierung gescheitert · 02 = Unbekanntes Gerät · 03 = Nicht unterstütztes Gerät · 04 = Überschreitet das Limit für die Authentisierungshäufigkeit · 05 = Abgelaufene Karte · 06 = Ungülstige Kartennummer · 07 = Ungültige Transaktion · 08 = Kein Kartendatensatz · 09 = Sicherheitsfehler · 10 = Gestohlene Karte · 11 = Betrugsverdacht · 12 = Transaktion für den Karteninhaber nicht erlaubt · 13 = Karteninhaber nicht für den Service angemeldet · 14 = Zeitüberschreiung der Transaktion am ACS · 15 = Geringes Vertrauen · 16 = Mittleres Vertrauen · 17 = Hohes Vertrauen · 18 = Sehr hohes Vertrauen · 19 = Überschreitet das ACS Maximum der Challenges · 20 = Nicht zahlungswirksame Transaktion nicht unterstützt · 21 = 3RI-Transaktion nicht unterstützt · 22 = ACS technisches Problem · 23 = Entkoppelte Authentisierung vom ACS gefordert, aber vom 3DS Requestor nicht angefragt · 24 = 3DS Requestor maximale Ablaufzeit bei Entkopplung überschritten · 25 = Entkoppelte Authentisierung hatte unzureichend Zeit für die Authentisierung des Karteninhabers. ACS macht keinen Versuch · 26 = Authentisierung versucht, aber vom Karteninhaber nicht ausgeführt
whiteListStatusstringCZukünftige Verwendeng. Erst ab Protokollversion 2.2.0 aufwärts unterstützt. Ermöglicht die Übermittlung von Statuswerten Vertrauenswürdige Empfänger/Whitelist. Zulässige Werte: · Y = 3DS Requestor steht beim Karteninhaber auf der Whitelist · N = 3DS Requestor steht beim Karteninhaber nicht auf der Whitelist · E = Nach Festlegung vom Issuer nicht wählbar · P = Ausstehende Bestätigung vom Karteninhaber · R = Karteninhaber abgelehnt · U = Whitelist-Status unbekannt, nicht verfügbar oder nicht zutreffend
whiteListStatusSourcestringCZukünftige Verwendeng. Erst ab Protokollversion 2.2.0 aufwärts unterstützt. Dieses Datenelement wird von dem System ausgefüllt, dass den Whitelist-Status setzt. Zulässige Werte: · 01 = 3DS Server · 02 = DS · 03 = ACS
dsScorestringOScoring-Ergebnis des Directory Server (Scheme) der Transaktion während der Authentifizierung. Format und Wert sind DS-spezifisch.
challengeRequestIndstringOGibt die Präferenz des Händlers für die Challenge für diese Transaktion während der 3DS-Authentisierung zurück. Zulässige Werte gemäß den neuesten EMVCo 3D-Secure-Spezifikationen: 2-stelliger Wert, 01-99 01 = Keine Präferenz 02 = Keine Herausforderung angefordert 03 = Herausforderung angefordert (3DS-Anfragesteller-Präferenz) 04 = Herausforderung angefordert (Mandat) 05 = Keine Herausforderung angefordert (transaktionale Risikoanalyse wurde bereits durchgeführt) 06 = Keine Herausforderung angefordert (nur Datenfreigabe) 07 = Keine Herausforderung angefordert (starke Verbraucherauthentifizierung wurde bereits durchgeführt) 08 = Keine Herausforderung angefordert (verwenden Sie die Ausnahme von der weißen Liste, wenn keine Herausforderung erforderlich ist) 09 = Herausforderung angefordert (Aufforderung zur Whitelist angefordert, wenn Herausforderung erforderlich) 10–79 = Reserviert für die zukünftige Verwendung von EMVCo (Werte ungültig, bis EMVCo definiert) 80–99 = Reserviert für DS-Nutzung
cardholderInfostringOText, der dem Karteninhaber während einer reibungslosen oder entkoppelten Transaktion vom ACS/Aussteller bereitgestellt wird. Der Issuer kann dem Karteninhaber so Informationen zur Verfügung stellen. Beispiel: „Für diese Transaktion ist eine zusätzliche Authentifizierung erforderlich, bitte kontaktieren Sie (Name des Ausstellers) unter xxx-xxx-xxxx.“ oder auch “Ihre Karte ist nicht für 3-D Secure registriert. Bitte registrieren Sie Ihre Karte über das Registrierungsportal Ihrer Bank.”

Schema

{

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

        “$id”: “https://www.computop-paygate.com/schemas/resultsResponse.json”,

    “type”: “object”,

    “properties”: {

               “threeDSServerTransID”: {

                       “type”: “string”,

            “maxLength”: 36

        },

               “acsTransID”: {

                       “type”: “string”,

                       “maxLength”: 36

               },

               “acsRenderingType”: {

            “type”: “object”,

            “properties”: {

                “acsInterface”: {

                    “type”: “string”,

                    “enum”: [“native”, “html”, “”],

                                      “description”: “Die ACS-Schnittstelle, die dem Karteninhaber die Challenge zeigen wird.”

                },

                “acsUiTemplate”: {

                    “type”: “string”,

                    “enum”: [“text”, “singleSelect”, “multiSelect”, “oob”, “other”,””],

                                      “description”: “Bestimmt das Format der UI-Vorlage, die der ACS dem Kunden zuerst zeigt.”

                }

            },

            “required”: [“acsInterface”, “acsUiTemplate”],

            “additionalProperties”: false

        },

               “authenticationType”: {

            “type”: “string”,

            “enum”: [“01”, “02”, “03”, “04”, “”]

        },

        “authenticationValue”: {

            “type”: “string”,

            “maxLength”: 28

        },

               “challengeCancel”: {

                       “type”: “string”,

                       “enum”: [“01”, “02”, “03”, “04”, “05”, “06”, “07”, “08”, “”]

               },

               “dsTransID”: {

                       “type”: “string”,

                       “maxLength”: 36

               },

        “eci”: {

            “type”: “string”,

            “maxLength”: 2

        },

               “interactionCounter”: {

                       “type”: “string”,

                       “maxLength”: 2

               },

               “messageCategory”: {

                       “type”: “string”,

                       “enum”: [“01”, “02”]

               },

               “messageExtension”: {

                       “type”: “string”,

                       “maxLength”: 81920

               },

               “messageVersion”: {

                       “type”: “string”,

                       “minLength”: 5,

                       “maxLength”: 8

               },

        “sdkTransID”: {

            “type”: “string”,

            “maxLength”: 36

        },

        “transStatus”: {

            “type”: “string”,

            “enum”: [“Y”, “N”, “U”, “A”, “C”, “D”, “R”, “I”, “”]

        },

        “transStatusReason”: {

            “type”: “string”,

            “enum”: [“01”, “02”, “03”, “04”, “05”, “06”, “07”, “08”, “09”, “10”, “11”, “12”, “13”, “14”, “15”, “16”, “17”, “18”, “19”, “20”, “21”, “22”, “23”, “24”, “25”, “26”, “”]

        }

        },

        “required”: [“threeDSServerTransID”, “acsTransID”, “acsRenderingType”, “authenticationType”, “authenticationValue”, “challengeCancel”, “dsTransID”, “eci”, “interactionCounter”, “messageCategory”, “messageExtension”, “messageVersion”, “sdkTransID”, “transStatus”, “transStatusReason”],

        “additionalProperties”: false

}

Beispiel

{

        “threeDSServerTransID”:”9e944d5d-56f3-461d-a393-80a666d346d1″,

        “acsTransID”:”1e43b52f-3623-4e5d-8917-41c5c15b7218″,

        “acsRenderingType”:{

               “acsInterface”:”01″,

               “acsUiTemplate”:”01″

        },

        “authenticationType”:”02″,

        “authenticationValue”:”JAmi21makAifmwqo2120cjq1AAA=”,

        “challengeCancel”:””,

        “dsTransID”:”c626e8a0-f2ba-42b3-aa6d-620658421f3a”,

        “eci”:”05″,

        “interactionCounter”:”01″,

        “messageCategory”:”01″,

        “messageExtension”:””,

        “messageVersion”:”2.1.0″,

        “sdkTransID”:””,

        “transStatus”:”Y”,

        “transStatusReason”:””

}