resultResponse
JSON Objekt
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
BASEURL= https://www.computop-paygate.com/schemas
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "BASEURL/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": "The ACS interface that the challenge will present to the cardholder."
},
"acsUiTemplate": {
"type": "string",
"enum": ["text", "singleSelect", "multiSelect", "oob", "other",""],
"description": "Identifies the UI Template format that the ACS first presents to the consumer."
}
},
"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", ""]
},
"dsScore": {
"type": "string",
"maxLength": 5
},
"challengeRequestInd": {
"type": "string",
"maxLength": 2
},
"cardholderInfo": {
"type": "string",
"maxLength": 128
}
},
"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“:““
}
