JSON Objekt
resultResponse
resultResponse
Beachten Sie bitte, dass alle nachstehenden Datenelemente in resultsResponse vorhanden sind, aber je nach Bedingung einen Leerstring enthalten können.
Parameter | Format | Bedingung | Beschreibung |
threeDSServerTransID | string | M | 1cs Online Bezahlsystem 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 | Erfoderlich, 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, eideutige Transaktion-ID zur Ifentifikation einer Einzeltransaktion. |
transStatus | string | M | Gibt an, ob sich eine Transaktion als eine authentisierte Transaktion qualifiziert. Zulässige Werte: · Y = Authentisierungs-Überprüfung erfolreich · 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 erfoderlich; zusätzliche Authentisierung mittels CReq/CRes ist erforderlich · D = Challenge erfoderlich; 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ülstige 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 Verwendeng. 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 Verwendeng. 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 · 02 = DS · 03 = ACS |
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 | O | 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
{
“$schema”: “http://json-schema.org/draft-07/schema#”,
“$id”: “https://www.computop-paygate.com/schemas/resultsResponse.json”,
“type”: “object”,
“properties”: {
“threeDSServerTransID”: {
“type”: “string”,
“maxLength”: 36
},
“acsTransID”: {
“type”: “string”,
“maxLength”: 36
},
“acsRenderingType”: {
“type”: “object”,
“properties”: {
“acsInterface”: {
“type”: “string”,
“enum”: [“native”, “html”, “”],
“description”: “Die ACS-Schnittstelle, die dem Karteninhaber die Challenge zeigen wird.”
},
“acsUiTemplate”: {
“type”: “string”,
“enum”: [“text”, “singleSelect”, “multiSelect”, “oob”, “other”,””],
“description”: “Bestimmt das Format der UI-Vorlage, die der ACS dem Kunden zuerst zeigt.”
}
},
“required”: [“acsInterface”, “acsUiTemplate”],
“additionalProperties”: false
},
“authenticationType”: {
“type”: “string”,
“enum”: [“01”, “02”, “03”, “04”, “”]
},
“authenticationValue”: {
“type”: “string”,
“maxLength”: 28
},
“challengeCancel”: {
“type”: “string”,
“enum”: [“01”, “02”, “03”, “04”, “05”, “06”, “07”, “08”, “”]
},
“dsTransID”: {
“type”: “string”,
“maxLength”: 36
},
“eci”: {
“type”: “string”,
“maxLength”: 2
},
“interactionCounter”: {
“type”: “string”,
“maxLength”: 2
},
“messageCategory”: {
“type”: “string”,
“enum”: [“01”, “02”]
},
“messageExtension”: {
“type”: “string”,
“maxLength”: 81920
},
“messageVersion”: {
“type”: “string”,
“minLength”: 5,
“maxLength”: 8
},
“sdkTransID”: {
“type”: “string”,
“maxLength”: 36
},
“transStatus”: {
“type”: “string”,
“enum”: [“Y”, “N”, “U”, “A”, “C”, “D”, “R”, “I”, “”]
},
“transStatusReason”: {
“type”: “string”,
“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”, “”]
}
},
“required”: [“threeDSServerTransID”, “acsTransID”, “acsRenderingType”, “authenticationType”, “authenticationValue”, “challengeCancel”, “dsTransID”, “eci”, “interactionCounter”, “messageCategory”, “messageExtension”, “messageVersion”, “sdkTransID”, “transStatus”, “transStatusReason”],
“additionalProperties”: false
}
Beispiel
{
“threeDSServerTransID”:”9e944d5d-56f3-461d-a393-80a666d346d1″,
“acsTransID”:”1e43b52f-3623-4e5d-8917-41c5c15b7218″,
“acsRenderingType”:{
“acsInterface”:”01″,
“acsUiTemplate”:”01″
},
“authenticationType”:”02″,
“authenticationValue”:”JAmi21makAifmwqo2120cjq1AAA=”,
“challengeCancel”:””,
“dsTransID”:”c626e8a0-f2ba-42b3-aa6d-620658421f3a”,
“eci”:”05″,
“interactionCounter”:”01″,
“messageCategory”:”01″,
“messageExtension”:””,
“messageVersion”:”2.1.0″,
“sdkTransID”:””,
“transStatus”:”Y”,
“transStatusReason”:””
}