threeDSData:request | Computop Documents

In case you use your own or any other external 3DS Server you must submit the threeDSData object to Computop Paygate for authorization with the acquirer. This data element is thus only aplicable to server-to-server integrations.

Data Elements

Key

Format

CND

Description

acsProtocolVersion

string

The protocol version used for authentication.

Values accepted:

1.0.2
2.1.0
2.2.0
2.3.0

authenticationValue

string

Payment system specific value to provide proof of authentication

cavvAlgorithm

string

3DS 2.0 only with Cartes Bancaires

eci

string

Payment system specific Electronic Commerce Indicator

threeDSServerTransID

string

3DS 2.0 only. Universally unique transaction identifier assigned by the 3DS Server.

acsXID

string

3DS 1.0 only. ACS assigned transaction ID.

dsTransID

string

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

intermediateStatus

string

This is the transaction status transStatus from the Authentication Response (ARes).

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.
I = Informational Only; 3DS Requestor challenge preference acknowledged.

finalStatus

string

This is the transaction status transStatus from the Result Request (RReq).

Values accepted:

Y = Authentication Verification Successful.
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.

challengeRequestInd

string

Specifies value for "3DS Requestor Challenge Indicator"

Values accepted:

01 = No preference – default value if the data element is absent or not set to a value
02 = No authentication
03 = Authentication requested
04 = Authentication required
05 = No authentication: transaction risk analysis already performed
06 = No authentication: data share only
07 = No authentication: SCA already performed
08 = No authentication: whitelist
09 = Authentication required

challengeCancelInd

string

Specifies value for "Challenge Cancellation Indicator"

Values accepted:

01= Cardholder selected “Cancel”
02= 3DS RequestorcancelledAuthentication.
03 = TransactionAbandoned
04 = TransactionTimed Out at ACS—other timeouts
05 = TransactionTimed Out at ACS—First CReq notreceived by ACS
06= Transaction Error
07= Unknown

dsScore

string

Specifies value for "DS Score", scoring returned by the CB DS

transStatusReason

string

Specifies value for "Transaction Status Reason Code"

Values accepted: transStatusReason Codes

Schema

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

1
{
2
  "$schema": "http://json-schema.org/draft-07/schema#",
3
  "$id": "https://www.computop-paygate.com/schemas/threeDSDataReq.json",
4
  "title": "External 3DS Data",
5
  "description": "External 3DS Data",
6
  "type": "object",
7
  "properties": {
8
    "acsProtocolVersion": {
9
      "type": "string",
10
      "enum": [
11
        "1.0.2",
12
        "2.1.0",
13
        "2.2.0",
14
        "2.3.0"
15
      ]
16
    },
17
    "authenticationValue": {
18
      "type": "string",
19
      "maxLength": 28
20
    },
21
    "eci": {
22
      "type": "string",
23
      "minLength": 2,
24
      "maxLength": 2
25
    },
26
    "threeDSServerTransID": {
27
      "type": "string",
28
      "maxLength": 36
29
    },
30
    "acsXID": {
31
      "type": "string",
32
      "maxLength": 40
33
    },
34
    "dsTransID": {
35
      "type": "string",
36
      "maxLength": 36
37
    },
38
    "intermediateStatus": {
39
      "type": "string",
40
      "enum": [
41
        "Y",
42
        "N",
43
        "U",
44
        "A",
45
        "C",
46
        "D",
47
        "R",
48
        "I"
49
      ]
50
    },
51
    "finalStatus": {
52
      "type": "string",
53
      "enum": [
54
        "Y",
55
        "U",
56
        "A"
57
      ]
58
    },
59
    "dsScore": {
60
      "type": "string",
61
      "maxLength": 5
62
    },
63
    "transStatusReasonInd": {
64
      "type": "string",
65
      "minLength": 2,
66
      "maxLength": 2
67
    },
68
    "challengeCancelInd": {
69
      "type": "string",
70
      "minLength": 2,
71
      "maxLength": 2
72
    },
73
    "challengeRequestInd": {
74
      "type": "string",
75
      "minLength": 2,
76
      "maxLength": 2
77
    }
78
  },
79
  "additionalProperties": false,
80
  "required": [
81
    "acsProtocolVersion",
82
    "eci",
83
    "intermediateStatus",
84
    "finalStatus"
85
  ]
86
}