In case you use your own or any other external 3DS Server you must submit the threeDSData object to BNP Payment platform 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.



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

3

eci

string

M

Payment system specific Electronic Commerce Indicator.

4

threeDSServerTransID

string

C

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

5

acsXID

string

C

3DS 1.0 only. ACS assigned transaction ID.

6

dsTransID

string

C

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

7

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

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.

Schema

{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"$id": "https://paymentpage.axepta.bnpparibas/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", "I"]
		},
		"finalStatus": {
			"type": "string",
			"enum":  ["Y", "U", "A"]
		}
	},
	"additionalProperties": false,
	"required": ["acsProtocolVersion", "eci"]	
}




  • No labels