3DS Browser Data Fields
The information on this page references the browser
object within the 3D Secure Lookup request body.
Browser Object Field browserInfo
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 thebrowser
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
)
/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.