Data Elements

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1638290162208_-1761219857
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	versioning_data

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1638290162212_2145445531
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key

Format

CND

Description

Beschreibung

1

threeDSServerTransID

string

M

Unique transaction identifier generated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

and passed to the 3DS Server

Von

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

vergebene und an den 3DS-Server übermittelte eindeutige TransaktionsID

2

acsStartProtocolVersion

string

M

The earliest (i.e. oldest) active protocol version that is supported by the ACS, retrieved from the card range data repository

Die früheste (d.h. älteste) aktive Protokollversion, die vom ACS unterstützt wird, aus dem Kartenbereich-Datenbestand ermittelt

3

acsEndProtocolVersion

string

M

The most recent active protocol version that is supported for the ACS URL, retrieved from the card range data repository

Die aktuellste aktive Protokollversion, die für die ACS URL unterstützt wird, aus dem Kartenbereich-Datenbestand ermittelt

4

dsStartProtocolVersion

string

M

The earliest (i.e. oldest) active protocol version that is supported by the DS, retrieved from the card range data repository, or optionally from the Directory Server repository in case this info is not present for the particular card range.

Die früheste (d.h. älteste) aktive Protokollversion, die vom DS unterstützt wird, aus dem Kartenbereich-Datenbestand ermittelt oder optional aus dem Datenbestand des Directory Server, falls diese Information für den bestimmten Kartenbereich nicht vorhanden ist.

5

dsEndProtocolVersion

string

M

The most recent active protocol version that is supported for the DS, retrieved from the card range data repository, or optionally from the Directory Server repository in case this info is not present for the particular card range.

Die aktuellste aktive Protokollversion, die vom DS unterstützt wird, aus dem Kartenbereich-Datenbestand ermittelt oder optional aus dem Datenbestand des Directory Server, falls diese Information für den bestimmten Kartenbereich nicht vorhanden ist.

6

threeDSMethodURL

string

M

The ACS URL that will be used by the 3DS Method. The 3DSMethodURL data element may be null if not supported by the ACS for this specific card range.

Die ACS URL, die von der 3DS Methode verwendet wird. Das Datenelement 3DSMethodURL kann Null sein, falls es von ACS für diesen bestimmten Kartenbereich nicht unterstützt wird.

7

threeDSMethodDataForm

string

M

Value containing the 3DS Method Data to be sent to ACS in the 3DS Method HTTP form POST. In case 3DS Method URL is not stored in the card range data repository for the particular card range, this field will be null. The 3DS Method Data contain a Base64 encoded JSON object of the 3DS Server Transaction ID and the 3DS Method Notification URL.

Wert, der die Daten der 3DS Methode enthält, die im 3DS Method HTTP form POST zum ACS gesendet werden. Falls die URL der 3DS Methode nicht im Kartenbereich-Datenbestand für den bestimmten Kartenbereich gespeichert ist, wird dieses Feld Null. Die Daten der 3DS Methode enthalten ein Base64-codiertes JSON-Objekt der 3DS Server Transaction ID sowie die3DS Method Notification URL.

8

threeDSMethodData

object

M

Object containing the data elements to be posted to the 3DS Method URL

Objekt, das die Datenelemente enthält, die an die 3DS Method URL zu senden sind

9

errorDetails

object

C

Object provided by the 3DS Server in case an error occured in response to a versioning request (e.g. Invalid cardholder account number passed, not available card range data, not available 3DS Method URL for cardholder account number, failure in encoding/serialization of the 3DS Method data).

Vom 3DS Server bereitgestelltes Objekt, falls bei der Antwort auf eine Versionierungsanfrage ein Fehler aufgetreten ist (z.B. ungültige Kontonummer des Karteninhabers übermittelt, Kartenbereichsdaten nicht verfügbar, 3DS Method URL für Kontonummer des Karteninhabers nicht verfügbar, Fehler bei der Codierung/Serialisierung der Daten der 3DS Methode).

Anchor
threeDSMethodData
threeDSMethodData
threeDSMethodData

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1638290162214_-1172004365
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	threeds_methoddata

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1638290162216_-1413531879
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key

Format

CND

Description

Beschreibung

1

threeDSMethodNotificationURL

string

M

The URL that will receive the notification of 3DS Method completion from the ACS. This is sent in the initial request to the ACS from the 3DS Requestor executing the 3DS Method.

