• DeutschEnglish

authenticationResponse

Das Objekt authenticationResponse ist Teil der Authentisierungs-Benachrichtigung, die vom Paygate an den Server des Händlers gesendet wird. Es ist nur für Server-zu-Server-Integrationen zutreffend.

Beachten Sie bitte, dass alle unten genannten Datenelemente in authenticationResponse vorhanden sind, aber je nach Bedingung einen Leerstring enthalten können.

Datenelemente

Key

Format

CND

Beschreibung

threeDSServerTransID

string

M

Computop Paygate PayID im kanonischen Format gemäß IETF RFC 4122

acsChallengeMandated

boolean

M

Zeigt an, on eine Challenge für die Autorisierung einer Transaktion wegen lokaler/regionaler Vorschriften oder anderer Variablen nötig ist:

  • true → Challenge ist obligatorisch wegen lokaler/regionaler Vorschriften

  • false → Challenge ist nicht obligatorisch wegen lokaler/regionaler Vorschriften, wird aber von ACS als nötig angesehen

acsDecConInd

boolean

C

Zeigt an, das der ACS die Verwendung der Entkoppelten Authentisierung bestätigt und stimmt der Nutzung der Entkoppelten Authentisierung für den Karteninhaber zu. Erforderlich, wenn Transaction Status = D.

acsOperatorID

string

C

Vom DS zugeordnete ACS-Kennung. Jeder DS kann jedem ACS auf individueller Basis ein eindeutige ID geben. Die Anforderungen für das Vorhandensein dieses Feldes sind DS-spezifisch.

acsReferenceNumber

string

M

Vom EMVCo-Sekretariat nach Prüfung und Zulassung zugeordnete eindeutige Kennung

acsRenderingType

object

C

Nur App-basiert. Identifiziert die ACS UI-Vorlage, die der ACS zuerst dem Kunden zeigen wird. Erforderlich, wenn Transaction Status = C.

acsSignedContent

string

C

Nur App-basiert. Enthält das JWS-Objekt (als String dargestellt), dass vom ACS für die ARes-Nachricht erzeugt wurde. Erforderlich, wenn Transaction Status = C.

acsTransID

string

M

Universelle eindeutige Transaktionskennung, die vom ACS zur Identifikation einer Einzeltransaktion vergeben wird

acsURL

string

C

Vollständige URL des ACS, um den Challenge Request zu posten. Bei App-basierter Transaktion ist dieses Datenelement im ACS Signed Content JWS Objekt enthalten. Erforderlich, wenn Transaction Status = C.

authenticationType

string

C

Zeigt die Art der Authentisierungsmethode an, die der Issuer als Challenge für den Karteninhaber verwenden will. Erforderlich, wenn Transaction Status = C oder D.

Zulässige Werte:

  • 01 = static

  • 02 = dynamic

  • 03 = oob

Zukünftige Implementierung. Ab Protokoll-Version 2.2.0 -

  • 04 = decoupled

authenticationValue

string

C

Zahlungssystemspezifischer vom ACS or DS bereitgestellter Wert, um einen Nachweis der Authentisierung bereitzustellen. Erforderlich, wenn Transaction Status = Y oder A. Bedingt basierend auf DS-Regeln, wenn Transaction Status = I.

broadInfo

string

C

Unstrukturierte Informationen, die zwischen dem 3DS Server, dem DS und dem ACS gesendet werden. Die Anforderungen für das Vorhandensein dieses Feldes sind DS-spezifisch.

cardholderInfo

string

C

Vom ACS/Issuer an den Karteninhaber bereitgestellter Text während einer Reibungslosen oder Entkoppelten Transaktion. Der Issuer kann dem Karteninhaber Informationen übermitteln. Zum Beispiel “Für diese Transaktion ist eine zusätzliche Authentisierung erfoderlich, bitte wenden Sie sich an (Issuer-Name) unter xxx-xxx-xxxx.” Erforderlich, falls der ACS Decoupled Confirmation Indicator = true; anderenfalls optional für den ACS.

