browserInfo | Computop Documents

The browserInfo object is only relevant for Server-to-Server- or Silent Order Post (PayNow)- integrations. Merchants that use Computop payment pages or card forms do not need to submit this data field.

Data Elements

Key

Format

CND

Description

acceptHeaders

string

Exact content of the HTTP accept headers as sent from the customer’s browser

ipAddress

string

IP address of the browser as returned by the HTTP headers

javaEnabled

boolean

Boolean that represents the ability of the customer's browser to execute Java. Required when Browser JavaScript Enabled = true; otherwise Optional.

javaScriptEnabled

boolean

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

Value representing the browser language as defined in IETF BCP47, returned from navigator.language property, e.g. "en", "de", "fr", "en-US", "en-GB", "de-DE", "de-AT", ...

colorDepth

integer

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 lower value instead. Currently allowed are 1, 4, 8, 15, 16, 24, 32, 48 bits.

screenHeight

integer

Total height of the Cardholder’s screen in pixels. Required when Browser JavaScript Enabled = true; otherwise optional.

screenWidth

integer

Total width of the cardholder’s screen in pixels. Required when Browser JavaScript Enabled = true; otherwise optional.

timeZoneOffset

string

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

Exact content of the HTTP user-agent header

Schema

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

1
{
2
    "$schema": "http://json-schema.org/draft-07/schema#",
3
    "$id": "BASEURL/browserInfo.json",
4
    "title": "browserInfo",
5
    "description": "Browser Information",
6
    "type": "object",
7
    "properties": {
8
        "acceptHeaders": {
9
            "type": "string",
10
            "maxLength": 2048,
11
            "description": "Exact content of the HTTP accept headers from the browser."
12
        },
13
        "ipAddress": {
14
            "type": "string",
15
            "oneOf": [{"format": "ipv4"},{"format": "ipv6"}],
16
            "description": "IP address of the browser as returned by the HTTP headers."
17
        },
18
        "javaEnabled": {"type": "boolean"},
19
        "javaScriptEnabled": {"type": "boolean"},
20
        "language": {
21
            "type": "string",
22
            "minLength": 2,
23
            "maxLength": 8,
24
            "description": "Value representing the browser language as defined in IETF BCP47, e.g. 'en', 'de', 'fr', 'en-US', 'en-GB', 'de-DE', 'de-AT', ..."
25
        },
26
        "colorDepth": {
27
            "type": "integer",
28
            "enum": [1, 4, 8, 15, 16, 24, 30, 32, 48],
29
            "description": "Value representing the bit depth of the colour palette for displaying images, in bits per pixel."
30
        },
31
        "screenHeight": {
32
            "type": "integer",
33
            "minLength": 1,
34
            "maxLength": 6,
35
            "description": "Total height of the Cardholderâ€™s screen in pixels."
36
        },
37
        "screenWidth": {
38
            "type": "integer",
39
            "minLength": 1,
40
            "maxLength": 6,
41
            "description": "Total width of the cardholderâ€™s screen in pixels."
42
        },
43
        "timeZoneOffset": {
44
            "type": "string",
45
            "minLength": 1,
46
            "maxLength": 5,
47
            "description": "Time-zone offset in minutes between UTC and the Cardholder browser local time."
48
        },
49
        "userAgent": {
50
            "type": "string",
51
            "maxLength": 2048,
52
            "description": "Exact content of the HTTP user-agent header."
53
        }
54
    },
55
    "if": {
56
        "properties": {
57
            "javaScriptEnabled": {"enum": [true]}
58
        }
59
    },
60
    "then": {
61
        "required": ["acceptHeaders", "javaEnabled", "javaScriptEnabled", "colorDepth", "screenHeight", "screenWidth", "timeZoneOffset", "language", "userAgent"]
62
    },
63
    "else": {
64
        "required": ["acceptHeaders", "ipAddress", "javaScriptEnabled", "language", "userAgent"]
65
    },
66
    "additionalProperties": false
67
}

Sample

1
{ 
2
    "acceptHeaders": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,&ast;/&ast;;q=0.8",
3
    "ipAddress": "2001:0db8:85a3:0000:0000:8a2e:0370:7334",
4
    "javaEnabled": false,
5
    "javaScriptEnabled": true,
6
    "language": "en-US",
7
    "colorDepth": 24,
8
    "screenHeight": 723,
9
    "screenWidth": 1536,
10
    "timeZoneOffset": "300",
11
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.110 Safari/537.36"
12
}