Fraud API

SEON's proprietary API combines our email, phone number, IP, and AML APIs with device fingerprinting so that you can request and receive our enriched data, rules, and scoring in a single API call.

Good to know

  • The API is fully modular, meaning you can choose to enable or disable each sub-APIs (Email, Phone, IP, or AML) or the device fingerprinting tool. Use the config object to enable or disable modules.
  • You can use the custom_fields object to send almost any custom data point to SEON. Your team can also use custom fields in rules to create a completely custom ruleset.
  • All SEON API requests are case-sensitive. Please follow the formatting below to avoid errors.

For more context on how to begin your API integration check the Introduction section or our Integration Guide.

Request

 

Request Attributes

TypeRequired
config
objectno
action_type
stringno
ip
stringno
transaction_id
stringno
affiliate_id
stringno
affiliate_name
stringno
order_memo
stringno
email
stringno
email_domain
stringno
payment_id
stringno
password_hash
stringno
user_fullname
stringno
user_name
stringno
user_firstname
stringno
user_middlename
stringno
user_lastname
stringno
user_pob
stringno
user_photoid_number
stringno
user_id
stringno
user_created
integerno
user_category
stringno
user_account_status
stringno
user_bank_account
stringno
user_bank_name
stringno
user_balance
floatno
user_verification_level
stringno
user_dob
dateno
user_country
stringno
user_city
stringno
user_region
stringno
user_zip
stringno
user_street
stringno
user_street2
stringno
session_id
stringno
session
stringno
device_id
stringno
payment_mode
stringno
payment_provider
stringno
card_fullname
stringno
card_bin
stringno
card_hash
stringno
card_expire
dateno
card_last
stringno
avs_result
stringno
cvv_result
booleanno
status_3d
stringno
sca_method
stringno
phone_number
stringno
transaction_type
stringno
transaction_amount
floatno
transaction_currency
stringno
items
array of objectsno
shipping_country
stringno
shipping_city
stringno
shipping_region
stringno
shipping_zip
stringno
shipping_street
stringno
shipping_street2
stringno
shipping_phone
stringno
shipping_fullname
stringno
shipping_method
stringno
billing_country
stringno
billing_city
stringno
billing_region
stringno
billing_zip
stringno
billing_street
stringno
billing_street2
stringno
billing_phone
stringno
discount_code
stringno
gift
booleanno
gift_message
booleanno
merchant_category
stringno
merchant_id
stringno
merchant_created_at
integerno
merchant_country
stringno
receiver_fullname
stringno
receiver_bank_account
stringno
details_url
stringno
regulation
stringno
bonus_campaign_id
stringno
brand_id
stringno
custom_fields
objectno

HTTP Endpoint

POST

https://api.seon.io/SeonRestService/fraud-api/v2/
PHP
Ecommerce
Withdrawal

Response

The endpoint returns JSON structured response.

JSON Attributes

