Lookup - Sample Request and Response

Title: Request to check the 3DS version and return version details

 POST        /3ds2/lookup

Sample URL

Test: https://uat.gw.fraud.eu.elavonaws.com/3ds2/lookup

Production: https://https://gw.fraud.elavon.com/3ds2/lookup

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 assumes that the acctNumber supports 3DS 2.1 authentication and additional information about the BIN is available.

Sample request

{
   "messageId" : "0b0deb70-3249-4c73-9cf5-92f6cac231af",
   "acctNumber" : "4017730000000005",
   "threeDSMethodNotificationURL" : "https://uat.gw.fraud.eu.elavonaws.com",
   "doBinLookup" : true,
   "clientStartProtocolVersion": "2.1.0",
   "clientEndProtocolVersion" : "2.1.0"
}
error_outline

note

The threeDSMethodNotificationURL receives the notification of 3DS Method completion from the ACS (issuer). The default value is the 3DS Server URL. To receive a notification on a custom URL, send the custom URL as the field value.

Sample response

{
   "messageId" : "0b0deb70-3249-4c73-9cf5-92f6cac231af",
   "threeDSServerTransID" : "102f8f6e-8472-4ada-8deb-91d5bd51de90",
   "dsStartProtocolVersion" : "2.1.0",
   "dsEndProtocolVersion" : "2.2.0",
   "acsStartProtocolVersion" : "2.1.0",
   "acsEndProtocolVersion" : "2.2.0",
   "directoryServerId" : "DirectoryServerID-DEMO-MC",
   "threeDSMethodURL" : "https://uat.acs.fraud.eu.elavonaws.com/acs/method/VISA",
   "threeDSMethodData" : "eyJ0aHJlZURTTWV0aG9kTm90aWZpY2F0aW9uVVJMIjoiaHR0cDovL2MyLWRldi1leHRlcm5hbC02NTY0ZDVlZDA2MjFjZjk0LmVsYi5ldS13ZXN0LTEuYW1hem9uYXdzLmNvbToxMDg1MC9ub3RpZnkvbWV0aG9kX25vdGlmeSIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiMTAyZjhmNmUtODQ3Mi00YWRhLThkZWItOTFkNWJkNTFkZTkwIn0=",
   "acsInfoInd":["01", "02", "03", "04"],
   "binInfo" :
    {
        "bin" : "401773",
        "scheme" : "Visa",
        "brand" : "Visa Electron",
        "fundingSource" : "prepaid",
        "issuingBank" : "GVS PREPAID LIMITED",
        "issuingCountry" : "IRL",
        "issuingCurrency" : "EUR",
        "isDebit" : "true",
        "isCorporate" : "false",
        "isDccAllowed" : "true"
    },
    "serverStartProtocolVersion": "2.1.0", 
    "serverEndProtocolVersion": "2.1.0"
}
error_outline

note

The response returns the acsInfoInd field only if the user is using a VISA card.

For additional /3ds2/lookup scenarios, see Test scenarios - Sample /3ds2/lookup scenarios

Next Step

Authenicate request - sample request and response

Related topics