The authenticationResponse object is part of the Authentication Notification sent from Cockpit to the merchant server. It is only applicable to Server-to-Server integrations.

Please note that all data elements listed below will be present in authenticationResponse but might hold an empty string based on the condition.

Data Elements

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...


KeyFormatCNDDescriptionBeschreibung
1

threeDSServerTransID

string

M

Pay-Jet Cockpit PayID in canonical format as specified in IETF RFC 4122.

Pay-Jet Cockpit PayID im kanonischen Format gemäß IETF RFC 4122

2

acsChallengeMandated

boolean

M

Indication of whether a challenge is required for the transaction to be authorised due to local/regional mandates or other variable:

  • true → Challenge is mandated by local/regional regulations
  • false → Challenge is not mandated by local/regional regulations, but is deemed necessary by the ACS

Zeigt an, on eine Challenge für die Autorisierung einer Transaktion wegen lokaler/regionaler Vorschriften oder anderer Variablen nötig ist:

  • true → Challenge ist obligatorisch wegen lokaler/regional Vorschriften
  • false → Challenge ist nicht obligatorisch wegen lokaler/regional Vorschriften, wird aber von ACS als nötig angesehen
3

acsDecConInd

boolean

C

Indicates whether the ACS confirms utilisation of Decoupled Authentication and agrees to utilise Decoupled Authentication to authenticate the cardholder. Required if Transaction Status = D.

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.
4

acsOperatorID

string

C

DS assigned ACS identifier. Each DS can provide a unique ID to each ACS on an individual basis. Requirements for the presence of this field are DS specific.

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.
5

acsReferenceNumber

string

M

Unique identifier assigned by the EMVCo Secretariat upon Testing and Approval.

Vom EMVCo-Sekretariat nach Prüfung und Zulassung zugeordnete eindeutige Kennung
6

acsRenderingType

object

C

App-based only. Identifies the ACS UI Template that the ACS will first present to the consumer. Required if Transaction Status = C.

Nur App-basiert. Identifiziert die ACS UI-Vorlage, die der ACS zuerst dem Kunden zeigen wird. Erforderlich, wenn Transaction Status = C.
7

acsSignedContent

string

C

App-based only. Contains the JWS object (represented as a string) created by the ACS for the ARes message. Required if the Transaction Status = 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.
8

acsTransID

string

M

Universally Unique transaction identifier assigned by the ACS to identify a single transaction

Universelle eindeutige Transaktionskennung, die vom ACS zur Identifikation einer Einzeltransaktion vergeben wird
9

acsURL

string

C

Fully qualified URL of the ACS to be used to post the Challenge Request. For App-based, this data element is contained within the ACS Signed Content JWS Object. Required if Transaction Status = 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.
10

authenticationType

string

C

Indicates the type of authentication method the Issuer will use to challenge the cardholder. Required if the Transaction Status = C or D.

Values accepted:

  • 01 = static

  • 02 = dynamic

  • 03 = oob

Future implementation. Protocol Version 2.2.0 onwards -

  • 04 = decoupled

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

11

authenticationValue

string

C

Payment System-specific value provided by the ACS or the DS to provide proof of authentication. Required if Transaction Status = Y or A. Conditional based on DS rules if Transaction Status = I.

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.
12

broadInfo

string

C

Unstructured information sent between the 3DS Server, the DS and the ACS. Requirements for the presence of this field are DS specific.

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.
13

cardholderInfo

string

C

Text provided by the ACS/Issuer to Cardholder during a Frictionless or Decoupled transaction. The Issuer can provide information to Cardholder. For example, “Additional authentication is needed for this transaction, please contact (Issuer Name) at xxx-xxx-xxxx.” Required if ACS Decoupled Confirmation Indicator = true Otherwise, Optional for the ACS.

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.
14

dsReferenceNumber

string

M

EMVCo-assigned unique identifier to track approved DS.

Von EMVCo vergebene eindeutige Kennung zur Nachverfolgung genehmigter DS
15

dsTransID

string

M

Universally unique transaction identifier assigned by the DS to identify a single transaction.

Vom DS vergebene universelle eindeutige Transaktionskennung zur Identifizierung einer Einzeltransaktion
16

eci

string

M

