Create 3DS session from raw values (sandbox)

Create a 3DS session record directly from raw authentication values (ECI, CAVV, etc.). Useful for testing payment flows with specific 3DS data without running the full 3DS challenge. Returns a session ID that can be passed to processPayment.

Requires: org:admin role

POST /api/public/v1/threeds/create-from-values

Create 3DS session from raw values (sandbox)

cURL

curl --request POST \
  --url http://app.localhost:3000/api/public/v1/threeds/create-from-values \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eci": "<string>",
  "authenticationValue": "<string>",
  "transStatus": "Y",
  "dsTransID": "<string>",
  "acsTransID": "<string>",
  "messageVersion": "2.2.0",
  "cardBrand": "<string>"
}
'

default

{
  "message": "<string>",
  "code": "<string>",
  "issues": [
    {
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

eci · string · required

authenticationValue · string · required

CAVV / AAV

transStatus · string · default: Y

dsTransID · string

acsTransID · string

messageVersion · string · default: 2.2.0

cardBrand · string

Response

200

application/json

Successful response