Community Forum Guidelines

Browser Fields

3DS Browser Data Fields

The information on this page references the browser object within the 3D Secure Lookup request body.

Browser Object Field browserInfo

The newly exposed browserInfo field within the browser object contains all fields below concatenated with | character. All individual fields will be validated against the below types, definitions, and notes.

Example value of browserInfo

"browserInfo":"true|Mozilla/5.0 iPhone|text/html,application/xhtml+xml,application/xml;q=0.9,_/_;q=0.8|true|en-US|32|414|896|300|127.0.0.1"

📘

The deviceChannel field within the browser object remains a separate and required field

Browser Object Fields

JSON NameType / Definition / NotesExample Value
javascriptEnabledboolean
Browser has ability to execute JavaScript
Value is returned from the navigator.javaScriptEnabled property		true
userAgentstring
The exact content of the HTTP user agent header.		Mozilla/5.0 iPhone
headerstring
The exact content of the HTTP accept headers sent from the cardholder's browser.		text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
javaEnabledboolean
Browser has ability to execute Java
Value is returned from the navigator.javaEnabled property		true
languagestring
The IETF BCP47 browser language 		en-US
colorDepthstring
The bit depth of the color palette for displaying images (in bits per pixel)

Possible Values: (based on EMVCo spec):

- 1
- 4
- 8
- 15
- 16
- 24
- 32
- 48		32
screenHeightstring
Total height of the cardholder's scree in pixels		864
screenWidthstring
Total width of the cardholder's screen in pixels.		1536
timezonestring
Time difference between UTC time and the cardholder browser local time, in minutes		300
ipAddressstring
The IP address of the cardholder (IPv4 and IPv6 both acceptable)		1.12.123.255

Example /3ds/lookup Request (With browserInfo)

The below example request contains newlines for readability only. Please do not use any newlines in your JSON requests.

{
   "account":{
      "accountID":"**********************",
      "owner":{
         "phone":{
            "countryCode":"1",
            "number":"1234567890"
         },
         "email":"[email protected]",
         "address":{
            "line1":"1 Main Street",
            "city":"Mountain View",
            "zipcode":"94043",
            "state":"CA"
         }
      }
   },
   "order":{
      "orderID":"order-20230322174812",
      "amount":"1.00",
   },
   "3dsID":"MjAyMzAzMjQxNzE1MzQwMDAwMXxlMzI1YTRmZC0zMzk3LTQ0ZjEtOTFkMi03ZGU1Yzk2YzllZjI",
   "authenticationIndicator":"01",
   "transactionType":"C",
   "productCode":"ACF",
   "browser":{
      "browserInfo":"true|Mozilla/5.0 iPhone|text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8|true|en-US|32|414|896|300|127.0.0.1",
      "deviceChannel":"Browser"
   }
}
Cardinal Commerce's CMPI Lookup Docs were referenced when creating this page.