Validate - Sample Request and Response

Summary

Use this request to send the cres field value to the 3DS Server to retrieve the challenge result.

POST  /3ds2/validate

Sample URL

Headers

Header nameDescriptionRequiredValues
Content-TypeThe MIME type of the request body.Requiredapplication/json
AuthorizationAuthorization type (Basic) and the base64 encoded username and password
Or
Bearer followed by token
RequiredBasic <encoded_auth_data>
Or
Bearer <token_value>

note

  • The sample request and response on this page assume that the acctNumber supported 3DS 2.1 authentication, but the issuer needed additional information from the cardholder to authenticate the transaction i.e. a challenge flow. After the cardholder provided additional information to the issuer, it authenticates the transaction i.e. transStatus = Y.

  • If transStatus = N, the response will also have the transStatusReason field.

Sample request

{
  "messageId": "c84a2370-ab74-4abe-97b7-2422a3b538b1",
  "cres": "ewogICJtZXNzYWdlVHlwZSI6ICJDUmVzIiwKICAibWVzc2FnZVZlcnNpb24iOiAiMi4xLjAiLAogICJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ICIwODg1Y2YzZS1hZjUxLTQ3NWMtYjI0Ni1mYjZjODRmMzI2ODEiLAogICJhY3NUcmFuc0lEIjogIjZmMmQ3YWY5LTlhNjYtNGUyYi04MjIwLTFlMDBiNmNmNzJkZSIsCiAgImNoYWxsZW5nZUNvbXBsZXRpb25JbmQiOiAiWSIsCiAgImFjc0NvdW50ZXJBdG9TIjogIjAwMSIsCiAgInRyYW5zU3RhdHVzIjogIkEiCn0="
}

important

You must use the messageId and the BASE64-encoded cres value you received from the ACS.

Sample response

{
  "messageId": "c84a2370-ab74-4abe-97b7-2422a3b538b1",
  "threeDSServerTransID": "0885cf3e-af51-475c-b246-fb6c84f32681",
  "valid": true,
  "rReq":{
        "messageType": "RReq",
        "messageVersion": "2.1.0",
        "threeDSServerTransID": "0885cf3e-af51-475c-b246-fb6c84f32681",
        "dsTransID": "adb4e259-8e30-4c7e-8cb7-87fd44a22075",
        "acsTransID": "6f2d7af9-9a66-4e2b-8220-1e00b6cf72de",
        "authenticationType": "01",
        "authenticationValue": "lIZK0RcpcDZ83vutqkwrZqJ0fl4=",
        "eci": "06",
        "interactionCounter": "01",
        "messageCategory": "01",
        "transStatus": "Y"
    }
}

Related topics