Data Elements

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

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

acsTransID

string

M

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

Vom ACS vergebene universelle, eindeutige Transaktions-ID zur Identifikation einer Einzeltransaktion
3

acsRenderingType

object

C

Required unless ACS Decoupled Confirmation = true

Erforderlich, sofern nicht ACS Entkoppelte Bestätigung = true
4

authenticationType

string

C

Required if the Transaction Status = Y or N.

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

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

5

authenticationValue

string

C

Required if Transaction Status = Y or A

Erforderlich, wenn Transaktionsstatus = Y oder A
6

challengeCancel

string

C

Indicator informing that the authentication has been canceled.

Values accepted:

  • 01 = Cardholder selected “Cancel”

  • 02 = Reserved for future EMVCo use (values invalid until defined by EMVCo).

  • 03 = Transaction Timed Out—Decoupled Authentication

  • 04 = Transaction Timed Out at ACS—other timeouts

  • 05 = Transaction Timed Out at ACS—First CReq not received by ACS

  • 06 = Transaction Error

  • 07 = Unknown

  • 08 = Transaction Timed Out at SDK

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

7

dsTransID

string

M

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

Vom DS vergebene universelle, eindeutige Transaktions-ID zur Identifikation einer Einzeltransaktion
8

eci

string

C

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.

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

interactionCounter

string

M

Indicates the number of authentication cycles attempted by the Cardholder.

Gibt die Anzahl der durch den Karteninhaber versuchten Authentisierungs-Zyklen an
10

messageCategory

string

M

Identifies the category of the message for a specific use case.

Values accepted:

  • 01 = PA

  • 02 = NPA

Identifiziert die Kategorie der Nachricht für einen bestimmten Anwendungsfall.

Zulässige Werte:

  • 01 = PA

  • 02 = NPA

11

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.

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

messageType

string

C

Identifies the type of message that failed in case of an error.

Values accepted:

  • ARes

  • RReq

Identifiziert die Art der gescheiterten Nachricht im Fehlerfall.

Zulässige Werte:

  • ARes

  • RReq

13

messageVersion

string

M

Protocol version identifier

Kennung für die Protokollversion
14

sdkTransID

string

M

Future use. Universally unique transaction identifier assigned by the 3DS SDK to identify a single transaction.

Zukünftige Verwendung. Vom 3DS SDK vergebene universelle, eindeutige Transaktion-ID zur Identifikation einer Einzeltransaktion.
15

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.

Gibt 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/ 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 erforderlich; zusätzliche Authentisierung mittels CReq/CRes ist erforderlich

  • D = Challenge erforderlich; 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

16

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

17

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

18

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 (3-D Server)

  • 02 = DS (Directory Server)

  • 03 = ACS (Access Control Server)

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 (3-D Server)

  • 02 = DS (Directory Server)

  • 03 = ACS (Access Control Server)

19dsScorestringODirectory Server (scheme) scoring result of the transaction during authentication. Format and value are DS specific.Scoring-Ergebnis des Directory Server (Scheme) der Transaktion während der Authentifizierung. Format und Wert sind DS-spezifisch.
20challengeRequestIndstringO

Merchant Challenge preference indicator, corresponding to "3DS Requestor Challenge Indicator" data element of EMVCo 3D-Secure v2.x specifications.

Allowed values as per EMVCo 3D-Secure latest specifications: 2-digit value, 01-99

  • 01 = No preference
  • 02 = No challenge requested
  • 03 = Challenge requested (3DS Requestor preference)
  • 04 = Challenge requested (Mandate) 
  • 05 = No challenge requested (transactional risk analysis is already performed)
  • 06 = No challengerequested (Data share only)
  • 07 = No challenge requested (strong consumer authentication is already performed)
  • 08 = No challenge requested (utilise whitelist exemption if no challenge required)
  • 09 = Challenge requested (whitelist prompt requested if challenge required)
  • 1079 = Reserved for EMVCo future use (values invalid until defined by EMVCo)
  • 80–99 = Reserved for DS use

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
21cardholderInfostringCText 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.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

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

{
    "$schema": "http://json-schema.org/draft-07/schema#",
	"$id": "BASEURL/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": "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
        },
		"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", ""]
        },
        "dsScore": {
            "type": "string",
            "maxLength": 5
        },
        "challengeRequestInd": {
            "type": "string",
            "maxLength": 2
        },
        "cardholderInfo": {
            "type": "string",
            "maxLength": 128
        }
	},
	"required": ["threeDSServerTransID", "acsTransID", "acsRenderingType", "authenticationType", "authenticationValue", "challengeCancel", "dsTransID", "eci", "interactionCounter", "messageCategory", "messageExtension", "messageVersion", "sdkTransID", "transStatus", "transStatusReason"],
	"additionalProperties": false
}

Sample

{
	"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":""
}
{
    "threeDSServerTransID": "cb32a8d4-e926-41c5-845a-eac09ebe6078",
    "acsTransID": "969c85cf-a34f-4174-a28d-629c75c3ba0b",
    "acsRenderingType": {
        "acsInterface": "",
        "acsUiTemplate": ""
    },
    "authenticationValue": "",
    "dsTransID": "48daf772-ab82-4124-b5b5-af78e6afe880",
    "eci": "00",
    "messageCategory": "01",
    "messageExtension": "[{\"name\":\"ACS Data\",\"id\":\"A000000004-acsData\",\"criticalityIndicator\":false,\"data\":{\"A000000004-acsData\":{\"whitelistStatus\":\"E\"}}}]",
    "messageVersion": "2.1.0",
    "sdkTransID": "",
    "transStatus": "R",
    "transStatusReason": "12",
    "cardholderInfo": "Ihre Karte ist nicht für 3-D Secure registriert. Bitte registrieren Sie Ihre Karte über das Registrierungsportal Ihrer Bank."
}