Start Technische Dokumentation Services im 1cs OBS EMV 3D-Secure JSON threeDSData:request

threeDSData:request

JSON Objekt

Alle JSON Objekte

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
Parameter threeDSData:request

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

}