URL, welche die Benachrichtigung über den Abschluss der 3DS Methode vom ACS empfängt. Diese wird in der anfänglichen Anfrage zum ACS vom 3DS Requestor übermittelt, der die 3DS Methode ausführt.

2

threeDSServerTransID

string

M

Unique transaction identifier generated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

and passed to the 3DS Server.

Von

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

vergebene und an den 3DS-Server übermittelte eindeutige TransaktionsID

Anchor
errorDetails
errorDetails
errorDetails

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1638290162218_-2013647797
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	errordetails

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1638290162219_1266387027
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key Format CND Description Beschreibung

1

threeDSServerTransID

string

M

Unique transaction identifier generated by

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

and passed to the 3DS Server

Von

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

vergebene und an den 3DS-Server übermittelte eindeutige TransaktionsID

2

errorCode

string

M

Code indicating the type of problem identified in the message

Code, der die Art des in der Nachricht angegebenen Problems anzeigt

3

errorComponent

string

M

Code indicating the 3-D Secure component that identified the error.

Values accepted:

C = 3DS SDK
S = 3DS Server
D = Directory Server
A = Access Control Server

Code, der die 3-D Secure Komponente angibt, welche den Fehler identifiziert hat.

Zulässige Werte:

C = 3DS SDK
S = 3DS Server
D = Directory Server
A = Access Control Server

4

errorDescription

string

M

Error description

Fehlerbeschreibung

errorCode

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1638290162220_-1864845535
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	errorcode

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1638290162222_4984152
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Code	Description	Beschreibung
101	Message received invalid	Empfange Nachricht ungültig
102	Message version number not supported	Versionsnummer der Nachricht nicht unterstützt
103	Sent messages limit exceeded. Only used for PReq.	Limit für gesendete nachrichtet überschritten. Nur für PReq verwendet.
201	Required element missing	Erforderliches Element fehlt
202	Critical message extension not recognized	Kritische Nachrichtenerweiterung nicht erkannt
203	Format on one or more elements is invalid according to the specs	Format bei einem oder mehreren Elementen ungültig gemäß Spezifikationen
204	Duplicate data element	Doppeltes Datenelement
301	Transaction id is not recognized	Transaktions-ID nicht erkannt
302	Data decryption failure	Fehler der Datenentschlüsselung
303	Access denied, invalid endpoint	Zugriff abgelehnt, ungültiger Endpunkt
304	ISO code is not valid	ISO-Code ungültig
305	Transaction data is not valid	Transaktionsdaten ungültig
306	Merchant category code is not valid for payment system	Händler-Kategoriecode ist für das Zahlungssystem nicht gültig
307	Serial number is not valid	Seriennummer ungültig
402	Transaction timed out	Zeitüberschreitung der Transaktion
403	Transient system failure	Vorübergehender Systemfehler
404	Permanent system failure	Permanenter Systemfehler
405	System connection failure	Systemverbindungsfehler
911	UnionPay specific error code. Present when Data fields relevance check failed (ECI value and AV appearance are inconsistent with transaction status).	Spezifischer Fehlercode von UnionPay. Vorhanden, wenn Datenfelder-Relevanzprüfung scheitert (ECI-Wert und AV-Erscheinungsbild sind inkonsistent zum Transaktionsstatus).
912	UnionPay specific error code. Present when duplicated transaction ID (Transaction ID should be unique for each AReq request).	Spezifischer Fehlercode von UnionPay. Vorhanden bei doppelter Transaktions-ID (Die Transaktions-ID sollte für jede AReq-Anfrage eindeutig sein).

Schema

BASEURL=

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

schemas

Multiexcerpt

MultiExcerptName	schema

Code Block

language	json
linenumbers	true

