All JSON objects

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

}