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

# 3D Secure Authenticate

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

3D Secure Card Authentication Request.

## Path parameters

- `ClientID` string, required

## Request body

- 3dsauthenticate
  - `3dsID` string, required — 3dsID returned from [3dsinit](https://developers.tabapay.com/reference/3dsinit#/)
  - `jwt` string, required — [JSON Web Token](https://en.wikipedia.org/wiki/JSON_Web_Token)

## Response `200`

An Authenticate Response is returned.

- 3dsAuthenticateResponse
  - `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.
  - `actionCode` string — [Result](/reference/3ds-challenge-results) of the 3DS transaction attempt - SUCCESS - CANCEL - ERROR - FAILURE - NOACTION - TIMEOUT
  - `errorNumber` string — Listed error number
  - `errorDescription` string — Description of the listed actionCode error and errorNumber
  - `3dsVersion` string — The 3D Secure Version that was used to process this request. Expected values are of the form: `2.X.X`
  - `processorTransactionID` string — Processor Transaction Identifier
  - `status` string — Transaction Status Result Possible Values: - `Y` Successful Authentication - `N` Failed Authentication - `U` Unable to Complete Authentication - `A` Successful Attempts Transaction - `R` Authentication Rejected - `I` Informational Only; 3DS Requester challenge preference acknowledged
  - `ECI` string — Electronic Commerce Indicator Possible Values: - `00` - `01` - `02` - `04` - `05` - `06` - `07`
  - `UCAF` string — Universal Cardholder Authentication Field [Visa](/docs/visa-cavv-results-code#/) uses <<glossary:CAVV>> (Cardholder Authentication Verification Value) [MasterCard](/docs/mastercard-ucaf-collection-downgrade-indicator#/) uses AAV (Account-Holder Authentication Value)
  - `XID` string — XID (Transaction ID)

---

[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)