3D Secure Initialize

Initializes a 3D Secure Card Authentication Request.

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/init


Request:

JSON Name Value Required Default Description
account object R Account
accountID String
22 characters
R AccountID
owner object O Owner
phone object O Phone Number (E.164 Numbering)
countryCode String
1-3 digits
O 1 Country Calling Code
number String
Min: 4 digits
Max: 12-14 digits
R Phone Number
order object R Order
orderID String
1-50 characters
R Order Number
currency String
3 digits
O 840 ISO 4217 Currency Number
amount String
Amount
R Transaction Amount

Sample Request:

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

{
  "account": {
    "accountID": "TabaPay_AccountID_22-c"
  },
  "order": {
    "orderID": "12345678",
    "amount": "0.10"
  }
}

Response:

Status Codes:

Status Code Description
200 OK A JWT is created.
207 Multi-Status One or more Failures occurred while processing the Request.
404 Not Found The AccountID does not point to a valid Account.

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


Response Data:

JSON Name Value Description Status Code
200 207 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 O
3dsID String An identifier representing this Request
jwt String JWT (JSON Web Token)
deviceCollectionURL String
URL
URL for Device Data Collection

Sample response:

{
  "SC": 200,
  "EC": "0",
  "3dsID": "ID_BASE64-URL-SAFE-VALUE",
  "jwt": "JWT-BASE64-URL-SAFE-VALUE",
  "deviceCollectionURL": "https://someplace.somewhere.com/DeviceCollect"
}

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.