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
- Test: https://uat.gw.fraud.eu.elavonaws.com/3ds2/validateopen_in_newLink opens new window
- Production: https://gw.fraud.elavon.com/3ds2/validateopen_in_newLink opens new window
Headers
Header name | Description | Required | Values |
---|---|---|---|
Content-Type | The MIME type of the request body. | Required | application/json |
Authorization | Authorization type (Basic) and the base64 encoded username and password Or Bearer followed by token | Required | Basic <encoded_auth_data> Or Bearer <token_value> |
error_outline
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 thetransStatusReason
field.
Sample request
{
"messageId": "c84a2370-ab74-4abe-97b7-2422a3b538b1",
"cres": "ewogICJtZXNzYWdlVHlwZSI6ICJDUmVzIiwKICAibWVzc2FnZVZlcnNpb24iOiAiMi4xLjAiLAogICJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ICIwODg1Y2YzZS1hZjUxLTQ3NWMtYjI0Ni1mYjZjODRmMzI2ODEiLAogICJhY3NUcmFuc0lEIjogIjZmMmQ3YWY5LTlhNjYtNGUyYi04MjIwLTFlMDBiNmNmNzJkZSIsCiAgImNoYWxsZW5nZUNvbXBsZXRpb25JbmQiOiAiWSIsCiAgImFjc0NvdW50ZXJBdG9TIjogIjAwMSIsCiAgInRyYW5zU3RhdHVzIjogIkEiCn0="
}
error_outline
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"
}
}