Device Information Fields
These fields can be used to provide details of the device from which the transaction is being made. Although not strictly mandatory, they may be required for fraud checking or 3-D Secure authentication, in which case it is highly recommended that they be provided.
| Field Name | Mandatory? | Description/Value |
|---|---|---|
| deviceType | No | Type of Consumer’s device. One of the following values: desktop, laptop, tablet, phone, other. |
| deviceChannel | No | Communications channel used by the Consumer’s device. One of the following values: browser, app, other. |
| deviceIpAddress | No [2] | IP address of client making the transaction using dotted decimal notation (e.g. 1.12.123.255) or an IP v6 address using colon hexadecimal notation (e.g. 2011:0db8:85a3:0101: 0101:8a2e:0370:7334). |
| deviceIdentity | No[1] | Content of the HTTP User-Agent header received from the Consumer’s device. Truncated to 2048 characters maximum. |
| deviceTimeZone | No[1] | Time zone offset in minutes between UTC and the Consumer’s device. The offset is positive if the local time zone is behind UTC and negative if it is ahead. |
| deviceCapabilities | No[1] | Comma separated list of capabilities supported by the Consumer’s device. One or more of the following values: java, javascript. |
| deviceAcceptContent | No[1] | Content of HTTP Accept header received from the Consumer’s device. Truncated to 2048 characters maximum. |
| deviceAcceptCharset | No[1] | Content of HTTP Accept-Charset header received from the Consumer’s device. Truncated to 2048 characters maximum. |
| deviceAcceptEncoding | No[1] | Content of HTTP Accept-Encoding header received from the Consumer’s device. Truncated to 2048 characters maximum. |
| deviceAcceptLanguage | No[1] | Content of HTTP Accept-Language header received from the Consumer’s device. Truncated to 2048 characters maximum. |
| deviceScreenResolution | No[1] | Screen resolution of the Consumer’s device. Formatted as [HxWxD] where: • H – screen height in pixels • W – screen width in pixels • D – colour depth in bits Screen height and width must be between 1 and 999999 pixels. Colour depth must be one of the following values: 1, 4, 8, 15, 16, 24, 32, 48. |
| deviceOperatingSystem | No | Operating system used by the Consumer’s device. One of the following values: win, unix, linux, macos, ios, android, other. |
[1] This field is mandatory for 3-D Secure unless an alternative is provided via the threeDSOptions field.
[2] Not supported by the Hosted Integration, which will automatically use the Customer's IP address.