dsReferenceNumber

string

M

Von EMVCo vergebene eindeutige Kennung zur Nachverfolgung genehmigter DS

dsTransID

string

M

Vom DS vergebene universelle eindeutige Transaktionskennung zur Identifizierung einer Einzeltransaktion

eci

string

M

Zahlungssystemspezifischer vom ACS or DS bereitgestellter Wert, um das Ergebnis des Versuchs zur Authentisierung des Karteninhabers anzugeben. Die Anforderungen für das Vorhandensein dieses Feldes sind DS-spezifisch.

messageExtension

string

C

Zur Unterstützung der Anforderungen nötige Daten, die nirgendwo anders in der 3-D Secure Nachricht definiert sind, werden in einer Nachrichten-Erweiterung geführt. Bedingungen sind von jedem DS zu setzen.

messageType

string

M

Bestimmt die Art der zu übermittelnden Nachricht.

Zulässige Werte:

  • AReq

  • ARes

  • CReq

  • CRes

  • PReq

  • PRes

  • RReq

  • RRes

messageVersion

string

M

Kennung der Protokollversion

sdkTransID

string

C

Nur App-basiert. Universelle eindeutige Transaktionskennung, die vom 3DS SDK zur Identifikation einer Einzeltransaktion vergeben wird.

transStatus

string

M

Zeigt an, ob sich eine Transaktion als eine authentisierte Transaktion qualifiziert

Zulässige Werte:

  • Y = Authentisierungs-Überprüfung erfolgreich

  • N = Nicht authentisiert /Konto nicht verifiziert; Transaktion abgelehnt

  • U = Authentisierung/ Konto-Verifizierung konnte nicht ausgeführt werden; technisches oder sonstiges Problem, wie in ARes oder RReq angegeben

  • A = Verarbeitung des Versuchs ausgeführt; Nicht authentisiert/verifiziert, aber ein Nachweis der versuchten Authentisierung/Verifizierung ist gegeben

  • C = Challenge erforderlich; eine zusätzliche Authentisierung mittels CReq/CRes ist erforderlich

  • D = Challenge erforderlich; Entkoppelte Authentisierung bestätigt

  • R = Authentisierung/ Konto-Verifizierung abgelehnt; der Issuer lehnt die Authentisierung/Verifizierung ab und verlangt, dass die Autorisierung nicht versucht wird

  • I = Nur zur Information; 3DS Requestor Challenge-Präferenz anerkannt

transStatusReason

string

C

Gibt Informationen darüber, warum das Feld des Transaktionsstatus den angegebenen Wert hat. Erforderlich, wenn der Transaktionsstatus = N, U oder R ist.

Zulässige Werte: siehe Tabelle

whiteListStatus

string

C

Zukünftige Verwendung. Wird erst ab Protokoll-Version 2.2.0 aufwärts unterstützt. Ermöglicht die Übermittelung des Status vertrauenswürdiger Empfänger/Whitelist.

Zulässige Werte:

  • Y = 3DS Requestor steht beim Karteninhaber auf der Whitelist

  • N = 3DS Requestor steht beim Karteninhaber nicht auf der Whitelist

  • E = Nicht wählbar, wie vom Issuer ermittelt

  • P = Ausstehende Bestätigung des Karteninhabers

  • R = Karteninhaber abgelehnt

  • U = Whitelist-Status unbekannt, nicht verfügbar oder nicht zutreffend

whiteListStatusSource

string

C

Zukünftige Verwendung. Wird erst ab Protokoll-Version 2.2.0 aufwärts unterstützt. Dieses Datenelement wird vom System ausgefüllt, dass den Whitelist-Status setzt.

Zulässige Werte:

  • 01 = 3DS Server

  • 02 = DS

  • 03 = ACS

challengeRequest

object

C

Objekt Challenge-Anfrage im Fall, dass die Authentisierungs-Antwort anzeigt, dass eine weitere Interaktion des Karteninhabers erforderlich ist, um die Authentisierung abzuschließen

