• DeutschEnglish

resultsResponse

Datenelemente

Beachten Sie bitte, dass alle nachstehenden Datenelemente in resultsResponsevorhanden sind, aber je nach Bedingung einen Leerstring enthalten können.

Key

Format

CND

Beschreibung

threeDSServerTransID

string

M

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

acsTransID

string

M

Vom ACS vergebene universelle, eindeutige Transaktions-ID zur Identifikation einer Einzeltransaktion

acsRenderingType

object

C

Erforderlich, sofern nicht ACS Entkoppelte Bestätigung = true

authenticationType

string

C

Erforderlich, wenn der Transaktionsstatus = Y oder N ist.

Gibt die Art der Authentisierungsmethode an, die der Issuer als Challenge für den Karteninhaber verwenden will. Erforderlich, wenn der Transaktionsstatus = C oder D ist.

Zulässige Werte:

  • 01 = static

  • 02 = dynamic

  • 03 = oob

Zukünftige Implementierung. Ab Protokollversion 2.2.0 aufwärts -

  • 04 = decoupled

authenticationValue

string

C

Erforderlich, wenn Transaktionsstatus = Y oder A

challengeCancel

string

C

Indikator, der darüber informiert, dass die Authentisierung abgebrochen wurde.

Zulässige Werte:

  • 01 = Karteninhaber wählte “Abbrechen”

  • 02 = Reserviert für zukünftige EMVCo Verwendung (Werte ungültig, solange sie nicht durch EMVCo definiert sind)

  • 03 = Zeitüberschreitung der Transaktion – Entkoppelte Authentisierung

  • 04 = Zeitüberschreitung der Transaktion am ACS – andere Zeitüberschreitungen

  • 05 = Zeitüberschreitung der Transaktion am ACS – Erste CReq vom ACS nicht empfangen

  • 06 = Transaktionsfehler

  • 07 = Unbekannt

  • 08 = Zeitüberschreitung der Transaktion am SDK

dsTransID

string

M

Vom DS vergebene universelle, eindeutige Transaktions-ID zur Identifikation einer Einzeltransaktion

eci

string

C

Vom ACS oder DS bereitgestellter zahlungssystemspezifischer Wert, der das Ergebnis des Versuchs zur Authentisierung des Karteninhabers angibt. Die Anforderungen für das Vorhandensein dieses Felds sind DS-spezifisch.

interactionCounter

string

M

Gibt die Anzahl der durch den Karteninhaber versuchten Authentisierungs-Zyklen an

messageCategory

string

M

Identifiziert die Kategorie der Nachricht für einen bestimmten Anwendungsfall.

Zulässige Werte:

  • 01 = PA

  • 02 = NPA

messageExtension

string

C

Nötige Daten zur Unterstützung von Anforderungen, die nicht anderweitig in der 3-D Secure Nachricht definiert sind, werden in einer Nachrichten-Erweiterung transportiert. Bedingungen sind von jedem DS festzulegen.

messageType

string

C

Identifiziert die Art der gescheiterten Nachricht im Fehlerfall.

Zulässige Werte:

  • ARes

  • RReq

messageVersion

string

M

Kennung für die Protokollversion

sdkTransID

string

M

Zukünftige Verwendung. Vom 3DS SDK vergebene universelle, eindeutige Transaktion-ID zur Identifikation einer Einzeltransaktion.

transStatus

string

M

Gibt 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/ Kontoverifizierung konnte nicht ausgeführt werden; technisches oder anderes Problem, wie in ARes oder RReq angegeben

  • A = Verarbeitung der Versuche ausgeführt; Nicht authentisiert/verifiziert, aber Nachweis der versuchten Authentisierung/Verfizierung ist bereitgestellt

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

  • D = Challenge erforderlich; entkoppelte Authentisierung bestätigt

  • R = Authentisierung/ Kontoverifizierung abgelehnt; Issuer lehnt Authentisierung/Verifizierung ab und fordert, dass keine Autorisierung versucht wird

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

transStatusReason

string

C

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

