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

Data Elements

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...


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= https://vr-epayment-gateway.de/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"]	
}