---
title: "3D Secure Initialize"
method: POST
path: "/v2/clients/{ClientID}/3ds/init"
tags: ["3D Secure"]
---

# 3D Secure Initialize

`POST /v2/clients/{ClientID}/3ds/init`

Initializes a 3D Secure Card Authentication Request. 

Request to enable at [TabaPay Support](https://tabapay.zendesk.com/hc/en-us/requests/new#/) or [help@tabapay.com](mailto:help@tabapay.com)

## Path parameters

- `ClientID` string, required

## Request body

- 3dsinit
  - `sdkVersion` string — This is for mobile SDK flows (if you use this, you do not need to pass in AccountID, but you have to use lookup.sdkSessionID).
  - `account` object — Account Details
    - `accountID` string — <<glossary:Account ID>> 22 characters. Exclusively use `accountID` field or `card` object to input card information. Incompatible with the `card` object.
    - `card` object — Payment Card Data. Incompatible with `accountID`. Exclusively use: `card` *OR* `accountID`.
      - `accountNumber` string — <<glossary:Payment Card Not Encrypted>> A Primary Account Number (PAN/Card Number) Not compatible with `accountID`.
  - `order` object, required — Order
    - `orderID` string, uuid, required — 1-50 characters
    - `currency` string — [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 3-Digit [Currency Code](https://developers.tabapay.com/reference/currency-numbers#/). *Optional. Default is `840`*
    - `amount` string, required — See how to [properly format an amount](/reference/data#how-to-specify-an-amount-value).

## Response `200`

A JWT is Created.

- 3dsInitResponse
  - `SC` integer — [HTTP Status Code](https://developers.tabapay.com/reference/http-status-codes#/)
  - `EC` string — Internal Error Code. This is used to help TabaPay team members trace an error.
  - `EM` string — Short description of the error if an error occurred.
  - `3dsID` string — 3dsID returned from [3dsinit](https://developers.tabapay.com/reference/3dsinit#/)
  - `jwt` string — [JWT](https://jwt.io)
  - `deviceCollectionURL` string — URL for Device Data Collection. See [3DS FAQ](https://developers.tabapay.com/reference/device-data-collection#/) for details on how to use this value.

## Other responses

- `207` — One or more Failures occurred while processing the Request.
- `404` — The AccountID does not point to a valid Account.

---

[API](https://skmtc.dev/tabapay/apis/tabapay-apis.md) · [All operations](https://skmtc.dev/tabapay/apis/tabapay-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tabapay/tabapay-apis/revisions/154fa3d585cf/schema)