Objects Device Data
The device data (also known as device fingerprint) is essential for supporting 3DSv2 — the advanced 3D Secure verification flow.
If you plan to process credit card payments using the Direct API, it is strongly recommended to include device data in your requests to ensure better compatibility and security.
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
}