Payment System-specific value provided by the ACS or DS to indicate the results of the attempt to authenticate the Cardholder. The requirements for the presence of this field are DS specific.

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.
17

messageExtension

string

C

Data necessary to support requirements not otherwise defined in the 3-D Secure message are carried in a Message Extension. Conditions to be set by each DS.

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.
18

messageType

string

M

Identifies the type of message that is passed.

Values accepted:

  • AReq

  • ARes

  • CReq

  • CRes

  • PReq

  • PRes

  • RReq

  • RRes

Bestimmt die Art der zu übermittelnden Nachricht.

Zulässige Werte:

  • AReq

  • ARes

  • CReq

  • CRes

  • PReq

  • PRes

  • RReq

  • RRes

19

messageVersion

string

M

Protocol version identifier.

Kennung der Protokollversion
20

sdkTransID

string

C

App-based only. Universally unique transaction identifier assigned by the 3DS SDK to identify a single transaction.

Nur App-basiert. Universelle eindeutige Transaktionskennung, die vom 3DS SDK zur Identifikation einer Einzeltransaktion vergeben wird.
21

transStatus

string

M

Indicates whether a transaction qualifies as an authenticated transaction.

Values accepted:

  • Y = Authentication Verification Successful.

  • N = Not Authenticated /Account Not Verified; Transaction denied.

  • U = Authentication/ Account Verification Could Not Be Performed; Technical or other problem, as indicated in ARes or RReq.

  • A = Attempts Processing Performed; Not Authenticated/Verified, but a proof of attempted authentication/verification is provided.

  • C = Challenge Required; Additional authentication is required using the CReq/CRes.

  • D = Challenge Required; Decoupled Authentication confirmed.

  • R = Authentication/ Account Verification Rejected; Issuer is rejecting authentication/verification and request that authorisation not be attempted.

  • I = Informational Only; 3DS Requestor challenge preference acknowledged.

Zeigt an, ob sich eine Transaktion als eine authentisierte Transaktion qualifiziert.

Zulässige Werte:

  • Y = Authentisierungs-Überprüfung erfolgreich

  • N = Nicht authentisiert /Konto nicht verifiziert; Transaktion abgelehnt

  • U = Authentisierung/ Konto-Verifizierung konnte nicht ausgeführt werden; technisches oder sonstiges Problem, wie in ARes oder RReq angegeben

  • A = Verarbeitung des Versuchs ausgeführt; Nicht authentisiert/verifiziert, aber ein Nachweis der versuchten Authentisierung/Verifizierung ist gegeben

  • C = Challenge erforderlich; eine zusätzliche Authentisierung mittels CReq/CRes ist erforderlich

  • D = Challenge erforderlich; Entkoppelte Authentisierung bestätigt

  • R = Authentisierung/ Konto-Verifizierung abgelehnt; der Issuer lehnt die Authentisierung/Verifizierung ab und verlangt, dass die Autorisierung nicht versucht wird

  • I = Nur zur Information; 3DS Requestor Challenge-Präferenz anerkannt

22

transStatusReason

string

C

Provides information on why the Transaction Status field has the specified value. Required if the Transaction Status field = N, U, or R.

