Browser Fields

3DS Browser Data Fields

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

Browser Object Field `browserInfo`

The newly exposed browserInfo field within the browserobject 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 Name	Type / Definition / Notes	Example Value
`javascriptEnabled`	`boolean` Browser has ability to execute JavaScript Value is returned from the navigator.javaScriptEnabled property	`true`
`userAgent`	`string` The exact content of the HTTP user agent header.	`Mozilla/5.0 iPhone`
`header`	`string` 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`
`javaEnabled`	`boolean` Browser has ability to execute Java Value is returned from the navigator.javaEnabled property	`true`
`language`	`string` The IETF BCP47 browser language	`en-US`
`colorDepth`	`string` 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`
`screenHeight`	`string` Total height of the cardholder's scree in pixels	`864`
`screenWidth`	`string` Total width of the cardholder's screen in pixels.	`1536`
`timezone`	`string` Time difference between UTC time and the cardholder browser local time, in minutes	`300`
`ipAddress`	`string` 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":"Palo Alto",
            "zipcode":"94306",
            "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"
   }
}

For more field descriptions reference in this page, refer to the Cardinal Merchant Plug In (CMPI) Lookup Docs.