v1

latestOpenAPI 3.0.0All rights reserved2026-07-2439128156.3 KB

3D Secure

3D Secure Authenticate

3D Secure Card Authentication Request.

post/v2/clients/{ClientID}/3ds/authenticate

Path parameters

ClientIDstring required

22-character <glossary:ClientID>. Ask TabaPay Support if you need to specify a <glossary:SubClientID>.

Request body

3dsIDstring required

3dsID returned from 3dsinit

jwtstring required

JSON Web Token

Response

An Authenticate Response is returned.

SCinteger

HTTP Status Code

ECstring

Internal Error Code. This is used to help TabaPay team members trace an error.

EMstring

Short description of the error if an error occurred.

actionCodestring

Result of the 3DS transaction attempt

SUCCESS
CANCEL
ERROR
FAILURE
NOACTION
TIMEOUT

errorNumberstring

Listed error number

errorDescriptionstring

Description of the listed actionCode error and errorNumber

3dsVersionstring

The 3D Secure Version that was used to process this request.

Expected values are of the form: 2.X.X

processorTransactionIDstring

Processor Transaction Identifier

statusstring

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

ECIstring

Electronic Commerce Indicator

Possible Values:

UCAFstring

Universal Cardholder Authentication Field

Visa uses <glossary:CAVV> (Cardholder Authentication Verification Value)

MasterCard uses AAV (Account-Holder Authentication Value)

XIDstring

XID (Transaction ID)

Example response

{
  "actionCode": "SUCCESS",
  "errorNumber": "0",
  "errorDescription": "0",
  "3dsVersion": "2.2.0",
  "processorTransactionID": "11111111111111111111",
  "status": "`Y`",
  "ECI": "05",
  "UCAF": "1111111111111111111111111111",
  "XID": "VkM0MXAwOGhjMGxuaUcxU1VtNjA="
}