Information about the payer's browser / device

To make payments from the payer's card with confirmation using 3DS 2 technology, it is necessary to transfer information about the payer's device to the method of payment / creation of payment. This information is collected from the browser/device/request when the payer clicks the "Pay" button (you may have a different name) and is sent in the device parameter to the appropriate method (depending on the implementation). An example of such a method - Creating an invoice payment (Invoices payments create), in case of realization of payment of invoices by means of own payment page.

Device object parameters:

Key

Description

Type

Mandatory

Example

Key

Description

Type

Mandatory

Example

acceptHeader

the contents of the Accept HTTP header sent from the browser

customer

string

yes

"*/*"

ip

Browser IP address

string

yes

"91.137.205.117"

colorDepth

screen color depth

integer

yes

24

javaEnabled

the ability to run Java in a browser

boolean

yes

false

language

the browser language specified in the IETF BCP47

string

yes

"en-US"

screenHeight

total screen height in pixels

integer

yes

864

screenWidth

total screen width in pixels

integer

yes

1536

windowHeight

the height of the browser window in pixels, which displays the page of the client's site, or the height of the area in which will be displayed ACS-page of the issuer to confirm the payment

integer

yes

734

windowWidth

the width of the browser window in pixels in which the page of the client's site is displayed, or the width of the area in which, the ACS page of the issuer will be displayed to confirm the payment

integer

yes

1479

time

time of information collection

string

yes

"2021-10-07T14:55:52.832Z"

timezoneOffset

browser time zone in minutes (the difference between UTC time and local browser time)

number

yes

-180

userAgent

the contents of the User-Agent HTTP header sent from the client browser

string

yes

"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36"

The client takes the acceptHeader, ip and userAgent parameters from a request made from the payer's browser/device to its web server, and takes the other parameters in the payer's browser using JavaScript, for example:

1 2 3 4 5 6 7 8 9 10 11 { colorDepth: screen && screen.colorDepth, javaEnabled: navigator && navigator.javaEnabled(), language: navigator && navigator.language, screenHeight: screen && screen.height, screenWidth: screen && screen.width, windowHeight: window.innerHeight || document.documentElement.clientHeight || document.body.clientHeight, windowWidth: window.innerWidth || document.documentElement.clientWidth || document.body.clientWidth, time: new Date(), timezoneOffset: new Date().getTimezoneOffset() }

Example of an object:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 { "acceptHeader": "*/*", "ip": "91.137.205.117", "colorDepth": 24, "javaEnabled": false, "language": "en-US", "screenHeight": 864, "screenWidth": 1536, "windowHeight": 734, "windowWidth": 1479, "time": "2021-10-07T14:55:52.832Z", "timezoneOffset": -180, "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36" }