Zulässige Werte:

  • 01 = Kartenauthentisierung gescheitert

  • 02 = Unbekanntes Gerät

  • 03 = Nicht unterstütztes Gerät

  • 04 = Überschreitet das Limit für die Authentisierungshäufigkeit

  • 05 = Abgelaufene Karte

  • 06 = Ungültige Kartennummer

  • 07 = Ungültige Transaktion

  • 08 = Kein Kartendatensatz

  • 09 = Sicherheitsfehler

  • 10 = Gestohlene Karte

  • 11 = Betrugsverdacht

  • 12 = Transaktion für den Karteninhaber nicht erlaubt

  • 13 = Karteninhaber nicht für den Service angemeldet

  • 14 = Zeitüberschreiung der Transaktion am ACS

  • 15 = Geringes Vertrauen

  • 16 = Mittleres Vertrauen

  • 17 = Hohes Vertrauen

  • 18 = Sehr hohes Vertrauen

  • 19 = Überschreitet das ACS Maximum der Challenges

  • 20 = Nicht zahlungswirksame Transaktion nicht unterstützt

  • 21 = 3RI-Transaktion nicht unterstützt

  • 22 = ACS technisches Problem

  • 23 = Entkoppelte Authentisierung vom ACS gefordert, aber vom 3DS Requestor nicht angefragt

  • 24 = 3DS Requestor maximale Ablaufzeit bei Entkopplung überschritten

  • 25 = Entkoppelte Authentisierung hatte unzureichend Zeit für die Authentisierung des Karteninhabers. ACS macht keinen Versuch

  • 26 = Authentisierung versucht, aber vom Karteninhaber nicht ausgeführt

whiteListStatus

string

C

Zukünftige Verwendung. Erst ab Protokollversion 2.2.0 aufwärts unterstützt. Ermöglicht die Übermittlung von Statuswerten Vertrauenswürdige 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 = Nach Festlegung vom Issuer nicht wählbar

  • P = Ausstehende Bestätigung vom Karteninhaber

  • R = Karteninhaber abgelehnt

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

whiteListStatusSource

string

C

Zukünftige Verwendung. Erst ab Protokollversion 2.2.0 aufwärts unterstützt. Dieses Datenelement wird von dem System ausgefüllt, dass den Whitelist-Status setzt.

Zulässige Werte:

  • 01 = 3DS Server (3-D Server)

  • 02 = DS (Directory Server)

  • 03 = ACS (Access Control Server)

dsScore

string

O

Scoring-Ergebnis des Directory Server (Scheme) der Transaktion während der Authentifizierung. Format und Wert sind DS-spezifisch.

challengeRequestInd

string

O

Gibt die Präferenz des Händlers für die Challenge für diese Transaktion während der 3DS-Authentisierung zurück.

Zulässige Werte gemäß den neuesten EMVCo 3D-Secure-Spezifikationen: 2-stelliger Wert, 01-99

  • 01 = Keine Präferenz

  • 02 = Keine Herausforderung angefordert

  • 03 = Herausforderung angefordert (3DS-Anfragesteller-Präferenz)

  • 04 = Herausforderung angefordert (Mandat)

  • 05 = Keine Herausforderung angefordert (transaktionale Risikoanalyse wurde bereits durchgeführt)

  • 06 = Keine Herausforderung angefordert (nur Datenfreigabe)

  • 07 = Keine Herausforderung angefordert (starke Verbraucherauthentifizierung wurde bereits durchgeführt)

  • 08 = Keine Herausforderung angefordert (verwenden Sie die Ausnahme von der weißen Liste, wenn keine Herausforderung erforderlich ist)

  • 09 = Herausforderung angefordert (Aufforderung zur Whitelist angefordert, wenn Herausforderung erforderlich)

  • 10–79= Reserviert für die zukünftige Verwendung von EMVCo (Werte ungültig, bis EMVCo definiert)

  • 80–99 = Reserviert für DS-Nutzung

cardholderInfo

string

C

Text, der dem Karteninhaber während einer reibungslosen oder entkoppelten Transaktion vom ACS/Aussteller bereitgestellt wird. Der Issuer kann dem Karteninhaber so Informationen zur Verfügung stellen. Beispiel: „Für diese Transaktion ist eine zusätzliche Authentifizierung erforderlich, bitte kontaktieren Sie (Name des Ausstellers) unter xxx-xxx-xxxx.“ oder auch "Ihre Karte ist nicht für 3-D Secure registriert. Bitte registrieren Sie Ihre Karte über das Registrierungsportal Ihrer Bank."

Schema

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