Type
id
string
state
string
fraud_score
number
ip_details
object
email_details
object
bin_details 
object
phone_details
object
aml_details
object
version
string
applied_rules
array of object
device_details
object
geolocation_details
object
calculation_time
integer
seon_id
integer
rule_category_details
array of object
Response
{
    "success": true,
    "error": {},
    "data": {
        "id": "67c2810c2de1",
        "state": "DECLINE",
        "fraud_score": 95.75,
        "bin_details": {
            "card_bin": "414141",
            "bin_bank": "VERMONT NATIONAL BANK",
            "bin_card": "VISA",
            "bin_type": "CREDIT",
            "bin_level": "CLASSIC",
            "bin_country": "UNITED STATES",
            "bin_country_code": "US",
            "bin_website": "www.vermontnationalbank.com",
            "bin_phone": "+1 802 476 0030",
            "bin_valid": true,
            "card_issuer": "VISA"
        },
        "version": "v2",
        "applied_rules": [
            {
                "id": "1000702",
                "name": "Phone possible is equal to true",
                "operation": "+",
                "score": 1.11
            },
            {
                "id": "1000682",
                "name": "has_pep_match is not listed on watchlist2",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "P106",
                "name": "Customer is using a datacenter ISP",
                "operation": "+",
                "score": 10.0
            },
            {
                "id": "1000715",
                "name": "Temp ARC 2 category specific rule",
                "operation": null,
                "score": 0.0
            },
            {
                "id": "P110",
                "name": "IP address was found on 4 spam blacklists",
                "operation": "+",
                "score": 4.0
            },
            {
                "id": "1000671",
                "name": "has_sanction_match is equal to true",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000687",
                "name": "has_sanction_match is not listed on watchlist2",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000707",
                "name": "Rule C (User category is equal to VIP)",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000718",
                "name": "Domain creation date is greater than 1 month ago",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000670",
                "name": "has_watchlist_match is equal to false",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000696",
                "name": "Phone number valid is equal to true",
                "operation": "+",
                "score": 1.11
            },
            {
                "id": "P112",
                "name": "Customer is using public proxy",
                "operation": "+",
                "score": 10.0
            },
            {
                "id": "1000716",
                "name": "Temp ARC 2",
                "operation": "+",
                "score": 30.0
            },
            {
                "id": "1000713",
                "name": "Temp ARC category specific rule",
                "operation": null,
                "score": 0.0
            },
            {
                "id": "1000699",
                "name": "Phone country is equal to HU",
                "operation": "+",
                "score": 1.11
            },
            {
                "id": "E123",
                "name": "Email is not similar to user full name",
                "operation": "+",
                "score": 1.0
            },
            {
                "id": "1000674",
                "name": "Free email is equal to true",
                "operation": "+",
                "score": 1.11
            },
            {
                "id": "1000680",
                "name": "has_crimelist_match is not listed on watchlist2",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "PH100",
                "name": "At least 2 online profiles were found",
                "operation": "+",
                "score": 5.2
            },
            {
                "id": "1000666",
                "name": "has_crimelist_match is equal to false",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000706",
                "name": "Rule B (Affiliate full name is equal to Affiliate Two)",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000692",
                "name": "Sanction list match is equal to true",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000705",
                "name": "Rule A (Affiliate ID is equal to a002)",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000685",
                "name": "has_watchlist_match is not listed on watchlist2",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000698",
                "name": "Phone type is equal to Mobile",
                "operation": "+",
                "score": 1.11
            },
            {
                "id": "1000668",
                "name": "has_pep_match is equal to false",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000708",
                "name": "Rule D (User account status is equal to verified)",
                "operation": "+",
                "score": 0.0
            },
            {
                "id": "1000714",
                "name": "ARC User full name is equal to User full name",
                "operation": "+",
                "score": 30.0
            },
            {
                "id": "1000647",
                "name": "Count if Previous Email address similarity is equal to SIMILAR Email for the same Email domain is greater than 0",
                "operation": "+",
                "score": 0.0
            }
        ],
        "device_details": {
            "os": "MacOS",
            "type": "web",
            "dns_ip": null,
            "source": "js-5.8.0",
            "adblock": true,
            "browser": "FIREFOX10",
            "private": true,
            "platform": "MacIntel",
            "font_hash": "09894f345df34ce7ca5b86118ca1bec4",
            "font_list": [],
            "audio_hash": "35.73833039775491",
            "dns_ip_isp": null,
            "font_count": 13,
            "session_id": "90a87abb-91bc-5dc2-96f2-996acb894dd9",
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Firefox/102.0",
            "webgl_hash": null,
            "webrtc_ips": [ '70.111.37.513', '0.0.0.0'
            ],
            "canvas_hash": "b1f0e02120278dbf75e77cb92980648d",
            "cookie_hash": "b29b21a6ba46b2770bb1737fd6c06c7d",
            "device_hash": "73604e79a0321f57249e82e27273a7a0",
            "device_type": "desktop",
            "plugin_hash": "29b51cf1619fb6943f256c2c6da59432",
            "plugin_list": [
                "PDF Viewer",
                "Chrome PDF Viewer",
                "Chromium PDF Viewer",
                "Microsoft Edge PDF Viewer",
                "WebKit built-in PDF"
            ],
            "window_size": "1600x800",
            "browser_hash": "4c58b2c53ea7489232cddeb897efaf7a",
            "do_not_track": null,
            "java_enabled": false,
            "plugin_count": 5,
            "webgl_vendor": null,
            "webrtc_count": 2,
            "battery_level": 44,
            "device_ip_isp": null,
            "device_memory": null,
            "flash_enabled": false,
            "social_logins": [],
            "touch_support": false,
            "cookie_enabled": true,
            "dns_ip_country": HU,
            "accept_language": [],
            "browser_version": "102.0",
            "region_language": "en-US",
            "region_timezone": "+00:00",
            "battery_charging": null,
            "webrtc_activated": true,
            "device_ip_address": "15.130.507.00",
            "device_ip_country": HU,
            "screen_resolution": "1600x800",
            "screen_color_depth": 24,
            "screen_pixel_ratio": 1,
            "hardware_concurrency": 2,
            "screen_available_resolution": "1600x800"
        },
        "calculation_time": 2327,
        "seon_id": 12602,
        "ip_details": {
            "ip": "1.2.3.4",
            "score": 24.0,
            "country": "AU",
            "state_prov": "Queensland",
            "city": "Brisbane",
            "timezone_offset": "+10:00",
            "isp_name": "APNIC Pty Ltd",
            "latitude": -27.48203,
            "longitude": 153.01358,
            "type": "DCH",
            "open_ports": [],
            "tor": false,
            "vpn": false,
            "web_proxy": false,
            "public_proxy": true,
            "spam_number": 4,
            "spam_urls": [
                "zen.spamhaus.org",
                "xbl.spamhaus.org",
                "noptr.spamrats.com",
                "dyna.spamrats.com"
            ]
        },
        "email_details": {
            "email": "testing.fv2@gmail.com",
            "score": 2.1100000000000003,
            "deliverable": true,
            "domain_details": {
                "domain": "gmail.com",
                "tld": ".com",
                "registered": true,
                "created": "1995-08-13 04:00:00",
                "updated": "2022-07-11 09:25:59",
                "expires": "2023-08-12 04:00:00",
                "registrar_name": "MarkMonitor Inc.",
                "registered_to": "Google LLC",
                "disposable": false,
                "free": true,
                "custom": false,
                "dmarc_enforced": true,
                "spf_strict": true,
                "valid_mx": true,
                "accept_all": false,
                "suspicious_tld": false,
                "website_exists": true
            },
            "account_details": {
                "apple": {
                    "registered": false
                },
                "ebay": {
                    "registered": false
                },
                "facebook": {
                    "registered": false,
                    "url": null,
                    "name": null,
                    "photo": null
                },
                "flickr": {
                    "registered": false,
                    "username": null,
                    "photo": null,
                    "followers": null,
                    "location": null,
                    "occupation": null,
                    "description": null
                },
                "foursquare": {
                    "registered": null,
                    "bio": null,
                    "photo": null,
                    "profile_url": null
                },
                "github": {
                    "registered": false,
                    "photo": null,
                    "full_name": null,
                    "username": null,
                    "location": null,
                    "company": null,
                    "website": null,
                    "bio": null,
                    "followers": null,
                    "following": null,
                    "twitter": null,
                    "profile_url": null
                },
                "google": {
                    "registered": true,
                    "photo": "https://lh3.googleusercontent.com/a-/ALV-UjWOTudEZsExUfQZU6Bg4YXT4MX_KL1Zg95TXewANRNH",
                    "activity": {
                        "reviews": null,
                        "ratings": null,
                        "photos": null,
                        "videos": null,
                        "answers": null,
                        "edits": null,
                        "places_added": null,
                        "roads_added": null,
                        "facts_checked": null,
                        "published_lists": null,
                        "q_and_a": null
                    },
                    "is_enterprise_user": null,
                    "last_updated": 1679766162
                },
                "gravatar": {
                    "registered": false,
                    "location": null,
                    "name": null,
                    "profile_url": null,
                    "username": null
                },
                "instagram": {
                    "registered": false
                },
                "lastfm": {
                    "registered": false
                },
                "linkedin": {
                    "registered": false,
                    "url": null,
                    "name": null,
                    "company": null,
                    "title": null,
                    "location": null,
                    "website": null,
                    "twitter": null,
                    "photo": null,
                    "connection_count": null
                },
                "microsoft": {
                    "registered": false
                },
                "myspace": {
                    "registered": false
                },
                "pinterest": {
                    "registered": false
                },
                "skype": {
                    "registered": false,
                    "country": null,
                    "country_code": null,
                    "city": null,
                    "gender": null,
                    "name": null,
                    "id": null,
                    "handle": null,
                    "bio": null,
                    "age": null,
                    "language": null,
                    "state": null,
                    "photo": null,
                    "contact_type": null
                },
                "spotify": {
                    "registered": false
                },
                "tumblr": {
                    "registered": false
                },
                "twitter": {
                    "registered": false
                },
                "vimeo": {
                    "registered": false
                },
                "weibo": {
                    "registered": false
                },
                "yahoo": {
                    "registered": false
                },
                "discord": {
                    "registered": false
                },
                "ok": {
                    "registered": false,
                    "city": null,
                    "age": null,
                    "date_joined": null,
                    "full_name": null
                },
                "kakao": {
                    "registered": null
                },
                "booking": {
                    "registered": false
                },
                "airbnb": {
                    "registered": null,
                    "about": null,
                    "created_at": null,
                    "first_name": null,
                    "identity_verified": null,
                    "location": null,
                    "image": null,
                    "reviewee_count": null,
                    "trips": null,
                    "work": null
                },
                "amazon": {
                    "registered": null
                },
                "qzone": {
                    "registered": false
                },
                "adobe": {
                    "registered": false
                },
                "mailru": {
                    "registered": false
                },
                "wordpress": {
                    "registered": false
                },
                "imgur": {
                    "registered": false
                },
                "disneyplus": {
                    "registered": false
                },
                "netflix": {
                    "registered": false
                },
                "jdid": {
                    "registered": null
                },
                "flipkart": {
                    "registered": false
                },
                "bukalapak": {
                    "registered": false
                },
                "archiveorg": {
                    "registered": false
                },
                "lazada": {
                    "registered": false
                },
                "zoho": {
                    "registered": false
                },
                "samsung": {
                    "registered": false
                },
                "evernote": {
                    "registered": false
                },
                "envato": {
                    "registered": false
                },
                "patreon": {
                    "registered": false
                },
                "tokopedia": {
                    "registered": false
                },
                "rambler": {
                    "registered": false
                },
                "quora": {
                    "registered": false
                },
                "atlassian": {
                    "registered": false
                },
                "aboutme": {
                    "registered": false
                },
                "altbalaji": {
                    "registered": false
                },
                "bitmoji": {
                    "registered": false
                },
                "bodybuilding": {
                    "registered": false
                },
                "codecademy": {
                    "registered": false
                },
                "deliveroo": {
                    "registered": false
                },
                "diigo": {
                    "registered": false
                },
                "duolingo": {
                    "registered": false,
                    "full_name": null,
                    "photo": null,
                    "registered_at": null,
                    "country": null,
                    "username": null,
                    "has_recent_activity": null,
                    "learning_language": null,
                    "from_language": null,
                    "email_verified": null,
                    "courses": null
                },
                "eventbrite": {
                    "registered": false
                },
                "firefox": {
                    "registered": false
                },
                "freelancer": {
                    "registered": false
                },
                "gaana": {
                    "registered": false
                },
                "giphy": {
                    "registered": false
                },
                "hubspot": {
                    "registered": false
                },
                "kommo": {
                    "registered": false
                },
                "komoot": {
                    "registered": false
                },
                "nike": {
                    "registered": false
                },
                "plurk": {
                    "registered": false
                },
                "rappi": {
                    "registered": false
                },
                "replit": {
                    "registered": false
                },
                "seoclerks": {
                    "registered": false
                },
                "snapchat": {
                    "registered": false
                },
                "snapdeal": {
                    "registered": false
                },
                "soundcloud": {
                    "registered": false
                },
                "starz": {
                    "registered": false
                },
                "strava": {
                    "registered": false
                },
                "taringa": {
                    "registered": false,
                    "username": null,
                    "photo": null
                },
                "tiki": {
                    "registered": false
                },
                "treehouse": {
                    "registered": false
                },
                "venmo": {
                    "registered": false
                },
                "vivino": {
                    "registered": false
                },
                "vkontakte": {
                    "registered": false
                },
                "wattpad": {
                    "registered": false
                },
                "xing": {
                    "registered": false
                },
                "yandex": {
                    "registered": false
                },
                "adult_sites": {
                    "registered": false
                }
            },
            "breach_details": {
                "haveibeenpwned_listed": false,
                "number_of_breaches": 0,
                "first_breach": null,
                "breaches": []
            }
        },
        "phone_details": {
            "number": 36707770000,
            "valid": true,
            "type": "MOBILE",
            "country": "HU",
            "carrier": "Vodafone Hungary",
            "score": 9.64,
            "account_details": {
                "facebook": {
                    "registered": true
                },
                "google": {
                    "registered": false,
                    "account_id": null,
                    "full_name": null
                },
                "twitter": {
                    "registered": true
                },
                "instagram": {
                    "registered": true
                },
                "yahoo": {
                    "registered": null
                },
                "microsoft": {
                    "registered": true
                },
                "snapchat": {
                    "registered": false
                },
                "skype": {
                    "registered": false,
                    "age": null,
                    "city": null,
                    "bio": null,
                    "country": null,
                    "gender": null,
                    "language": null,
                    "name": null,
                    "handle": null,
                    "id": null,
                    "photo": null,
                    "state": null
                },
                "whatsapp": {
                    "registered": true,
                    "photo": null,
                    "last_seen": null,
                    "about": null,
                    "last_active": 1610222677
                },
                "telegram": {
                    "registered": null,
                    "photo": null,
                    "last_seen": null
                },
                "viber": {
                    "registered": null,
                    "photo": null,
                    "last_seen": null,
                    "name": null
                },
                "kakao": {
                    "registered": null
                },
                "ok": {
                    "registered": false,
                    "age": null
                },
                "zalo": {
                    "registered": false,
                    "date_of_birth": null,
                    "name": null,
                    "uid": null
                },
                "line": {
                    "registered": null,
                    "name": null,
                    "photo": null
                },
                "flipkart": {
                    "registered": false
                },
                "bukalapak": {
                    "registered": false
                },
                "jdid": {
                    "registered": null
                },
                "altbalaji": {
                    "registered": false
                },
                "shopclues": {
                    "registered": false
                },
                "snapdeal": {
                    "registered": false
                },
                "tiki": {
                    "registered": false
                },
                "vkontakte": {
                    "registered": true
                },
                "weibo": {
                    "registered": false
                }
            }
        },
        "geolocation_details": {
            "user_billing_distance": 15265.747,
            "user_shipping_distance": 15162.088,
            "billing_shipping_distance": 7677.429,
            "ip_user_distance": 10210.516,
            "ip_billing_distance": 12056.986,
            "ip_shipping_distance": 5019.496
        },
        "aml_details": null
    }
}

