In case you use your own or any other external 3DS Server you must submit the threeDSData object to  for authorization with the acquirer. This data element is thus only aplicable to server-to-server integrations.

Data Elements


KeyFormatCNDDescriptionBeschreibung
1

acsProtocolVersion

string

M

The protocol version used for authentication.

Values accepted:

  • 1.0.2

  • 2.1.0

  • 2.2.0

  • 2.3.0

Die zur Authentisierung verwendete Protokoll-Version.

Zulässige Werte:

  • 1.0.2

  • 2.1.0

  • 2.2.0

  • 2.3.0

2

authenticationValue

string

C

Payment system specific value to provide proof of authentication

Ein zahlungssystemspezifischer Wert als Nachweis der Authentisierung
3

eci

string

M

Payment system specific Electronic Commerce Indicator

Zahlungssystemspezifischer Electronic-Commerce-Indikator
4

threeDSServerTransID

string

C

3DS 2.0 only. Universally unique transaction identifier assigned by the 3DS Server.

Nur 3DS 2.0. Vom 3DS-Server vergebene universelle eindeutige Transaktions-Kennung.
5

acsXID

string

C

3DS 1.0 only. ACS assigned transaction ID.

Nur 3DS 1.0. Vom ACS vergebene Transaktions-ID.
6

dsTransID

string

C

3DS 2.0 only. Universally unique transaction identifier assigned by the DS to identify a single transaction.

Nur 3DS 2.0. Vom DS vergebene universelle eindeutige Transaktions-Kennung zur Identifikation einer Einzeltransakation.
7

intermediateStatus

string

C

This is the transaction status transStatus from the Authentication Response (ARes).

Values accepted:

  • Y = Authentication Verification Successful.
  • N = Not Authenticated /Account Not Verified; Transaction denied.
  • U = Authentication/ Account Verification Could Not Be Performed; Technical or other problem, as indicated in ARes or RReq.
  • A = Attempts Processing Performed; Not Authenticated/Verified, but a proof of attempted authentication/verification is provided.
  • C = Challenge Required; Additional authentication is required using the CReq/CRes.
  • D = Challenge Required; Decoupled Authentication confirmed.
  • I = Informational Only; 3DS Requestor challenge preference acknowledged.

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.

8

finalStatus

string

C

This is the transaction status transStatus from the Result Request (RReq).

Values accepted:

  • Y = Authentication Verification Successful.
  • U = Authentication / Account Verification Could Not Be Performed; Technical or other problem, as indicated in ARes or RReq.
  • A = Attempts Processing Performed; Not Authenticated/Verified, but a proof of attempted authentication/verification is provided.

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.

Schema

(info) BASEURL= schemas

{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"$id": "BASEURL/threeDSDataReq.json",
	"title": "External 3DS Data",
	"description": "External 3DS Data",
	"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", "I"]
		},
		"finalStatus": {
			"type": "string",
			"enum":  ["Y", "U", "A"]
		}
	},
	"additionalProperties": false,
	"required": ["acsProtocolVersion", "eci"]	
}