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
{
„$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“:““
}
