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


KeyFormatCNDDescription
1

acsProtocolVersion

string

M

The protocol version used for authentication.

Values accepted:

  • 1.0.2

  • 2.1.0

  • 2.2.0

  • 2.3.0

2

authenticationValue

string

C

Payment system specific value to provide proof of authentication

3cavvAlgorithmstringC3DS 2.0 only with Cartes Bancaires
4

eci

string

M

Payment system specific Electronic Commerce Indicator

5

threeDSServerTransID

string

C

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

6

acsXID

string

C

3DS 1.0 only. ACS assigned transaction ID.

7

dsTransID

string

C

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

8

intermediateStatus

string

C

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

finalStatus

string

C

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.
10challengeRequestIndstringC

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

Specifies value for "Challenge Cancellation Indicator"

Values accepted:

  • 01 = Cardholder selected “Cancel”
  • 02 = 3DS Requestor cancelled Authentication.
  • 03 = Transaction Abandoned
  • 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
12dsScorestringCSpecifies value for "DS Score", scoring returned by the CB DS
13transStatusReason stringC

Specifies value for "Transaction Status Reason Code"

Values accepted: transStatusReason Codes


Schema

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

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://www.computop-paygate.com/schemas/threeDSDataReq.json",
  "title": "External 3DS Data",
  "description": "External 3DS Data",
  "type": "object",
  "properties": {
    "acsProtocolVersion": {
      "type": "string",
      "enum": [
        "1.0.2",
        "2.1.0",
        "2.2.0",
        "2.3.0"
      ]
    },
    "authenticationValue": {
      "type": "string",
      "maxLength": 28
    },
    "eci": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "threeDSServerTransID": {
      "type": "string",
      "maxLength": 36
    },
    "acsXID": {
      "type": "string",
      "maxLength": 40
    },
    "dsTransID": {
      "type": "string",
      "maxLength": 36
    },
    "intermediateStatus": {
      "type": "string",
      "enum": [
        "Y",
        "N",
        "U",
        "A",
        "C",
        "D",
        "R",
        "I"
      ]
    },
    "finalStatus": {
      "type": "string",
      "enum": [
        "Y",
        "U",
        "A"
      ]
    },
    "dsScore": {
      "type": "string",
      "maxLength": 5
    },
    "transStatusReasonInd": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "challengeCancelInd": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "challengeRequestInd": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    }
  },
  "additionalProperties": false,
  "required": [
    "acsProtocolVersion",
    "eci",
    "intermediateStatus",
    "finalStatus"
  ]
}