1
{
2
"$schema": "http://json-schema.org/draft-07/schema#",
3
"$id": "BASEURL/resultsResponse.json",
4
"type": "object",
5
"properties": {
6
"threeDSServerTransID": {
7
"type": "string",
8
"maxLength": 36
9
},
10
"acsTransID": {
11
"type": "string",
12
"maxLength": 36
13
},
14
"acsRenderingType": {
15
"type": "object",
16
"properties": {
17
"acsInterface": {
18
"type": "string",
19
"enum": ["native", "html", ""],
20
"description": "The ACS interface that the challenge will present to the cardholder."
21
},
22
"acsUiTemplate": {
23
"type": "string",
24
"enum": ["text", "singleSelect", "multiSelect", "oob", "other",""],
25
"description": "Identifies the UI Template format that the ACS first presents to the consumer."
26
}
27
},
28
"required": ["acsInterface", "acsUiTemplate"],
29
"additionalProperties": false
30
},
31
"authenticationType": {
32
"type": "string",
33
"enum": ["01", "02", "03", "04", ""]
34
},
35
"authenticationValue": {
36
"type": "string",
37
"maxLength": 28
38
},
39
"challengeCancel": {
40
"type": "string",
41
"enum": ["01", "02", "03", "04", "05", "06", "07", "08", ""]
42
},
43
"dsTransID": {
44
"type": "string",
45
"maxLength": 36
46
},
47
"eci": {
48
"type": "string",
49
"maxLength": 2
50
},
51
"interactionCounter": {
52
"type": "string",
53
"maxLength": 2
54
},
55
"messageCategory": {
56
"type": "string",
57
"enum": ["01", "02"]
58
},
59
"messageExtension": {
60
"type": "string",
61
"maxLength": 81920
62
},
63
"messageVersion": {
64
"type": "string",
65
"minLength": 5,
66
"maxLength": 8
67
},
68
"sdkTransID": {
69
"type": "string",
70
"maxLength": 36
71
},
72
"transStatus": {
73
"type": "string",
74
"enum": ["Y", "N", "U", "A", "C", "D", "R", "I", ""]
75
},
76
"transStatusReason": {
77
"type": "string",
78
"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", ""]
79
},
80
"dsScore": {
81
"type": "string",
82
"maxLength": 5
83
},
84
"challengeRequestInd": {
85
"type": "string",
86
"maxLength": 2
87
},
88
"cardholderInfo": {
89
"type": "string",
90
"maxLength": 128
91
}
92
},
93
"required": ["threeDSServerTransID", "acsTransID", "acsRenderingType", "authenticationType", "authenticationValue", "challengeCancel", "dsTransID", "eci", "interactionCounter", "messageCategory", "messageExtension", "messageVersion", "sdkTransID", "transStatus", "transStatusReason"],
94
"additionalProperties": false
95
}

Beispiel

1
{
2
"threeDSServerTransID":"9e944d5d-56f3-461d-a393-80a666d346d1",
3
"acsTransID":"1e43b52f-3623-4e5d-8917-41c5c15b7218",
4
"acsRenderingType":{
5
"acsInterface":"01",
6
"acsUiTemplate":"01"
7
},
8
"authenticationType":"02",
9
"authenticationValue":"JAmi21makAifmwqo2120cjq1AAA=",
10
"challengeCancel":"",
11
"dsTransID":"c626e8a0-f2ba-42b3-aa6d-620658421f3a",
12
"eci":"05",
13
"interactionCounter":"01",
14
"messageCategory":"01",
15
"messageExtension":"",
16
"messageVersion":"2.1.0",
17
"sdkTransID":"",
18
"transStatus":"Y",
19
"transStatusReason":""
20
}

1
{
2
"threeDSServerTransID": "cb32a8d4-e926-41c5-845a-eac09ebe6078",
3
"acsTransID": "969c85cf-a34f-4174-a28d-629c75c3ba0b",
4
"acsRenderingType": {
5
"acsInterface": "",
6
"acsUiTemplate": ""
7
},
8
"authenticationValue": "",
9
"dsTransID": "48daf772-ab82-4124-b5b5-af78e6afe880",
10
"eci": "00",
11
"messageCategory": "01",
12
"messageExtension": "[{"name":"ACS Data","id":"A000000004-acsData","criticalityIndicator":false,"data":{"A000000004-acsData":{"whitelistStatus":"E"}}}]",
13
"messageVersion": "2.1.0",
14
"sdkTransID": "",
15
"transStatus": "R",
16
"transStatusReason": "12",
17
"cardholderInfo": "Ihre Karte ist nicht für 3-D Secure registriert. Bitte registrieren Sie Ihre Karte über das Registrierungsportal Ihrer Bank."
18
}

Paygate

Documentation (EN)

Dokumentation (DE)

Paygate Status