JSON Objekt
versioningData
versioningData
Datenelemente
| Parameter | Format | Bedingung | Beschreibung |
| threeDSServerTransID | string | M | Von der First Cash Solution vergebene und an den 3DS-Server übermittelte eindeutige TransaktionsID |
| acsStartProtocolVersion | string | M | Die früheste (d.h. älteste) aktive Protokollversion, die vom ACS unterstützt wird, aus dem Kartenbereich-Datenbestand ermittelt. |
| acsEndProtocolVersion | string | M | Die aktuellste aktive Protokollversion, die für die ACS URL unterstützt wird, aus dem Kartenbereich-Datenbestand ermittelt. |
| dsStartProtocolVersion | string | M | Die früheste (d.h. älteste) aktive Protokollversion, die vom DS unterstützt wird, aus dem Kartenbereich-Datenbestand ermittelt oder optional aus dem Datenbestand des Directory Server, falls diese Information für den bestimmten Kartenbereich nicht vorhanden ist. |
| dsEndProtocolVersion | string | M | Die aktuellste aktive Protokollversion, die vom DS unterstützt wird, aus dem Kartenbereich-Datenbestand ermittelt oder optional aus dem Datenbestand des Directory Server, falls diese Information für den bestimmten Kartenbereich nicht vorhanden ist. |
| threeDSMethodURL | string | M | Die ACS URL, die von der 3DS Methode verwendet wird. Das Datenelement 3DSMethodURL kann Null sein, falls es von ACS für diesen bestimmten Kartenbereich nicht unterstützt wird. |
| hreeDSMethodDataForm | string | M | Wert, der die Daten der 3DS Methode enthält, die im 3DS Method HTTP form POST zum ACS gesendet werden. Falls die URL der 3DS Methode nicht im Kartenbereich-Datenbestand für den bestimmten Kartenbereich gespeichert ist, wird dieses Feld Null. Die Daten der 3DS Methode enthalten ein Base64-codiertes JSON-Objekt der 3DS Server Transaction ID sowie die3DS Method Notification URL. |
| threeDSMethodData | object | M | Objekt, das die Datenelemente enthält, die an die 3DS Method URL zu senden sind. |
| errorDetails | object | C | Vom 3DS Server bereitgestelltes Objekt, falls bei der Antwort auf eine Versionierungsanfrage ein Fehler aufgetreten ist (z.B. ungültige Kontonummer des Karteninhabers übermittelt, Kartenbereichsdaten nicht verfügbar, 3DS Method URL für Kontonummer des Karteninhabers nicht verfügbar, Fehler bei der Codierung/Serialisierung der Daten der 3DS Methode). |
threeDSMethodData
| Parameter | Format | Bedingung | Beschreibung |
| threeDSMethodNotificationURL | string | M | URL, welche die Benachrichtigung über den Abschluss der 3DS Methode vom ACS empfängt. Diese wird in der anfänglichen Anfrage zum ACS vom 3DS Requestor übermittelt, der die 3DS Methode ausführt. |
| threeDSServerTransID | string | M | Von der First Cash Solution vergebene und an den 3DS-Server übermittelte eindeutige TransaktionsID |
errorDetails
| Parameter | Format | Bedingung | Beschreibung |
| threeDSServerTransID | string | M | Von der First Cash Solution vergebene und an den 3DS-Server übermittelte eindeutige TransaktionsID |
| errorCode | string | M | Code, der die Art des in der Nachricht angegebenen Problems anzeigt |
| errorComponent | string | M | Code, der die 3-D Secure Komponente angibt, welche den Fehler identifiziert hat. Zulässige Werte: · C = 3DS SDK · S = 3DS Server · D = Directory Server · A = Access Control Server |
| errorDescription | string | M | Fehlerbeschreibung |
errorCode
| Code | Beschreibung |
| 101 | Empfange Nachricht ungültig |
| 102 | Versionsnummer der Nachricht nicht unterstützt |
| 103 | Limit für gesendete nachrichtet überschritten. Nur für PReq verwendet. |
| 201 | Erforderliches Element fehlt |
| 202 | Kritische Nachrichtenerweiterung nicht erkannt |
| 203 | Format bei einem oder mehreren Elementen ungültig gemäß Spezifikationen |
| 204 | Doppeles Datenelement |
| 301 | Transaktions-ID nicht erkannt |
| 302 | Fehler der Datenentschlüsselung |
| 303 | Zugriff abgelehnt, ungültiger Endpunkt |
| 304 | ISO-Code ungültig |
| 305 | Transaktionsdaten ungültig |
| 306 | Händler-Kategoriecode ist für das Zahlungssystem nicht gültig |
| 307 | Seriennummer ungültig |
| 402 | Zeitüberschreitung der Transaktion |
| 403 | Vorübergehender Systemfehler |
| 404 | Permanenter Systemfehler |
| 405 | Systemverbindungsfehler |
| 911 | Spezifischer Fehlercode von UnionPay. Vorhanden, wenn Datenfelder-Relevanzprüfung scheitert (ECI-Wert und AV-Erscheinungsbild sind inkonsistent zum Transaktionsstatus). |
| 912 | Spezifischer Fehlercode von UnionPay. Vorhanden bei doppelter Transaktions-ID (Die Transaktions-ID sollte für jede AReq-Anfrage eindeutig sein). |
Schema
{
“$schema”: “http://json-schema.org/draft-07/schema#”,
“$id”: “https://www.computop-paygate.com/schemas/versioningData.json”,
“title”: “3DS Versioning”,
“description”: “3DS Versionierungsdaten”,
“type”: “object”,
“properties”: {
“threeDSServerTransID”: {
“type”: [“string”, “null”],
“maxLength”: 36
},
“acsStartProtocolVersion”: {
“type”: [“string”, “null”],
“minLength”: 5,
“maxLength”: 8
},
“acsEndProtocolVersion”: {
“type”: [“string”, “null”],
“minLength”: 5,
“maxLength”: 8
},
“dsStartProtocolVersion”: {
“type”: [“string”, “null”],
“minLength”: 5,
“maxLength”: 8
},
“dsEndProtocolVersion”: {
“type”: [“string”, “null”],
“minLength”: 5,
“maxLength”: 8
},
“threeDSMethodURL”: {
“type”: [“string”, “null”],
“maxLength”: 256
},
“threeDSMethodDataForm”: {
“type”: [“string”, “null”]
},
“threeDSMethodData”: {
“type”: [“object”, “null”],
“properties”: {
“threeDSMethodNotificationURL” : {
“type”: “string”,
“format”: “uri”
},
“threeDSServerTransID”: {
“type”: “string”,
“maxLength”: 36
}
},
“required”: [“threeDSMethodNotificationURL”, “threeDSServerTransID”],
“additionalProperties”: false
},
“errorDetails”: {
“type”: “object”,
“properties”: {
“threeDSServerTransID”: {
“type”: “string”,
“maxLength”: 36
},
“errorCode”: {
“type”: “string”,
“minLength”: 3,
“maxLength”: 3
},
“errorComponent”: {
“type”: “string”,
“enum”: [“C”, “S”, “D”, “A”]
},
“errorDescription”: {
“type”: “string”
}
},
“required”: [“threeDSServerTransID”, “errorCode”, “errorComponent”, “errorDescription”],
“additionalProperties”: false
},
},
“required”: [“threeDSServerTransID”, “acsStartProtocolVersion”, “acsEndProtocolVersion”, “dsStartProtocolVersion”, “dsEndProtocolVersion”, “threeDSMethodURL”, “threeDSMethodDataForm”, “threeDSMethodData”],
“additionalProperties”: false
}
Beispiele
Erfolgreiche Versionierung vom 3DS Server abgerufen
{
“threeDSServerTransID”: “14dd844c-b0fc-4dfe-8635-366fbf43468c”,
“acsStartProtocolVersion”: “2.1.0”,
“acsEndProtocolVersion”: “2.1.0”,
“dsStartProtocolVersion”: “2.1.0”,
“dsEndProtocolVersion”: “2.1.0”,
“threeDSMethodURL”: “https://3ds-sim-dev.computop.com//acs/3ds-method”,
“threeDSMethodDataForm”: “eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cHM6Ly93d3cuY29tcHV0b3AtcGF5Z2F0ZS5jb20vY2JUaHJlZURTLmFzcHg_
YWN0aW9uPW10aGROdGZuIiwidGhyZWVEU1NlcnZlclRyYW5zSUQiOiIxNGRkODQ0Yy1iMGZjLTRkZmUtODYzNS0zNjZmYmY0MzQ2OGMifQ==”,
“threeDSMethodData”: {
“threeDSMethodNotificationURL”: “https://www.computop-paygate.com/cbThreeDS.aspx?action=mthdNtfn”,
“threeDSServerTransID”: “14dd844c-b0fc-4dfe-8635-366fbf43468c”
}
}
Kartennummer nicht für 3DS 2.0 angemeldet (Fallback auf 1.0)
{
“threeDSServerTransID”: null,
“acsStartProtocolVersion”: null,
“acsEndProtocolVersion”: null,
“dsStartProtocolVersion”: null,
“dsEndProtocolVersion”: null,
“threeDSMethodURL”: null,
“threeDSMethodDataForm”: null,
“threeDSMethodData”: null,
“errorDetails”: {
“threeDSServerTransID”: “20cfe55b-4ba2-425d-bf3a-29479886db56”,
“errorCode”: “404”,
“errorComponent”: “S”,
“errorDescription”: “Kartenkontonummer in Kartenbereich vom Directory Server nicht gefunden”
}
}
