API Reference
API ReferenceRecipesChangelogCommunity
Start typing to search…

Browser Fields

3DS Browser Data Fields

The information on this page references thebrowser object within the 3D Secure Lookup 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":"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.