Skip to main content
id
string<uuid>
required

Unique 3DS authentication ID

Example:

"baf6a8e2-0c89-46ef-9ca5-faa65b99bcd5"

merchant_id
string<uuid>
required

Merchant ID

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

instrument_id
string<uuid>
required

Instrument ID

Example:

"baf6a8e2-0c89-46ef-9ca5-faa65b99bcd5"

status
required

Authentication session has been created and is awaiting processing

Allowed value: "PENDING"
Example:

"AUTHENTICATED"

authentication_value
string

Authentication value (CAVV)

Example:

"AAABBJkZUgAAAAAAAAAAAAAAAAA="

eci
string

Electronic Commerce Indicator

Required string length: 2
Example:

"05"

xid
string

Transaction identifier (XID)

Required string length: 1 - 100
Example:

"abc123xyz"

version
string

3DS protocol version

Pattern: ^\d+\.\d+\.\d+$
Example:

"2.1.0"

threeds_server_trans_id
string

3DS Server transaction ID

Example:

"threeds_a1b2c3d4e5f6"

ds_transaction_id
string

Directory Server transaction ID

Example:

"dstxn_a1b2c3d4e5f6"

acs_transaction_id
string

ACS transaction ID

Example:

"acstxn_a1b2c3d4e5f6"

acs_reference_number
string

ACS reference number

Required string length: 1 - 32
Example:

"ELAVON_ACS_EMULATOR_REF_NUMBER32"

ds_reference_number
string

Directory Server reference number

Required string length: 1 - 32
Example:

"ELAVON_3DS_DS_EMULATOR_REF_NUM32"

acs_operator_id
string

ACS operator ID

Required string length: 1 - 32
Example:

"ELAVON_ACS_EMULATOR_OPERATOR_ID1"

acs_challenge_mandated

Challenge is mandated

Allowed value: "Y"
Example:

"Y"

acs_authentication_type
string

ACS authentication type code

Required string length: 2 - 10
Example:

"01"

acs_challenge_cancel_reason
string

Challenge cancel reason code

Example:

"01"

trans_status
string

Transaction status code

Pattern: ^[A-Z]$
Example:

"C"

trans_status_reason
string

Transaction status reason

Example:

"01"

return_url
string

Return URL for 3DS challenge

Example:

"https://example.com/threeds/callback"