Create 3DS2 Setup

Register the 3D Secure 2 setup data your integration has collected — the cardholder's browser environment and any pre-computed device fingerprints — and receive a three_d_secure_setup_id to reference on the subsequent POST /v1/payments.

Request body

account_idstring uuid required

Account UUID that owns this 3DS2 setup.

type'MERCHANT_PROVIDED' required

Source of the device data. MERCHANT_PROVIDED means you collected the browser/device data on your side and are passing it in directly.

Response

201

three_d_secure_setup_idstring

Generated identifier of the 3DS2 setup. Pass this under payment_method.detail.card.three_d_secure.three_d_secure_setup_id on the subsequent POST /v1/payments.

account_idstring

Echo of the request account_id.

typestring

Echo of the request type.

Example response

{
  "three_d_secure_setup_id": "a17b4f2c-08d1-4e9b-b6c5-9a3e0c7f1b22",
  "account_id": "11111111-1111-1111-1111-111111111111",
  "type": "MERCHANT_PROVIDED",
  "browser_info": {
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
    "accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9",
    "color_depth": "24",
    "screen_height": "1080",
    "screen_width": "1920",
    "language": "es-CO",
    "javascript_enabled": true,
    "browser_time_difference": "-300",
    "platform": "WEB"
  },
  "device_fingerprints": [
    {
      "provider_id": "f3a8b5d2-9c4e-4a7b-b1f8-2d6c9e0a4f12",
      "id": "fp_abc123xyz"
    }
  ]
}