{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"$id": "BASEURL/versioningData.json",
	"title": "3DS Versioning",
	"description": "3DS Versioning Data",
	"type": "object",
	"properties": {
		"threeDSServerTransID": {
			"type": ["string", "null"],
			"maxLength": 36
		},
		"acsStartProtocolVersion": {
			"type": ["string", "null"],
			"minLength": 5,
			"maxLength": 8
		},
		"acsEndProtocolVersion": {
			"type": ["string", "null"],
			"minLength": 5,
			"maxLength": 8
		},
		"dsStartProtocolVersion": {
			"type": ["string", "null"],
			"minLength": 5,
			"maxLength": 8
		},
		"dsEndProtocolVersion": {
			"type": ["string", "null"],
			"minLength": 5,
			"maxLength": 8
		},
		"threeDSMethodURL": {
			"type": ["string", "null"],
			"maxLength": 256
		},
		"threeDSMethodDataForm": {
			"type": ["string", "null"]
		},
		"threeDSMethodData": {
			"type": ["object", "null"],
			"properties": {
				"threeDSMethodNotificationURL" : {
					"type": "string",
					"format": "uri"
				},
				"threeDSServerTransID": {
					"type": "string",
					"maxLength": 36
				}
			},
			"required": ["threeDSMethodNotificationURL", "threeDSServerTransID"],
			"additionalProperties": false
		},
		"errorDetails": {
			"type": "object",
			"properties": {
				"threeDSServerTransID": {
					"type": "string",
					"maxLength": 36
				},
				"errorCode": {
					"type": "string",
					"minLength": 3,
					"maxLength": 3
				},
				"errorComponent": {
					"type": "string",
					"enum": ["C", "S", "D", "A"]
				},
				"errorDescription": {
					"type": "string"
				}
			},
			"required": ["threeDSServerTransID", "errorCode", "errorComponent", "errorDescription"],
			"additionalProperties": false
		},
	},
	"required": ["threeDSServerTransID", "acsStartProtocolVersion", "acsEndProtocolVersion", "dsStartProtocolVersion", "dsEndProtocolVersion", "threeDSMethodURL", "threeDSMethodDataForm", "threeDSMethodData"],
	"additionalProperties": false
}

Samples

Successful versioning retrieved from 3DS Server

Multiexcerpt

MultiExcerptName	sample

Code Block

language	json
linenumbers	true

{
	"threeDSServerTransID": "14dd844c-b0fc-4dfe-8635-366fbf43468c",
	"acsStartProtocolVersion": "2.1.0",
	"acsEndProtocolVersion": "2.1.0",
	"dsStartProtocolVersion": "2.1.0",
	"dsEndProtocolVersion": "2.1.0",
	"threeDSMethodURL": "https://3ds-sim-dev.computop.com//acs/3ds-method",
	"threeDSMethodDataForm": "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly93d3cuY29tcHV0b3AtcGF5Z2F0ZS5jb20vY2JUaHJlZURTLmFzcHg_YWN0aW9uPW10aGROdGZuIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiIxNGRkODQ0Yy1iMGZjLTRkZmUtODYzNS0zNjZmYmY0MzQ2OGMifQ==",
	"threeDSMethodData": {
		"threeDSMethodNotificationURL": "https://www.computop-paygate.com/cbThreeDS.aspx?action=mthdNtfn",
		"threeDSServerTransID": "14dd844c-b0fc-4dfe-8635-366fbf43468c"
	}
}

Card number not enrolled for 3DS 2.0 (Fallback to 1.0)

Multiexcerpt

MultiExcerptName	sample_fallback

Code Block

language	json
linenumbers	true

{
	"threeDSServerTransID": null,
	"acsStartProtocolVersion": null,
	"acsEndProtocolVersion": null,
	"dsStartProtocolVersion": null,
	"dsEndProtocolVersion": null,
	"threeDSMethodURL": null,
	"threeDSMethodDataForm": null,
	"threeDSMethodData": null,
	"errorDetails": {
		"threeDSServerTransID": "20cfe55b-4ba2-425d-bf3a-29479886db56",
		"errorCode": "404",
		"errorComponent": "S",
		"errorDescription": "Card account number not found in card ranges from Directory Server"
	}
}

Table of Contents

Space shortcuts

Page tree

Versions Compared

Old Version 4

New Version Current

Key

Data Elements

Anchor
threeDSMethodData
threeDSMethodData
threeDSMethodData

Anchor
errorDetails
errorDetails
errorDetails

errorCode

Schema

Samples

Successful versioning retrieved from 3DS Server

Card number not enrolled for 3DS 2.0 (Fallback to 1.0)

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 4

New Version Current

Key

Data Elements

AnchorthreeDSMethodDatathreeDSMethodDatathreeDSMethodData

AnchorerrorDetailserrorDetailserrorDetails

errorCode

Schema

Samples

Successful versioning retrieved from 3DS Server

Card number not enrolled for 3DS 2.0 (Fallback to 1.0)

Anchor
threeDSMethodData
threeDSMethodData
threeDSMethodData

Anchor
errorDetails
errorDetails
errorDetails