Lookup - Sample Request and Response
Summary
Use this request to check the 3DS version and return version details.
POST /3ds2/lookup
Sample URL
- Test: https://uat.gw.fraud.eu.elavonaws.com/3ds2/lookupopen_in_newLink opens new window
- Production: https://gw.fraud.elavon.com/3ds2/lookupopen_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
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": "1.0.2",
"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