JavaScript Agent v5

You can integrate our optional device fingerprinting module directly into a web app, by using our JavaScript agent. Please, use our CDN hosted script to ensure you always load the latest available version.

  1. Include the JavaScript Agent for example inside the <head> tags of your website or web app. You can also lazy-load it or execute it upon specific actions (e.g. clicking on Login, Payment, and Registration buttons, before calling the API). In this case, you must ensure that the module has been loaded successfully before invoking its methods.
  2. Set a unique session_id for your client using the seon.config() function.
  3. Call the seon.getBase64Session() function to get the encrypted payload for the device.
  4. Send the returned session payload string to your backend and add to the session property in your Fraud API request. The Fraud API call should be still executed if the session is missing, due to a non-executed JS snippet. Tip: Add timeout to JS and utilize Fraud API call after.

All the device fingerprinting data will be available in the response of the Fraud API, and accessible on the Admin Panel of the Transactions Details page.

 

 

Configuration parameters

To configure the JavaScript module, you need to call seon.config() function:

JSON Attributes

Required
host
no
session_id
yes
audio_fingerprint
no
canvas_fingerprint
no
webgl_fingerprint
no
font_list
no
onSuccess
no
onError
no
max_proxy_delay
no

 

 

Integration

Fingerprinting can be triggered by seon.getBase64Session() function. After collecting all the available information, the function returns an encrypted base64 encoded payload.

 

 

 

 

