JSON Objekt
threeDSData:request
threeDSData:request
In case you use your own or any other external 3DS Server you must submit the threeDSData object to the 1cs Online Payment System for authorization with the acquirer. This data element is thus only aplicable to server-to-server integrations.
Please contact our helpdesk, if you want to use this function, because a special configuration (‘Use external MPI’) for your MerchantID is necessary.
| Key | Format | Condition | Description |
| acsProtocolVersion | string | M | The protocol version used for authentication. Values accepted: · 1.0.2 · 2.1.0 · 2.2.0 · 2.3.0 |
| authenticationValue | string | C | Payment system specific value to provide proof of authentication. |
| cavvAlgorithm | string | C | 3DS 2.0 only with Cartes Bancaires |
| eci | string | M | Payment system specific Electronic Commerce Indicator. |
| threeDSServerTransID | string | C | 3DS 2.0 only. Universally unique transaction identifier assigned by the 3DS Server. |
| acsXID | string | C | 3DS 1.0 only. ACS assigned transaction ID. |
| dsTransID | string | C | 3DS 2.0 only. Universally unique transaction identifier assigned by the DS to identify a single transaction. |
| 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. |
| 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. |
| challengeRequestInd | string | C | 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 | C | 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 |
| dsScore | string | C | Specifies value for “DS Score”, scoring returned by the CB DS |
| transStatusReason | string | string | Specifies value for “Transaction Status Reason Code” Values accepted: transStatusReason Codes |
Sample
{
“$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”]
}
},
“additionalProperties”: false,
“required”: [“acsProtocolVersion”, “eci”, “intermediateStatus”, “finalStatus”]
}
