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


KeyFormatConditionDescription
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.

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.

5

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", ...

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.

Notice: Meanwhile exist the new color depths 30 and 36 bits, but these are not included within den EMVCo specifications and should not be used because they can cause rejections. Please send the next lowe value instead. Currently allowed are 1, 4, 8, 15, 16, 24, 32, 48 bits.

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, e.g. 'en', 'de', 'fr', 'en-US', 'en-GB', 'de-DE', 'de-AT', ..."
        },
        "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": "en-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"
}




  • No labels