Payload

SEON JavaScript library collects device information and prepares an encrypted payload to use in Fraud API. The information on client side is not readable, we’ll reveal in the Fraud API response and on the Admin Panel. Some fields can be null, if the actual browser does not support or return data for that specific data point. In every other case, data types are preserved. Find a sample payload on the right side.

 

 

Common issues

  • The session is provided in the Fraud API request, but the device_details is null in the response and there is no device information on the Transaction details page. - This means the encrypted payload is corrupted. Please look into your integration and check again.
  • The v4 version of the JavaScript Agent is not compatible with the Fraud API v1, we highly recommend to upgrade because of security and performance reasons.
  • If you use CSP (Content Security Policy) headers on your site, you must allow the following domains in connect-src directive for full functionality based on your host configuration.

    Default: *.seondnsresolve.com
    seondf.com: *.seondfresolver.com
    deviceinf.com: *.deviceinfresolver.com
    getdeviceinf.com: *.getdeviceinfresolver.com
<html>
  <head>
    ...
    <script src="[source_url]"></script>
  </head>
  <body>
    ...
  </body>
</html>

You can use the following script source URLs ([source_url]):

  • https://cdn.seondf.com/js/v5/agent.js
  • https://cdn.deviceinf.com/js/v5/agent.js
  • https://cdn.getdeviceinf.com/js/v5/agent.js

 

 

 

 

 

 

 

 

 

 

 

 

