...
...
...
...
...
...
...
...
...
M
...
Computop Paygate PayID im kanonischen Format gemäß IETF RFC 4122
...
acsChallengeMandated
...
boolean
...
M
...
Indikation, ob eine Challenge erforderlich ist, um die Transaktion zu autorisieren
...
acsDecConInd
...
boolean
...
C
...
Zeigt an, das der ACS die Verwendung der Entkoppelten Authentisierung bestätigt und stimmt der Nutzung der Entkoppelten Authentisierung für den Karteninhaber zu. Erforderlich, wenn Transaction Status = D.
...
acsOperatorID
...
string
...
C
...
Vom DS zugeordnete ACS-Kennung. Jeder DS kann jedem ACS auf individueller Basis ein eindeutige ID geben. Die Anforderungen für das Vorhandensein dieses Feldes sind DS-spezifisch.
...
acsReferenceNumber
...
string
...
M
...
Vom EMVCo-Sekretariat nach Prüfung und Zulassung zugeordnete eindeutige Kennung
...
...
object
...
C
...
Nur App-basiert. Identifiziert die ACS UI-Vorlage, die der ACS zuerst dem Kunden zeigen wird. Erforderlich, wenn Transaction Status = C.
...
acsSignedContent
...
string
...
C
...
Nur App-basiert. Enthält das JWS-Objekt (als String dargestellt), dass vom ACS für die ARes-Nachricht erzeugt wurde. Erforderlich, wenn Transaction Status = C.
...
acsTransID
...
string
...
M
...
Universelle eindeutige Transaktionskennung, die vom ACS zur Identifikation einer Einzeltransaktion vergeben wird
...
acsURL
...
string
...
C
...
Vollständige URL des ACS, um den Challenge Request zu posten. Bei App-basierter Transaktion ist dieses Datenelement im ACS Signed Content JWS Objekt enthalten. Erforderlich, wenn Transaction Status = C.
...
authenticationType
...
string
...
C
...
Zeigt die Art der Authentisierungsmethode an, die der Issuer als Challenge für den Karteninhaber verwenden will. Erforderlich, wenn Transaction Status = C oder D.
Zulässige Werte:
01 = static
02 = dynamic
03 = oob
Zukünftige Implementierung. Ab Protokol-Version 2.2.0 -
04 = decoupled
...
authenticationValue
...
string
...
C
...
Zahlungssystemspezifischer vom ACS or DS bereitgestellter Wert, um einen Nachweis der Authentisierung bereitzustellen. Erforderlich, wenn Transaction Status = Y oder A. Bedingt basierend auf DS-Regeln, wenn Transaction Status = I.
...
broadInfo
...
string
...
C
...
Unstrukturierte Informationen, die zwischen dem 3DS Server, dem DS und dem ACS gesendet werden. Die Anforderungen für das Vorhandensein dieses Feldes sind DS-spezifisch.
...
cardholderInfo
...
string
...
C
...
Vom ACS/Issuer an den Karteninhaber bereitgestellter Text während einer Reibungslosen oder Entkoppelten Transaktion. Der Issuer kann dem Karteninhaber Informationen übermitteln. Zum Beispiel “Für diese Transaktion ist eine zusätzliche Authentisierung erfoderlich, bitte wenden Sie sich an (Issuer-Name) unter xxx-xxx-xxxx.” Erforderlich, falls der ACS Decoupled Confirmation Indicator = true; anderenfalls optional für den ACS.
...
dsReferenceNumber
...
string
...
M
...
Von EMVCo vergebene eindeutige Kennung zur Nachverfolgung genehmigter DS.
...
dsTransID
...
string
...
M
...
Vom DS vergebene universelle eindeutige Transaktionskennung zur Identifizierung einer Einzeltransaktion.
...
eci
...
string
...
M
...
Zahlungssystemspezifischer vom ACS or DS bereitgestellter Wert, um das Ergebnis des Versuchs zur Authentisierung des Karteninhabers anzugeben. Die Anforderungen für das Vorhandensein dieses Feldes sind DS-spezifisch.
...
messageExtension
...
string
...
C
...
Zur Unterstützung der Anforderungen nötige Daten, die nirgendwo anders in der 3-D Secure Nachricht definiert sind, werden in einer Nachrichten-Erweiterung geführt. Bedingungen sind von jedem DS zu setzen.
...
messageType
...
string
...
M
...
Bestimmt die Art der zu übermittelnden Nachricht.
Zulässige Werte:
AReq
ARes
CReq
CRes
PReq
PRes
RReq
RRes
...
messageVersion
...
string
...
M
...
Kennung der Protokolversion
...
sdkTransID
...
string
...
C
...
Nur App-basiert. Universelle eindeutige Transaktionskennung, die vom 3DS SDK zur Identifikation einer Einzeltransaktion vergeben wird.
...
transStatus
...
string
...
M
...
Zeigt an, ob sich eine Transaktion als eine authentisierte Transaktion qualifiziert.
Zulässige Werte:
Y
= Authentisierungs-Überprüfung erfolgreichN
= Nicht authentisiert /Konto nicht verifiziert; Transaktion abgelehntU
= Authentisierung/ Konto-Verifizierung konnte nicht ausgeführt werden; technisches oder sonstiges Problem, wie in ARes oder RReq angegebenA
= Verarbeitung des Versuchs ausgeführt; Nicht authentisiert/verifiziert, aber ein Nachweis der versuchten Authentisierung/Verifizierung ist gegebenC
= Challenge erforderlich; eine zusätzliche Authentisierung mittels CReq/CRes ist erforderlichD
= Challenge erforderlich; Entkoppelte Authentisierung bestätigtR
= Authentisierung/ Konto-Verifizierung abgelehnt; der Issuer lehnt die Authentisierung/Verifizierung ab und verlangt, dass die Autorisierung nicht versucht wirdI
= Nur zur Information; 3DS Requestor Challenge-Präferenz anerkannt
...
transStatusReason
...
string
...
C
...
Gibt Informationen darüber, warum das Feld des Transaktionsstatus den angegebenen Wert hat. Erforderlich, wenn der Transaktionsstatus = N, U oder R ist.
Zulässige Werte:
01
= Kartenauthentisierung gescheitert02
= Unbekanntes Gerät03
= Nicht unterstütztes Gerät04
= Grenze für Authentisierungshäufigkeit überschritten05
= Abgelaufene Karte06
= Ungültige Kartennummer07
= Ungültige Transaktion08
= Keine Kartendaten09
= Sicherheitsfehler10
= Gestohlene Karte11
= Betrugsverdacht12
= Transaktion für Karteninhaber nicht erlaubt13
= Karteninhaber für den Service nicht angemeldet14
= Zeitüberschreitung der Transaktion am ACS15
= Geringes Vertrauen16
= Mittleres Vertrauen17
= Hohes Vertrauen18
= Sehr hohes Vertrauen19
= Übersteigt das ACS-Maximum der Challenges20
= Zahlungsfremde Transaktion wird nicht unterstützt21
= 3RI-Transaktion wird nicht unterstützt22
= ACS technisches Problem23
= Entkoppelte Authentisierung vom ACS gefordert, aber vom 3DS Requestor nicht angefordert24
= 3DS Requestor Max. Ablaufzeit für Entkopplung überschritten25
= Entkoppelte Authentisierung hatte unzureichene Zeit zur für die Authentisierung des Karteninhabers. ACS macht keinen Versuch26
= Authentisierung versucht, aber vom Karteninhaber nicht ausgeführt
...
whiteListStatus
...
string
...
C
...
Zukünftige Verwendung. Wird erst ab Protokoll-Version 2.2.0 aufwärts unterstützt. Ermöglicht die Übermittelung des Status vertrauenswürdiger Empfänger/Whitelist.
Zulässige Werte:
Y
= 3DS Requestor steht beim Karteninhaber auf der WhitelistN
= 3DS Requestor steht beim Karteninhaber nicht auf der WhitelistE
= Nicht wählbar, wie vom Issuer ermitteltP
= Ausstehende Bestätigung des KarteninhabersR
= Karteninhaber abgelehntU
= Whitelist-Status unbekannt, nicht verfügbar oder nicht zutreffend
...
whiteListStatusSource
...
string
...
C
...
Zukünftige Verwendung. Wird erst ab Protokoll-Version 2.2.0 aufwärts unterstützt. Dieses Datenelement wird vom System ausgefüllt, dass den Whitelist-Status setzt.
Zulässige Werte:
01
= 3DS Server02
= DS03
= ACS
...
...
object
...
C
...
Objekt Challenge-Anfrage im Fall, dass die Authentisierungs-Antwort anzeigt, dass eine weitere Interaktion des Karteninhabers erforderlich ist, um die Authentisierung abzuschließen
...
base64EncodedChallengeRequest
...
string
...
C
...
Base64-codiertes Objekt Herausforderungs-Anfrage im Fall, dass die Authentisierungs-Antwort anzeigt, dass eine weitere Interaktion des Karteninhabers erforderlich ist, um die Authentisierung abzuschließen.
...
threeDSCompInd
...
string
...
M
...
Zeigt an, ob die 3DS-Methode erfolgreich abgeschlossen wurde.
Y
= Erfolgreich abgeschlossenN
= Nicht erfolgreich abgeschlossenU
= Nicht verfügbar - der 3DS Method URL wurde keine Kartenkontonummer übermittelt
Schema
Code Block | ||||
---|---|---|---|---|
| ||||
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://www.computop-paygate.com/schemas/authenticationResponse.json",
"title": "authenticationResponse",
"description": "Authentisierungs-Antwort",
"type": "object",
"properties": {
"threeDSServerTransID": {
"type": "string",
"maxLength": 36
},
"acsChallengeMandated": {
"type": "boolean"
},
"acsDecConInd": {
"type": "boolean"
},
"acsOperatorID": {
"type": "string",
"maxLength": 32
},
"acsReferenceNumber": {
"type": "string",
"maxLength": 32
},
"acsRenderingType": {
"type": "object",
"properties": {
"acsInterface": {
"type": "string",
"enum": ["native", "html", ""],
"description": "ACS-Schnittstelle, die dem Karteninhaber die Challenge zeigt."
},
"acsUiTemplate": {
"type": "string",
"enum": ["text", "singleSelect", "multiSelect", "oob", "other",""],
"description": "Bestimmt das Format der UI-Vorlage, die ACS dem Kunden zuerst zeigt."
}
},
"required": ["acsInterface", "acsUiTemplate"],
"additionalProperties": false
},
"acsSignedContent": {
"type": "string"
},
"acsTransID": {
"type": "string",
"maxLength": 36
},
"acsURL": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"authenticationType": {
"type": "string",
"enum": ["static", "dynamic", "oob", "decoupled", ""]
},
"authenticationValue": {
"type": "string",
"maxLength": 28
},
"broadInfo": {
"type": "string",
"maxLength": 4096
},
"cardholderInfo": {
"type": "string",
"maxLength": 128
},
"dsReferenceNumber": {
"type": "string",
"maxLength": 32
},
"dsTransID": {
"type": "string",
"maxLength": 36
},
"eci": {
"type": "string",
"maxLength": 2
},
"messageExtension": {
"type": "string",
"maxLength": 81920
},
"messageType": {
"type": "string",
"enum": ["ARes"]
},
"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", ""]
},
"whiteListStatus": {
"type": "string",
"enum": ["Y", "N", "E", "P", "R", "U", ""]
},
"whiteListStatusSource": {
"type": "string",
"enum": ["01", "02", "03", ""]
},
"challengeRequest": {
"type": "object",
"properties": {
"threeDSServerTransID": {
"type": "string",
"maxLength": 36
},
"acsTransID": {
"type": "string",
"maxLength": 36
},
"challengeWindowSize": {
"type": "string",
"enum": ["01", "02", "03", "04", "05"]
},
"messageVersion": {
"type": "string",
"minLength": 5,
"maxLength": 8
},
"messageType": {
"type": "string",
"enum": ["CReq"]
}
},
"required": ["threeDSServerTransID", "acsTransID", "challengeWindowSize", "messageVersion", "messageType"],
"additionalProperties": false
},
"base64EncodedChallengeRequest": {
"type": "string"
},
"threeDSCompInd": {
"type": "string",
"enum": ["Y", "N", "U", ""]
}
},
"required": [
"threeDSServerTransID",
"acsChallengeMandated",
"acsOperatorID",
"acsReferenceNumber",
"acsRenderingType",
"acsSignedContent",
"acsTransID",
"acsURL",
"authenticationType",
"authenticationValue",
"broadInfo",
"cardholderInfo",
"dsReferenceNumber",
"dsTransID",
"eci",
"messageExtension",
"messageType",
"messageVersion",
"sdkTransID",
"transStatus",
"transStatusReason",
"whiteListStatus",
"whiteListStatusSource",
"challengeRequest",
"base64EncodedChallengeRequest",
"threeDSCompInd"
],
"additionalProperties": false
} |
Beispiel
Code Block | ||||
---|---|---|---|---|
| ||||
{
"threeDSServerTransID": "d9cf63f3-98ba-4e82-aa39-ca90c68f5262",
"acsChallengeMandated": true,
"acsDecConInd": false,
"acsOperatorID": "visaOperatorId",
"acsReferenceNumber": "3DS_LOA_ACS_NEAG_020100_00055",
"acsRenderingType": {
"acsInterface": "",
"acsUiTemplate": ""
},
"acsSignedContent": "",
"acsTransID": "fa15dced-02b7-4469-9a79-225786a02ae1",
"acsURL": "https://mc-id-check.firstdata.de/challengeRequestBrowser",
"authenticationType": "",
"authenticationValue": "",
"broadInfo": "",
"cardholderInfo": "",
"dsReferenceNumber": "VISA.V 17 0003",
"dsTransID": "a9645de6-52ba-4f79-abaa-f3050b9a5300",
"eci": "",
"messageExtension": "",
"messageType": "ARes",
"messageVersion": "2.1.0",
"sdkTransID": "",
"transStatus": "C",
"transStatusReason": "",
"whiteListStatus": "",
"whiteListStatusSource": "",
"challengeRequest": {
"threeDSServerTransID": "d9cf63f3-98ba-4e82-aa39-ca90c68f5262",
"acsTransID": "fa15dced-02b7-4469-9a79-225786a02ae1",
"challengeWindowSize": "03",
"messageVersion": "2.1.0",
"messageType": "CReq"
},
"base64EncodedChallengeRequest": "eyJtZXNzYWdlVHlwZSI6IkNSZXEiLCJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ImQ5Y2Y2M2YzLTk4YmEtNGU4Mi1hYTM5LWNhOTBjNjhmNTI2MiIsImFjc1RyYW5zSUQiOiJmYTE1ZGNlZC0wMmI3LTQ0NjktOWE3OS0yMjU3ODZhMDJhZTEiLCJjaGFsbGVuZ2VXaW5kb3dTaXplIjoiMDMiLCJtZXNzYWdlVmVyc2lvbiI6IjIuMS4wIn0=",
"threeDSCompInd": ""
} |
...