3D Secure Authenticate

3D Secure Card Challenge Authentication.

If you are an ISO (Independent Sales Organization), you will need to specify a SubClientID (see notes below).


URL:

https://<FQDN>/v2/clients/<ClientIDISO>/3ds/authenticate


Request:

JSON Name Value Required Default Description
3dsID String R 3dsID from 3D Secure Initialize
jwt String R JWT (JSON Web Token) from Challenge

Sample Request:

Pack your Request, the following Samples shown here are unpacked only for human readability:

{
  "3dsID": "ID_BASE64-URL-SAFE-VALUE",
  "jwt": "JWT-BASE64-URL-SAFE-VALUE"
}

Response:

Status Codes:

Status Code Description
200 OK A Lookup Response is returned.

See Status Codes for other possible Status Codes that might be returned.


Response Data:

JSON Name Value Description Status Code
200 Other
SC Integer
3-digit code
HTTP Status Code O
EC String
1 or 8 characters
Internal Error Code O
EM String Error Message O
actionCode String Result: Action Code
errorNumber String Result: Error Number
errorDescription String Result: Error Description O
3dsVersion String The 3D Secure Version that was used to process this request
processorTransactionID String Processor Transaction Identifier
status String Status
ECI String ECI (Electronic Commerce Indicator)
UCAF String UCAF (Universal Cardholder Authentication Field)
  • Visa uses CAVV (Cardholder Authentication Verification Value)
  • MasterCard uses AAV (Accountholder Authentication Value)
XID String XID (Transaction ID) O

Sample Response:

{
  "SC": 200,
  "EC": "0",
  "actionCode": "SUCCESS",
  "errorNumber": "0",
  "errorDescription": "Success"
  "3dsVersion": "2.1.0",
  "processorTransactionID":"11111111111111111111",
  "status": "Y",
  "ECI": "05",
  "UCAF": "1111111111111111111111111111"
}

Notes:

For Clients who are an ISO (Independent Sales Organization), to specify your ClientID and a SubClientID, use the underscore character ("_") to separate the two values: <ClientID>_<SubClientID> where:

  • ClientID is your unique 22-character string and
  • SubClientID is an assigned 4, 6 or 8-digit value.

Also please read the 3D Secure FAQ.