Create 3RI (merchant-initiated) 3DS session

Create a server-side 3DS session for merchant-initiated (3RI) authentication. No browser or device info needed — uses just the card token. Used for recurring rebill authentication without cardholder interaction.

Requires: org:admin role

POST /api/public/v1/threeds/create-merchant-session

Create 3RI (merchant-initiated) 3DS session

cURL

curl --request POST \
  --url https://api.tagada.io/api/public/v1/threeds/create-merchant-session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tokenId": "<string>",
  "paymentInstrumentId": "<string>",
  "storeId": "<string>"
}
'

default

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

Authorizations

Authorization · string · header · required

Enter your API key as: Bearer your-api-key

Body

application/json

tokenId · string · required

BasisTheory card token ID

paymentInstrumentId · string · required

storeId · string · required

Response

200

application/json

Successful response