seon.config({ 
    host: "seondf.com",
    session_id: "[session_id]", 
    audio_fingerprint: true, 
    canvas_fingerprint: true, 
    webgl_fingerprint: true, 
    max_proxy_delay: 1000;
	onSuccess: function(message) { 
    	console.log("success", message); 
	},
	onError: function(message) { 
    	console.log("error", message); 
	} 
});
seon.getBase64Session(function(data) {
  if (data) {
    console.log("Session payload", data);
  } else {
    console.log("Failed to retrieve session data.");
  }
});

iOS SDK

You can integrate our device fingerprinting module directly into iOS mobile apps, by using our SDK found on GitHub. It will collect information based on the user’s software and hardware configuration.

  • The SDK returns an encrypted, base64 encoded string to add in the session property in the Fraud API request. It isn’t permitted to access or modify the payload on the clients.
  • JSON structured device details will be returned in the Fraud API response.
  • Latest version available: 5.1.1 Details on previous versions here.

JSON Attributes

Type
type
string
source
string
session_id
string
accessories_count
integer
audio_mute_status
boolean
audio_volume_current
integer
battery_charging
boolean
battery_level
integer
can_send_mail
boolean
can_send_text
boolean
cpu_count
integer
cpu_type
string
device_adid
string
device_hash
string
device_name
string
device_orientation
string
device_udid
string
icloud_ubiquity_token
string
ios_device_name
string
ios_version
string
is_biometrics_enabled
boolean
is_emulator
boolean
is_ios_app_on_mac
boolean
is_jailbroken
boolean
is_on_call
boolean
is_passcode_enabled
boolean
is_screen_captured
boolean
kernel_arch
string
kernel_name
string
kernel_version
string
network_config
string
pasteboard_hash
string
physical_memory
unsigned long
region_country
string
region_language
string
region_timezone
string
screen_brightness
integer
screen_height
integer
screen_width
integer
system_uptime
integer
timezone_identifier
string
wifi_mac_address
string
wifi_ssid
string
dns_ip
string
dns_ip_country
string
dns_ip_isp
string
device_ip_address
string
device_ip_country
string
device_ip_isp
string
Response
"device_details": {
            "session_id": "somew3irdsessionid",
            "source": "ios-5.0.0",
            "type": "ios",
            "device_ip_address": null,
            "device_ip_country": null,
            "device_ip_isp": null,
            "dns_ip": "84.2.111.000",
            "dns_ip_country": "HU",
            "dns_ip_isp": "Magyar Telekom",
            "accessories_count": 0,
            "audio_mute_status": false,
            "audio_volume_current": 50,
            "battery_charging": false,
            "battery_level": 100,
            "cpu_count": 6,
            "cpu_type": "ARM_64E",
            "device_adid": "00000000-0000-0000-0000-000000000000",
            "device_udid": "F5067339-7455-4D4C-B065-D08E7B5D608F",
            "device_hash": "89dfae458d0435b218973fb69e24b55a4831e01940ca1692ce902fc0682d877b",
            "device_name": "iPhone SE 3rd Gen",
            "device_orientation": "Portrait",
            "icloud_ubiquity_token": "27267025 f42df654 ea1018da 6d1d993b 81d8a1c3",
            "ios_device_name": "iPhone",
            "ios_version": "17.0",
            "is_emulator": false,
            "is_jailbroken": false,
            "kernel_arch": "arm64",
            "kernel_name": "Darwin",
            "kernel_version": "21A5326a",
            "network_config": "WIFI",
            "pasteboard_hash": "63e7d95aa925313d14096883ccd5c530789dab115fe9dc4d6439309fcf222fee",
            "physical_memory": 4077944832,
            "region_country": "HU",
            "region_language": "en",
            "region_timezone": "+02:00",
            "screen_brightness": 34,
            "screen_height": 1334,
            "screen_width": 750,
            "system_uptime": 1694425396,
            "wifi_mac_address": "a2:b5:3c:cc:d1:47",
            "wifi_ssid": "free_wifi_2345",
            "is_biometrics_enabled": true,
            "is_passcode_enabled": true,
            "is_ios_app_on_mac": false,
            "is_on_call": false,
            "is_screen_captured": false,
            "can_send_mail": false,
            "can_send_text": true,
            "timezone_identifier": "Europe/Budapest"
        }

