challengeRequest | Computop Documents

Das Objekt challengeRequest ist nur für Server-zu-Server-Implementierungen relevant. Es ist Teil des Objekts authenticationResponse und nur vorhanden, wenn eine Challenge für nötig angesehen ist.

Datenelemente

Key

Format

CND

Beschreibung

threeDSServerTransID

string

Computop Paygate PayID im kanonischen Format gemäß IETF RFC 4122

acsTransID

string

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

messageType

string

Identifiziert den Nachrichten-Typ.

Zulässige Werte:

CReq

messageVersion

string

Kennung der Protokollversion

challengeWindowSize

string

Abmessungen des Challenge-Fensters, das dem Karteninhaber angezeigt wird. Der ACS soll mit so formatiertem Inhalt antworten, dass dieser richtig in diesem Fenster wiedergegeben werden kann, um ein bestmögliches Nutzererlebnis zu schaffen.

Vorkonfigurierte Größen gelten für Breite x Höhe in Pixeln für das im Browserfenster des Karteninhabers angezeigte Fenster.

Zulässige Werte:

01 = 250 x 400
02 = 390 x 400
03 = 500 x 600
04 = 600 x 400
05 = Full screen

Das Paygate bestimmt die beste Fenstergröße für Server-zu-Server-Anfragen gemäß browserInfo.

messageExtension

object

In einer Nachrichten-Erweiterung werden nötige Daten zur Unterstützung der Anforderungen transportiert, die nicht anderweitig in der 3-D Secure Nachricht definiert sind.

Schema

BASEURL= https://www.computop-paygate.com/schemas

1
{
2
    "$schema": "http://json-schema.org/draft-07/schema#",
3
    "$id": "BASEURL/challengeRequest.json",
4
    "title": "Challenge Request",
5
    "description": "Challenge Request Data Elements",
6
    "type": "object",
7
    "properties": {
8
		"threeDSServerTransID": {
9
			"type": "string",
10
			"maxLength": 36
11
		},
12
		"acsTransID": {
13
			"type": "string",
14
			"maxLength": 36
15
		},
16
		"messageType": {
17
			"type": "string",
18
			"enum": ["CReq"]
19
		},
20
		"messageVersion": {
21
			"type": "string",
22
			"minLength": 5,
23
			"maxLength": 8
24
		},
25
		"challengeWindowSize": {
26
			"type": "string",
27
			"enum": ["01", "02", "03", "04", "05"]
28
		},
29
		"messageExtension": {
30
			"type": "array",
31
			"items": {
32
				"type": "object"
33
			}
34
		}
35
	}				
36
}

Beispiel

1
{
2
    "threeDSServerTransID": "8a880dc0-d2d2-4067-bcb1-b08d1690b26e",
3
    "acsTransID": "d7c1ee99-9478-44a6-b1f2-391e29c6b340",
4
    "messageType": "CReq",
5
    "messageVersion": "2.1.0",
6
    "challengeWindowSize": "01",
7
    "messageExtension": [
8
		{
9
			"name": "emvcomsgextInChallenge",
10
			"id": "tc8Qtm465Ln1FX0nZprA",
11
			"criticalityIndicator": false,
12
			"data": "messageExtensionDataInChallenge"
13
		}
14
    ]
15
}