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