base64EncodedChallengeRequest

string

C

Base64-codiertes Objekt Herausforderungs-Anfrage im Fall, dass die Authentisierungs-Antwort anzeigt, dass eine weitere Interaktion des Karteninhabers erforderlich ist, um die Authentisierung abzuschließen.

threeDSCompInd

string

M

Zeigt an, ob die 3DS-Methode erfolgreich abgeschlossen wurde.

  • Y = Erfolgreich abgeschlossen

  • N = Nicht erfolgreich abgeschlossen

  • U = Nicht verfügbar – der 3DS Method URL wurde keine Kartenkontonummer übermittelt

Schema

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

1
{
2
"$schema": "http://json-schema.org/draft-07/schema#",
3
"$id": "BASEURL/authenticationResponse.json",
4
"title": "authenticationResponse",
5
"description": "Authentication Response",
6
"type": "object",
7
"properties": {
8
"threeDSServerTransID": {
9
"type": "string",
10
"maxLength": 36
11
},
12
"acsChallengeMandated": {
13
"type": "boolean"
14
},
15
"acsDecConInd": {
16
"type": "boolean"
17
},
18
"acsOperatorID": {
19
"type": "string",
20
"maxLength": 32
21
},
22
"acsReferenceNumber": {
23
"type": "string",
24
"maxLength": 32
25
},
26
"acsRenderingType": {
27
"type": "object",
28
"properties": {
29
"acsInterface": {
30
"type": "string",
31
"enum": ["native", "html", ""],
32
"description": "The ACS interface that the challenge will present to the cardholder."
33
},
34
"acsUiTemplate": {
35
"type": "string",
36
"enum": ["text", "singleSelect", "multiSelect", "oob", "other",""],
37
"description": "Identifies the UI Template format that the ACS first presents to the consumer."
38
}
39
},
40
"required": ["acsInterface", "acsUiTemplate"],
41
"additionalProperties": false
42
},
43
"acsSignedContent": {
44
"type": "string"
45
},
46
"acsTransID": {
47
"type": "string",
48
"maxLength": 36
49
},
50
"acsURL": {
51
"type": "string",
52
"maxLength": 2048,
53
"format": "uri"
54
},
55
"authenticationType": {
56
"type": "string",
57
"enum": ["static", "dynamic", "oob", "decoupled", ""]
58
},
59
"authenticationValue": {
60
"type": "string",
61
"maxLength": 28
62
},
63
"broadInfo": {
64
"type": "string",
65
"maxLength": 4096
66
},
67
"cardholderInfo": {
68
"type": "string",
69
"maxLength": 128
70
},
71
"dsReferenceNumber": {
72
"type": "string",
73
"maxLength": 32
74
},
75
"dsTransID": {
76
"type": "string",
77
"maxLength": 36
78
},
79
"eci": {
80
"type": "string",
81
"maxLength": 2
82
},
83
"messageExtension": {
84
"type": "string",
85
"maxLength": 81920
86
},
87
"messageType": {
88
"type": "string",
89
"enum": ["ARes"]
90
},
91
"messageVersion": {
92
"type": "string",
93
"minLength": 5,
94
"maxLength": 8
95
},
96
"sdkTransID": {
97
"type": "string",
98
"maxLength": 36
99
},
100
"transStatus": {
101
"type": "string",
102
"enum": ["Y", "N", "U", "A", "C", "D", "R", "I", ""]
103
},
104
"transStatusReason": {
105
"type": "string",
106
"enum": ["01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "80", "81", "82", "83", "84", "85", "86", "87", "88", ""]
107
},
108
"whiteListStatus": {
109
"type": "string",
110
"enum": ["Y", "N", "E", "P", "R", "U", ""]
111
},
112
"whiteListStatusSource": {
113
"type": "string",
114
"enum": ["01", "02", "03", ""]
115
},
116
"challengeRequest": {
117
"type": "object",
118
"properties": {
119
"threeDSServerTransID": {
120
"type": "string",
121
"maxLength": 36
122
},
123
"acsTransID": {
124
"type": "string",
125
"maxLength": 36
126
},
127
"challengeWindowSize": {
128
"type": "string",
129
"enum": ["01", "02", "03", "04", "05"]
130
},
131
"messageVersion": {
132
"type": "string",
133
"minLength": 5,
134
"maxLength": 8
135
},
136
"messageType": {
137
"type": "string",
138
"enum": ["CReq"]
139
}
140
},
141
"required": ["threeDSServerTransID", "acsTransID", "challengeWindowSize", "messageVersion", "messageType"],
142
"additionalProperties": false
143
},
144
"base64EncodedChallengeRequest": {
145
"type": "string"
146
},
147
"threeDSCompInd": {
148
"type": "string",
149
"enum": ["Y", "N", "U", ""]
150
}
151
},
152
"required": [
153
"threeDSServerTransID",
154
"acsChallengeMandated",
155
"acsOperatorID",
156
"acsReferenceNumber",
157
"acsRenderingType",
158
"acsSignedContent",
159
"acsTransID",
160
"acsURL",
161
"authenticationType",
162
"authenticationValue",
163
"broadInfo",
164
"cardholderInfo",
165
"dsReferenceNumber",
166
"dsTransID",
167
"eci",
168
"messageExtension",
169
"messageType",
170
"messageVersion",
171
"sdkTransID",
172
"transStatus",
173
"transStatusReason",
174
"whiteListStatus",
175
"whiteListStatusSource",
176
"challengeRequest",
177
"base64EncodedChallengeRequest",
178
"threeDSCompInd"
179
],
180
"additionalProperties": false
181
}

Beispiel

1
{
2
"threeDSServerTransID": "d9cf63f3-98ba-4e82-aa39-ca90c68f5262",
3
"acsChallengeMandated": false,
4
"acsDecConInd": false,
5
"acsOperatorID": "visaOperatorId",
6
"acsReferenceNumber": "3DS_LOA_ACS_NEAG_020100_00055",
7
"acsRenderingType": {
8
"acsInterface": "",
9
"acsUiTemplate": ""
10
},
11
"acsSignedContent": "",
12
"acsTransID": "fa15dced-02b7-4469-9a79-225786a02ae1",
13
"acsURL": "https://mc-id-check.firstdata.de/challengeRequestBrowser",
14
"authenticationType": "",
15
"authenticationValue": "",
16
"broadInfo": "",
17
"cardholderInfo": "",
18
"dsReferenceNumber": "VISA.V 17 0003",
19
"dsTransID": "a9645de6-52ba-4f79-abaa-f3050b9a5300",
20
"eci": "",
21
"messageExtension": "",
22
"messageType": "ARes",
23
"messageVersion": "2.1.0",
24
"sdkTransID": "",
25
"transStatus": "C",
26
"transStatusReason": "",
27
"whiteListStatus": "",
28
"whiteListStatusSource": "",
29
"challengeRequest": {
30
"threeDSServerTransID": "d9cf63f3-98ba-4e82-aa39-ca90c68f5262",
31
"acsTransID": "fa15dced-02b7-4469-9a79-225786a02ae1",
32
"challengeWindowSize": "03",
33
"messageVersion": "2.1.0",
34
"messageType": "CReq"
35
},
36
"base64EncodedChallengeRequest": "eyJtZXNzYWdlVHlwZSI6IkNSZXEiLCJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImQ5Y2Y2M2YzLTk4YmEtNGU4Mi1hYTM5LWNhOTBjNjhmNTI2MiIsImFjc1RyYW5zSUQiOiJmYTE1ZGNlZC0wMmI3LTQ0NjktOWE3OS0yMjU3ODZhMDJhZTEiLCJjaGFsbGVuZ2VXaW5kb3dTaXplIjoiMDMiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIn0=",
37
"threeDSCompInd": ""
38
}

Paygate

Documentation (EN)

Dokumentation (DE)

Paygate Status