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

  • Beschreibung


    Key
    Format
    CND
    Description
    Beschreibung
    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.

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