Android SDK

You can integrate our device fingerprinting module directly into Android mobile apps, by using our SDK found on GitHub. In the repo you will also find more details about the integration like requirements and samples. It will collect information based on the user’s software and hardware configuration.

  • The SDK returns an encrypted, base64 encoded string to add in the session property in the Fraud API request. It isn’t permitted to access or modify the payload on the clients.
  • JSON structured device details will be revealed in the Fraud API response.
  • Latest version available: 6.1.2 Details on previous versions here.

JSON Attributes

Type
type
string
source
string
session_id
string
android_id
string
android_version
string
app_guid
string
audio_mute_status
boolean
audio_volume_current
integer
battery_charging
boolean
battery_health
string
battery_level
integer
battery_temperature
float
battery_voltage
integer
biometric_status
boolean
bootloader_state
string
build_device
string
build_id
string
build_manufacturer
string
build_model
string
build_number
string
build_time
integer
carrier_country
string
carrier_name
string
cpu_count
integer
cpu_hash
string
cpu_speed
double
cpu_type
string
developer_options_state
string
device_hash
string
device_cellular_id
string
device_name
string
device_orientation
string
free_storage
integer
gsf_id
string
has_proximity_sensor
boolean
interfering_apps
array of string
is_click_automator_installed
boolean
is_emulator
boolean
is_keyguard_secure
boolean
is_nfc_available
boolean
is_nfc_enabled
boolean
is_on_call
boolean
is_remote_control_connected
boolean
is_rooted
boolean
is_screen_being_mirrored
boolean
kernel_arch
string
kernel_name
string
kernel_version
string
last_boot_time
integer
network_config
string
pasteboard_hash
string
physical_memory
integer
region_country
string
region_language
string
region_timezone
string
remote_control_provider
string
screen_brightness
integer
screen_height
integer
screen_scale
integer
screen_width
integer
sensor_hash
string
system_uptime
integer
timezone_identifier
string
total_storage
integer
usb_cable_state
string
usb_debugging_state
string
wifi_mac_address
string
wifi_ssid
string
dns_ip
string
dns_ip_country
string
dns_ip_isp
string
device_ip_address
string
device_ip_country
string
device_ip_isp
string
Response
"device_details": {
      "session_id": "52f10e47-bd35-465b-81a4-7228a9a11c14",
      "source": "android-6.0.2",
      "type": "android",
      "device_ip_address": "213.253.227.38",
      "device_ip_country": "HU",
      "device_ip_isp": "Invitech ICT Services Kft.",
      "dns_ip": "172.253.206.35",
      "dns_ip_country": "PL",
      "dns_ip_isp": "Google LLC",
      "android_id": "027925f5453a4e32",
      "android_version": "32 (12)",
      "app_guid": "5e24349e-ccf0-4ae9-9307-4e2705159da3",
      "audio_mute_status": true,
      "audio_volume_current": 0,
      "battery_charging": true,
      "battery_health": "GOOD",
      "battery_level": 100,
      "battery_temperature": 30.3,
      "battery_voltage": 4352,
      "build_device": "sargo",
      "build_id": "SP2A.220505.008",
      "build_manufacturer": "Google",
      "build_number": "SP2A.220505.008",
      "build_time": 1656526244,
      "carrier_country": "HU",
      "carrier_name": null,
      "cpu_count": 8,
      "cpu_hash": "36e6ccfd5027ddea0ac6eadb6668889a907411d6e7a782b9cdfa12641dcda0d0",
      "cpu_speed": 1708.0,
      "cpu_type": "AArch64 Processor rev 12 (aarch64)",
      "device_cellular_id": "70ed86e0320e6af04c6b3fd4835032b125c169e733ab0f34cfa823e22b63b273",
      "device_hash": "f6b99981c47ac75463535a9ae753bba625df430d66fb24742344443a0803272a",
      "device_name": "Google Pixel 3a",
      "free_storage": 35987062784,
      "has_proximity_sensor": true,
      "is_emulator": false,
      "is_rooted": false,
      "kernel_arch": "aarch64",
      "kernel_name": "Linux",
      "kernel_version": "4.9.292-gab4493f31457-ab8272301",
      "last_boot_time": 1693832510,
      "network_config": "WIFI",
      "pasteboard_hash": "df23e7ca3991019ae8878888a2a61cd98ca664cc4281dcd5337ea0e7128256eb",
      "physical_memory": 3678616000,
      "region_country": "US",
      "region_language": "en",
      "region_timezone": "+02:00",
      "screen_brightness": 90,
      "screen_scale": null,
      "screen_height": 2220,
      "screen_width": 1080,
      "sensor_hash": "3822a540d3b84767fe32f4b591425f93004590df33468c1df351cadca83ffd8e",
      "system_uptime": 2987,
      "total_storage": 53646700544,
      "wifi_mac_address": null,
      "wifi_ssid": "STGUEST",
      "biometric_status": "NOT_ENROLLED",
      "bootloader_state": "BOOTLOADER_STATE_LOCKED",
      "build_model": "Pixel 3a",
      "developer_options_state": "DEV_OPTIONS_ENABLED",
      "device_orientation": "Portrait",
      "gsf_id": "3b84721133ea68bc",
      "interfering_apps": [
        "AdControl-AD1",
        "TeamViewer Universal Add-On",
        "Auto Clicker",
        "GC Auto Clicker",
        "App Cloner"
      ],
      "is_click_automator_installed": true,
      "is_keyguard_secure": false,
      "is_nfc_available": true,
      "is_nfc_enabled": true,
      "is_on_call": false,
      "is_remote_control_connected": false,
      "is_screen_being_mirrored": false,
      "remote_control_provider": null,
      "timezone_identifier": "Europe/Budapest",
      "usb_cable_state": "USB_CONNECTED",
      "usb_debugging_state": "USB_DEBUGGING_ENABLED"
    }