Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-2647148658.0 KB
V2

Validate a JWT for 3DS Client SDK

The API validates the JSON Web Token (JWT) and returns the consumer authentication outcome to the merchant.

post/v2/jwt/validate

Request body

authentication_idstring required

Authentication ID for completing the 3D Secure flow. To complete the transaction, the value is required to be passed on the Authenticate message to link the Lookup and Authenticate message together.

jwtstring required

JWT with authentication details.

threeds_contract_idstring required

The ID of the threeDSContractId used.

Example request

{
  "authentication_id": "8894172e-52b2-4815-82da-ca3c5f005268",
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJjNmZjZGU3NS02M2MxLTRiMDktODA4MS0xYjdmMGUyZDQ2MmMiLCJpc3MiOiI1ZDEyMmU1OGMxYjQxMjI5M2MwYTUwZDIiLCJPcmdVbml0SWQiOiI1ZDExMmJjMWJiODc2ODIyNDBmOGRjMGQiLCJQYXlsb2FkIjp7fSwiaWF0IjoxNzE1MTgwMDk5fQ.yfNWLd2ssMoUpJt2QOUhf9p1B3dcl0xFOeaPYi8MUxI",
  "threeds_contract_id": "af8f5e0d-799d-4421-a8ee-04002a15af53"
}

Response

Created

authentication_idstring required

Authentication ID for completing the 3D Secure flow. To complete the transaction, the value is required to be passed on the Authenticate message to link the Lookup and Authenticate message together.

action_codestring required

The resulting state of the transaction

error_nostring required

Application error number(s). A non-zero value represents the error encountered while attempting to process the message request. NOTE: Multiple error numbers are separated by a comma.

error_descstring required

Application error description for the associated error number(s). NOTE: Multiple error descriptions are separated by a comma.

Example response

{
  "authentication_id": "8894172e-52b2-4815-82da-ca3c5f005268",
  "error_no": "0",
  "error_desc": "Error Processing Message Request",
  "validation_result": {
    "authorization_payload": "eyJjb250YWluZXJWZXJzaW9uIjoiMSIsImVjaSI6IjA1IiwiYXV0aGVudGljYXRpb25WYWx1ZSI6IkFKa0JCa2hnUVFBQUFFNGdTRUp5ZFFBQUFBQT0iLCJlZmZlY3RpdmVBdXRoVHlwZSI6IkZSIiwiYWNzT3BlcmF0b3JJRCI6Ik1lcmNoYW50QUNTIiwidGhyZWVEU1JlcXVlc3RvckNoYWxsZW5nZUluZCI6IjAxIiwidHJhbnNTdGF0dXMiOiJZIiwiZHNUcmFuc0lEIjoiNzg4NDFhZGMtMDI1Mi00ZDE0LTg5ZTYtOWE0NzQ3YTE0NWRhIiwiYWNzVHJhbnNJRCI6IjlmZTlhN2Q1LTVlMDctNDhjMi05ZmRkLWEyMWZhMjc0YjFlOSIsIm1lc3NhZ2VWZXJzaW9uIjoiMi4yLjAiLCJtZXJjaGFudE5hbWUiOiJWZXJpRm9uZSIsInB1cmNoYXNlRGF0ZSI6IjIwMTkxMjMxMjM1OTU5IiwicHVyY2hhc2VBbW91bnQiOiI5ODg3NTYiLCJyZWN1cnJpbmdFeHBpcnkiOiIyMDE5MDgyMyIsImJyb3dzZXJJUCI6Ijg5LjE0Ni41OC44NyIsIm1lcmNoYW50Q291bnRyeUNvZGUiOiI4NDAiLCJhY3F1aXJlckJJTiI6IjEyMzQ1Njc4IiwiYWNxdWlyZXJNZXJjaGFudElEIjoiMTIzNDU2IiwidGhyZWVEU1JlcXVlc3Rvck5hbWUiOiJ2ZXJpZm9uZSIsInRocmVlRFNSZXF1ZXN0b3JJRCI6InZlcmlmb25lMjAiLCJjYXJkQnJhbmQiOiJWSVNBIn0=",
    "cavv": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=",
    "cavv_algorithm": "2",
    "eci_flag": "05",
    "enrolled": "Y",
    "pares_status": "Y",
    "reason_code": "1001",
    "reason_desc": "Error Processing Message Request",
    "signature_verification": "Y",
    "xid": "AgIAABTXCmieAEiwml9DlVAsiBI="
  }
}