versioningData | Computop Documents

Datenelemente

Key

Format

CND

Beschreibung

threeDSServerTransID

string

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

acsStartProtocolVersion

string

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

acsEndProtocolVersion

string

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

dsStartProtocolVersion

string

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.

dsEndProtocolVersion

string

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.

threeDSMethodURL

string

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.

threeDSMethodDataForm

string

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.

threeDSMethodData

object

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

errorDetails

object

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).

threeDSMethodData

Key

Format

CND

Beschreibung

threeDSMethodNotificationURL

string

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.

threeDSServerTransID

string

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

errorDetails

Key

Format

CND

Beschreibung

threeDSServerTransID

string

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

errorCode

string

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

errorComponent

string

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

errorDescription

string

Fehlerbeschreibung

errorCode

Code

Beschreibung

101

Empfangene Nachricht ungültig

102

Versionsnummer der Nachricht nicht unterstützt

103

Limit für gesendete Nachrichten überschritten. Nur für PReq verwendet.

201

Erforderliches Element fehlt

202

Kritische Nachrichtenerweiterung nicht erkannt

203

Format bei einem oder mehreren Elementen ungültig gemäß Spezifikationen

204

Doppeltes Datenelement

301

Transaktions-ID nicht erkannt

302

Fehler der Datenentschlüsselung

303

Zugriff abgelehnt, ungültiger Endpunkt

304

ISO-Code ungültig

305

Transaktionsdaten ungültig

306

Händler-Kategoriecode ist für das Zahlungssystem nicht gültig

307

Seriennummer ungültig

402

Zeitüberschreitung der Transaktion

403

Vorübergehender Systemfehler

404

Permanenter Systemfehler

405

Systemverbindungsfehler

911

Spezifischer Fehlercode von UnionPay. Vorhanden, wenn Datenfelder-Relevanzprüfung scheitert (ECI-Wert und AV-Erscheinungsbild sind inkonsistent zum Transaktionsstatus).

912

Spezifischer Fehlercode von UnionPay. Vorhanden bei doppelter Transaktions-ID (Die Transaktions-ID sollte für jede AReq-Anfrage eindeutig sein).

Schema

BASEURL= https://www.computop-paygate.com/schemas

1
{
2
	"$schema": "http://json-schema.org/draft-07/schema#",
3
	"$id": "BASEURL/versioningData.json",
4
	"title": "3DS Versioning",
5
	"description": "3DS Versioning Data",
6
	"type": "object",
7
	"properties": {
8
		"threeDSServerTransID": {
9
			"type": ["string", "null"],
10
			"maxLength": 36
11
		},
12
		"acsStartProtocolVersion": {
13
			"type": ["string", "null"],
14
			"minLength": 5,
15
			"maxLength": 8
16
		},
17
		"acsEndProtocolVersion": {
18
			"type": ["string", "null"],
19
			"minLength": 5,
20
			"maxLength": 8
21
		},
22
		"dsStartProtocolVersion": {
23
			"type": ["string", "null"],
24
			"minLength": 5,
25
			"maxLength": 8
26
		},
27
		"dsEndProtocolVersion": {
28
			"type": ["string", "null"],
29
			"minLength": 5,
30
			"maxLength": 8
31
		},
32
		"threeDSMethodURL": {
33
			"type": ["string", "null"],
34
			"maxLength": 256
35
		},
36
		"threeDSMethodDataForm": {
37
			"type": ["string", "null"]
38
		},
39
		"threeDSMethodData": {
40
			"type": ["object", "null"],
41
			"properties": {
42
				"threeDSMethodNotificationURL" : {
43
					"type": "string",
44
					"format": "uri"
45
				},
46
				"threeDSServerTransID": {
47
					"type": "string",
48
					"maxLength": 36
49
				}
50
			},
51
			"required": ["threeDSMethodNotificationURL", "threeDSServerTransID"],
52
			"additionalProperties": false
53
		},
54
		"errorDetails": {
55
			"type": "object",
56
			"properties": {
57
				"threeDSServerTransID": {
58
					"type": "string",
59
					"maxLength": 36
60
				},
61
				"errorCode": {
62
					"type": "string",
63
					"minLength": 3,
64
					"maxLength": 3
65
				},
66
				"errorComponent": {
67
					"type": "string",
68
					"enum": ["C", "S", "D", "A"]
69
				},
70
				"errorDescription": {
71
					"type": "string"
72
				}
73
			},
74
			"required": ["threeDSServerTransID", "errorCode", "errorComponent", "errorDescription"],
75
			"additionalProperties": false
76
		},
77
	},
78
	"required": ["threeDSServerTransID", "acsStartProtocolVersion", "acsEndProtocolVersion", "dsStartProtocolVersion", "dsEndProtocolVersion", "threeDSMethodURL", "threeDSMethodDataForm", "threeDSMethodData"],
79
	"additionalProperties": false
80
}

Beispiele

Erfolgreiche Versionierung vom 3DS Server abgerufen

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

Kartennummer nicht für 3DS 2.0 angemeldet (Fallback auf 1.0)

1
{
2
	"threeDSServerTransID": null,
3
	"acsStartProtocolVersion": null,
4
	"acsEndProtocolVersion": null,
5
	"dsStartProtocolVersion": null,
6
	"dsEndProtocolVersion": null,
7
	"threeDSMethodURL": null,
8
	"threeDSMethodDataForm": null,
9
	"threeDSMethodData": null,
10
	"errorDetails": {
11
		"threeDSServerTransID": "20cfe55b-4ba2-425d-bf3a-29479886db56",
12
		"errorCode": "404",
13
		"errorComponent": "S",
14
		"errorDescription": "Card account number not found in card ranges from Directory Server"
15
	}
16
}