Objects Device Data
The device data (device fingerprint) is important for 3DSv2 (advanced 3DSecure verification flow). If you do consider processing the credit card payments over Direct API then you are highly recommended to add the device data to your requests.
STRUCTURE
✓ - required value
? - optional, value or null
✕ - always appears as null
| Variable | Type | Description | |
|---|---|---|---|
| user_agent | varchar(256) | ✓ | "User-Agent" header (browser version) |
| accept_header | varchar(50) | ✓ | "Accept" header of the client's browser |
| language | varchar(8) | ✓ | In JavaScript: navigator.language |
| ip_address | varchar(50) | ✓ | Client IP address |
| timezone_offset | int(10) | ✓ | UTC offset in minutes |
| color_depth | varchar(50) | ✓ | Color depth capability of the client's device screen |
| pixel_depth | varchar(50) | ✓ | Pixel depth capability of the client's device screen |
| pixel_ratio | varchar(50) | ✓ | Pixel ratio capability of the client's device screen |
| screen_height | int(10) | ✓ | Height of the client's device screen |
| screen_width | int(10) | ✓ | Width of the client's device screen |
| viewport_height | int(10) | ✓ | Height of the page view area within the client's browser window |
| viewport_width | int(10) | ✓ | Width of the page view area within the client's browser window |
| java_enabled | int(1) | ✓ | Java support within the client's browser window |
| javascript_enabled | int(1) | ✓ | JavaScript support within the client's browser window |
EXAMPLE
{
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1.1 Safari/605.1.15",
"accept_header": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
"language": "en-us",
"ip_address": "127.0.0.1",
"timezone_offset": -180,
"color_depth": "24",
"pixel_depth": "24",
"pixel_ratio": "2",
"screen_height": 900,
"screen_width": 1440,
"viewport_height": 400,
"viewport_width": 1440,
"java_enabled": 0,
"javascript_enabled": 1
}