JSON Objekt

threeDSData:request

threeDSData:request

Falls Sie einen eigenen oder irgendeinen anderen externen 3DS-Server verwenden, müssen Sie das Objekt threeDSData für die Autorisierung mit dem Acquirer an das 1cs Online Bezahlsystem senden. Dieses Datenelement betrifft daher nur Server-zu-Server-Integrationen.

Bitte informieren Sie unseren Helpdesk, falls Sie diese Funktion nutzen möchten, da eine spezielle Konfiguration (‘Use external MPI’) Ihrer MerchantID notwendig ist.

ParameterFormatBedingungBeschreibung
acsProtocolVersionstringMDie zur Authentisierung verwendete Protokoll-Version. Zulässige Werte: · 1.0.2 · 2.1.0 · 2.2.0 · 2.3.0
authenticationValuestringCEin zahlungssystemspezifischer Wert als Nachweis der Authentisierung
cavvAlgorithmstringCNur 3DS 2.0 mit Cartes Bancaires
ecistringMZahlungssystemspezifischer Electronic-Commerce-Indikator
threeDSServerTransIDstringCNur 3DS 2.0. Vom 3DS-Server vergebene universelle eindeutige Transaktions-Kennung.
acsXIDstringCNur 3DS 1.0. Vom ACS vergebene Transaktions-ID.
dsTransIDstringCNur 3DS 2.0. Vom DS vergebene universelle eindeutige Transaktions-Kennung zur Identifikation einer Einzeltransakation.
intermediateStatusstringCDas ist der Transaktionsstatus transStatus aus der Authentisierungs-Antwort (ARes). Zulässige Werte: · Y = Verfifizierung der Authentisierung erfolgreich · N = Nicht authentisiert /Konto nicht verifiziert; Transaktion abgelehnt. · U = Authentisierung/ Kontoüberprüfung konnte nicht ausgeführt werden; technisches oder sonstiges Problem, wie in ARes oder RReq angegeben. · A = Verarbeitung der Versuche ausgeführt; nicht authentisiert/verifiziert, aber ein Nachweise der versuchten Authentifizierung/Verifizierung ist bereitgestellt. · C = Challenge erforderlich; zusätzliche Authentisierung mittels CReq/CRes ist erforderlich. · D = Challenge erforderlich; Entkoppelte Authenrisierung bestätigt. · I = Nur zur Information; bevorzugte Challgenge des 3DS Requestor bestätigt.
finalStatusstringCDas ist der Transaktionsstatus transStatus aus dem Result Request (RReq). Zulässige Werte: · Y = Verifizierung der Authentisierung erfolgreich · U = Authentisierung/ Kontoüberprüfung konnte nicht ausgeführt werden; technisches oder sonstiges Problem, wie in ARes oder RReq angegeben. · A = Verarbeitung der Versuche ausgeführt; nicht authentisiert/verifiziert, aber ein Nachweise der versuchten Authentifizierung/Verifizierung ist bereitgestellt.
challengeRequestIndstringCSpecifies value for “3DS Requestor Challenge Indicator” Values accepted: 01 = No preference – default value if the data element is absent or not set to a value 02 = No authentication 03 = Authentication requested 04 = Authentication required 05 = No authentication: transaction risk analysis already performed 06 = No authentication: data share only 07 = No authentication: SCA already performed 08 = No authentication: whitelist 09 = Authentication required
challengeCancelIndstringCSpecifies value for “Challenge Cancellation Indicator” Values accepted: 01 = Cardholder selected “Cancel” 02 = 3DS Requestor cancelled Authentication. 03 = Transaction Abandoned 04 = Transaction Timed Out at ACS— other timeouts 05 = Transaction Timed Out at ACS— First CReq not received by ACS 06 = Transaction Error 07 = Unknown
dsScorestringCSpecifies value for “DS Score”, scoring returned by the CB DS
transStatusReasonstringstringSpecifies value for “Transaction Status Reason Code” Values accepted: transStatusReason Codes

Schema

{

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

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

        “title”: “External 3DS Data”,

        “description”: “Externe 3DS-Daten”,

        “type”: “object”,

        “properties”: {

               “acsProtocolVersion”: {

                       “type”: “string”,

                       “enum”: [“1.0.2”, “2.1.0”, “2.2.0”, “2.3.0”]

               },

               “authenticationValue”: {

            “type”: “string”,

            “maxLength”: 28

        },

               “eci”: {

                       “type”: “string”,

                       “minLength”: 2,

                       “maxLength”: 2

               },

               “threeDSServerTransID”: {

                       “type”: “string”,

            “maxLength”: 36

        },

               “acsXID”: {

                       “type”: “string”,

                       “maxLength”: 40

               },

               “dsTransID”: {

                       “type”: “string”,

                       “maxLength”: 36

               },

               “intermediateStatus”: {

                       “type”: “string”,

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

               },

               “finalStatus”: {

                       “type”: “string”,

                       “enum”:  [“Y”, “U”, “A”]

               }

        },

        “additionalProperties”: false,

        “required”: [“acsProtocolVersion”, “eci”, “intermediateStatus”, “finalStatus”]       

}