Values accepted:

  • 01 = Card authentication failed

  • 02 = Unknown Device

  • 03 = Unsupported Device

  • 04 = Exceeds authentication frequency limit

  • 05 = Expired card

  • 06 = Invalid card number

  • 07 = Invalid transaction

  • 08 = No Card record

  • 09 = Security failure

  • 10 = Stolen card

  • 11 = Suspected fraud

  • 12 = Transaction not permitted to cardholder

  • 13 = Cardholder not enrolled in service

  • 14 = Transaction timed out at the ACS

  • 15 = Low confidence

  • 16 = Medium confidence

  • 17 = High confidence

  • 18 = Very High confidence

  • 19 = Exceeds ACS maximum challenges

  • 20 = Non-Payment transaction not supported

  • 21 = 3RI transaction not supported

  • 22 = ACS technical issue

  • 23 = Decoupled Authentication required by ACS but not requested by 3DS Requestor

  • 24 = 3DS Requestor Decoupled Max Expiry Time exceeded

  • 25 = Decoupled Authentication was provided insufficient time to authenticate cardholder. ACS will not make attempt

  • 26 = Authentication attempted but not performed by the cardholder

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 gescheitert

  • 02 = Unbekanntes Gerät

  • 03 = Nicht unterstütztes Gerät

  • 04 = Grenze für Authentisierungshäufigkeit überschritten

  • 05 = Abgelaufene Karte

  • 06 = Ungültige Kartennummer

  • 07 = Ungültige Transaktion

  • 08 = Keine Kartendaten

  • 09 = Sicherheitsfehler

  • 10 = Gestohlene Karte

  • 11 = Betrugsverdacht

  • 12 = Transaktion für Karteninhaber nicht erlaubt

  • 13 = Karteninhaber für den Service nicht angemeldet

  • 14 = Zeitüberschreitung der Transaktion am ACS

  • 15 = Geringes Vertrauen

  • 16 = Mittleres Vertrauen

  • 17 = Hohes Vertrauen

  • 18 = Sehr hohes Vertrauen

  • 19 = Übersteigt das ACS-Maximum der Challenges

  • 20 = Zahlungsfremde Transaktion wird nicht unterstützt

  • 21 = 3RI-Transaktion wird nicht unterstützt

  • 22 = ACS technisches Problem

  • 23 = Entkoppelte Authentisierung vom ACS gefordert, aber vom 3DS Requestor nicht angefordert

  • 24 = 3DS Requestor Max. Ablaufzeit für Entkopplung überschritten

  • 25 = Entkoppelte Authentisierung hatte unzureichene Zeit zur für die Authentisierung des Karteninhabers. ACS macht keinen Versuch

  • 26 = Authentisierung versucht, aber vom Karteninhaber nicht ausgeführt

23

whiteListStatus

string

C

Future use. Only supported with protocol version 2.2.0 onwards. Enables the communication of trusted beneficiary/whitelist status.

Values accepted:

  • Y = 3DS Requestor is whitelisted by cardholder

  • N = 3DS Requestor is not whitelisted by cardholder

  • E = Not eligible as determined by issuer

  • P = Pending confirmation by cardholder

  • R = Cardholder rejected

  • U = Whitelist status unknown, unavailable, or does not apply

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 Whitelist

  • N = 3DS Requestor steht beim Karteninhaber nicht auf der Whitelist

  • E = Nicht wählbar, wie vom Issuer ermittelt

  • P = Ausstehende Bestätigung des Karteninhabers

  • R = Karteninhaber abgelehnt

  • U = Whitelist-Status unbekannt, nicht verfügbar oder nicht zutreffend

24

whiteListStatusSource

string

C

Future use. Only supported with protocol version 2.2.0 onwards. This data element will be populated by the system setting Whitelist Status.

Values accepted:

  • 01 = 3DS Server

  • 02 = DS

  • 03 = ACS

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 Server

  • 02 = DS

  • 03 = ACS

25

challengeRequest

object

C

Challenge request object in case the authentication response message indicates that further cardholder interaction is required to complete the authentication.

Objekt Challenge-Anfrage im Fall, dass die Authentisierungs-Antwort anzeigt, dass eine weitere Interaktion des Karteninhabers erforderlich ist, um die Authentisierung abzuschließen
26

base64EncodedChallengeRequest

string

C

Base64-encoded Challenge Request object in case the authentication response message indicates that further cardholder interaction is required to complete the authentication.

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.
27

threeDSCompInd

string

M

Indicates whether the 3DS Method successfully completed.

  • Y = Successfully completed

  • N = Did not successfully complete

  • U = Unavailable - 3DS Method URL was not present the card account number

Zeigt an, ob die 3DS-Methode erfolgreich abgeschlossen wurde.

  • Y = Erfolgreich abgeschlossen

  • N = Nicht erfolgreich abgeschlossen

  • U = Nicht verfügbar - der 3DS Method URL wurde keine Kartenkontonummer übermittelt

Schema

(info) BASEURL= https://www.payjet-cockpit.de/schemas

{
    "$schema": "http://json-schema.org/draft-07/schema#",
	"$id": "BASEURL/authenticationResponse.json",
    "title": "authenticationResponse",
    "description": "Authentication Response",
    "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": "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
        },
        "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
}

Sample

{
	"threeDSServerTransID": "d9cf63f3-98ba-4e82-aa39-ca90c68f5262",
	"acsChallengeMandated": false,
	"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": ""
}