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.
Parameter | Format | Bedingung | Beschreibung |
acsProtocolVersion | string | M | Die zur Authentisierung verwendete Protokoll-Version. Zulässige Werte: · 1.0.2 · 2.1.0 · 2.2.0 · 2.3.0 |
authenticationValue | string | C | Ein zahlungssystemspezifischer Wert als Nachweis der Authentisierung |
cavvAlgorithm | string | C | Nur 3DS 2.0 mit Cartes Bancaires |
eci | string | M | Zahlungssystemspezifischer Electronic-Commerce-Indikator |
threeDSServerTransID | string | C | Nur 3DS 2.0. Vom 3DS-Server vergebene universelle eindeutige Transaktions-Kennung. |
acsXID | string | C | Nur 3DS 1.0. Vom ACS vergebene Transaktions-ID. |
dsTransID | string | C | Nur 3DS 2.0. Vom DS vergebene universelle eindeutige Transaktions-Kennung zur Identifikation einer Einzeltransakation. |
intermediateStatus | string | C | Das 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. |
finalStatus | string | C | Das 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. |
challengeRequestInd | string | C | Specifies 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 |
challengeCancelInd | string | C | Specifies 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 |
dsScore | string | C | Specifies value for “DS Score”, scoring returned by the CB DS |
transStatusReason | string | string | Specifies 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”]
}