...

...

...

...

...

...

...

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":""
}

...

...

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

...

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