When generating a card payment that requires 3D Secure authorization, information about the payer's browser must be collected and passed in an additional additionalData object.
The structure is as follows:
| Parameter | Type | Required | Description |
|---|---|---|---|
browser |
object | ✔️ | Information about the payer's browser |
browser.ip |
string | ✔️ | IP address. Allowed values: "ipv4", "ipv6" |
browser.language |
string | ✔️ | Browser language specified in UNICODE format, e.g. "pl-PL" |
browser.jsEnabled |
boolean | ✔️ | Specifies whether JavaScript support is enabled in the browser |
browser.timezoneOffset |
integer | ✔️ | Time-zone offset value between UTC and the cardholder browser's local time, in minutes. |
browser.userAgent |
string | ✔️ | Information about the client application used |
browser.accept |
string | ✔️ | Exact contents of the HTTP accept headers, MIME type |
browser.javaEnabled |
boolean | ✔️ | Specifies whether Java support is enabled in the browser |
browser.screenColorDepth |
integer | ✔️ | Color depth bit value for image display in bits per pixel, obtained from the cardholder browser, range: 1-48 bits |
browser.screenHeight |
integer | ✔️ | Browser window height in px |
browser.screenWidth |
integer | ✔️ | Browser window width in px |
Example of the object being passed
"additionalData": {
"browser": {
"ip": "127.0.0.1",
"language": "pl-PL",
"jsEnabled": true,
"timezoneOffset": 100,
"userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome 87.0.4280.66 Safari/537.36",
"accept": "application/json, text/javascript, */*; q=0.01",
"javaEnabled": false,
"screenColorDepth": 24,
"screenHeight": 1080,
"screenWidth": 2560
}
}