Skip to main content

User Agent & Geolocation

Upon the acceptance or decline of a verification request, the system returns an info object containing two additional sub-objects: Agent and Geolocation which provides essential details about user's device and geolocation.

Device & Browser Details​

The "Agent" object provides comprehensive insights into the merchant/end-user's device and browser. It contains the following parameters

ParametersDescription
is_desktopType: Boolean
Example: true
Shows empty string “” if not detected.
is_phoneType: Boolean
Example: false
Shows empty string “” if not detected.
useragentType: string
Example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.100 Safari/537.36
Shows empty string “” if not detected.
device_nameType: string
Example: Macintosh
Shows empty string “” if not detected.
browser_nameType: string
Example: Chrome - 70.0.3538.80
Shows empty string “” if not detected.
platform_nameType: string
Example: OS X - 10_14_0
Shows empty string “” if not detected.
agent-sample-object
{
  "agent": {
    "is_desktop": true,
    "is_phone": false,
    "useragent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3770.100 Safari/537.36",
    "device_name": "Macintosh",
    "browser_name": "",
    "platform_name": "OS X - 10_14_0"
  }
}

Location Details​

The "Geolocation" object offers geographical information of the merchant/end-user. It contains the following parameters

ParametersDescription
hostType: string
Example: 212.103.50.243
Shows empty string “” if not detected.
ipType: string
Example: 212.103.50.243
Shows empty string “” if not detected.
rdnsType: string
Example: 212.103.50.243
Shows empty string “” if not detected.
asnType: string
Example: 9009
Shows empty string “” if not detected.
ispType: string
Example: M247 Ltd
Shows empty string “” if not detected.
country_nameType: string
Example: Germany
Shows empty string “” if not detected.
country_codeType: string
Example: DE
Shows empty string “” if not detected.
region_nameType: string
Example: Hesse
Shows empty string “” if not detected.
region_codeType: string
Example: HE
Shows empty string “” if not detected.
cityType: string
Example: Frankfurt am Main
Shows empty string “” if not detected.
postal_codeType: string
Example: 60326
Shows empty string “” if not detected.
continent_nameType: string
Example: Europe
Shows empty string “” if not detected.
continent_codeType: string
Example: EU
Shows empty string “” if not detected.
latitudeType: string
Example: 50.1049
Shows empty string “” if not detected.
longitudeType: string
Example: 50.1049
Shows empty string “” if not detected.
metro_codeType: string
Example: 501
Shows empty string “” if not detected.
timezoneType: string
Example: Europe/Berlin
Shows empty string “” if not detected.
geolocation-sample-object
{
  "geolocation": {
    "host": "212.103.50.243",
    "ip": "212.103.50.243",
    "rdns": "212.103.50.243",
    "asn": "9009",
    "isp": "M247 Ltd",
    "country_name": "Germany",
    "country_code": "DE",
    "region_name": "Hesse",
    "region_code": "HE",
    "city": "Frankfurt am Main",
    "postal_code": "60326",
    "continent_name": "Europe",
    "continent_code": "EU",
    "latitude": "50.1049",
    "longitude": "8.6295",
    "metro_code": "",
    "timezone": "Europe/Berlin"
  }
}