Start 1cs Online Payment System Documentation Services (Eng) EMV 3D-Secure EN JSON Object browserInfo

browserInfo

JSON object

BrowserInfo

The browserInfo object is only relevant for Server-to-Server integrations. Merchants that use First Cash Solution payment pages or card forms do not need to submit this data field.

Data elements

Key	Format	Condition	Description
acceptHeaders	string	M	Exact content of the HTTP accept headers as sent from the customer’s browser.
ipAddress	string	M	IP address of the browser as returned by the HTTP headers.
javaEnabled	boolean	C	Boolean that represents the ability of the customer’s browser to execute Java. Required when Browser JavaScript Enabled = true; otherwise Optional.
javaScriptEnabled	boolean	M	Boolean that represents the ability of the customer’s browser to execute JavaScript. For using 3DS 2.0 JavaScript muss be activated (javaScriptEnabled = true). In this case all depending parameters javaEnabled, colorDepth, screenHeight, screenWidth and timeZoneOffset has to be submitted too.
language	string	M	Value representing the browser language as defined in IETF BCP47, e.g. “en”, “de”, “fr”, “en-US”, “en-GB”, “de-DE”, “de-AT”, …
colorDepth	integer	C	Value representing the bit depth of the colour palette for displaying images, in bits per pixel. Required when Browser JavaScript Enabled = true; otherwise optional.
screenHeight	integer	C	Total height of the Cardholder’s screen in pixels. Required when Browser JavaScript Enabled = true; otherwise Optional.
screenWidth	integer	C	Total width of the cardholder’s screen in pixels. Required when Browser JavaScript Enabled = true; otherwise Optional.
timeZoneOffset	string	C	Time-zone offset in minutes between UTC and the Cardholder browser local time. Required when Browser JavaScript Enabled = true; otherwise Optional. Note that the offset is positive if the local time zone is behind UTC and negative if it is ahead.
userAgent	string	M	Exact content of the HTTP user-agent header.

Data elements

Schema

BASEURL= https://www.computop-paygate.com/schemas

{

"$schema": "http://json-schema.org/draft-07/schema#",

"$id": "BASEURL/browserInfo.json",

"title": "browserInfo",

"description": "Browser Information",

"type": "object",

"properties": {

"acceptHeaders": {

"type": "string",

"maxLength": 2048,

"description": "Exact content of the HTTP accept headers from the browser."

},

"ipAddress": {

"type": "string",

"oneOf": [{"format": "ipv4"},{"format": "ipv6"}],

"description": "IP address of the browser as returned by the HTTP headers."

},

"javaEnabled": {"type": "boolean"},

"javaScriptEnabled": {"type": "boolean"},

"language": {

"type": "string",

"minLength": 2,

"maxLength": 8,

"description": "Value representing the browser language as defined in IETF BCP47, e.g. 'en', 'de', 'fr', 'en-US', 'en-GB', 'de-DE', 'de-AT', ..."

},

"colorDepth": {

"type": "integer",

"enum": [1, 4, 8, 15, 16, 24, 30, 32, 36, 48],

"description": "Value representing the bit depth of the colour palette for displaying images, in bits per pixel."

},

"screenHeight": {

"type": "integer",

"minLength": 1,

"maxLength": 6,

"description": "Total height of the Cardholderâ€™s screen in pixels."

},

"screenWidth": {

"type": "integer",

"minLength": 1,

"maxLength": 6,

"description": "Total width of the cardholderâ€™s screen in pixels."

},

"timeZoneOffset": {

"type": "string",

"minLength": 1,

"maxLength": 5,

"description": "Time-zone offset in minutes between UTC and the Cardholder browser local time."

},

"userAgent": {

"type": "string",

"maxLength": 2048,

"description": "Exact content of the HTTP user-agent header."

}

},

"if": {

"properties": {

"javaScriptEnabled": {"enum": [true]}

}

},

"then": {

"required": ["acceptHeaders", "javaEnabled", "javaScriptEnabled", "colorDepth", "screenHeight", "screenWidth", "timeZoneOffset", "language", "userAgent"]