The browserInfo object is only relevant for Server-to-Server integrations. Merchants that use BNP payment pages or card forms do not need to submit this data field.
Data Elements
Key | Format | Condition | Description | |
---|---|---|---|---|
1 | acceptHeaders | string | M | Exact content of the HTTP accept headers as sent from the customer’s browser. |
2 | ipAddress | string | M | IP address of the browser as returned by the HTTP headers. |
3 | javaEnabled | boolean | C | Boolean that represents the ability of the customer's browser to execute Java. Required when Browser JavaScript Enabled = true; otherwise Optional. |
4 | javaScriptEnabled | boolean | M | Boolean that represents the ability of the customer's browser to execute JavaScript. |
5 | language | string | M | Value representing the browser language as defined in IETF BCP47. |
6 | 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. |
7 | screenHeight | integer | C | Total height of the Cardholder’s screen in pixels. Required when Browser JavaScript Enabled = true; otherwise Optional. |
8 | screenWidth | integer | C | Total width of the cardholder’s screen in pixels. Required when Browser JavaScript Enabled = true; otherwise Optional. |
9 | 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. |
10 | userAgent | string | M | Exact content of the HTTP user-agent header. |
Schema
{ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://paymentpage.axepta.bnpparibas/schemas/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": 1, "maxLength": 8, "description": "Value representing the browser language as defined in IETF BCP47." }, "colorDepth": { "type": "integer", "enum": [1, 4, 8, 15, 16, 24, 32, 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"] }, "else": { "required": ["acceptHeaders", "ipAddress", "javaScriptEnabled", "language", "userAgent"] }, "additionalProperties": false }
Sample
{ "acceptHeaders": "text\/html,application\/xhtml+xml,application\/xml;q=0.9,image\/webp,image\/apng,*\/*;q=0.8", "ipAddress": "2001:0db8:85a3:0000:0000:8a2e:0370:7334", "javaEnabled": false, "javaScriptEnabled": true, "language": "US", "colorDepth": 24, "screenHeight": 723, "screenWidth": 1536, "timeZoneOffset": "300", "userAgent": "Mozilla\/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/70.0.3538.110 Safari\/537.36" }