SEON user docs logoSEON user docs logoSEON user docs logo
Search input icon

Geofence API

Our standalone Geofence API is designed to work seamlessly with our device intelligence SDKs, providing detailed analysis of a device's geolocation relative to predefined geofences. It ensures accurate validation of device data, delivering reliable location information that meets compliance standards. The API offers insights into the device's location behavior, allowing businesses to better understand and manage geofence interactions for enhanced security and operational efficiency.

Good to know

  • To use the Geofence API the integration of the latest Device Intelligence SDKs is required.
  • Minimum SDK level is required for Geofence API compliance
    • JavaScript 6.4.0 or v6-latest
    • Android 6.6.0+
    • iOS SDK 5.5.0+
  • The SDK integration of Behavior Signals for fingerprint generation is required for more precise RAT detection on desktop environments.
  • Collecting consent and necessary permissions from the user for location tracking is required.
  • The SDK indicates if it encountered an error in the collection of permissions, behavior data or location. In the case of these errors, it is necessary to handle them in the customer integration and submit the request only in case of successful session generation.
  • Geofence API is a standalone API but it could be connected with Fraud API transactions using the same user ID. In this case the connected transaction will be displayed on the Admin Panel.
  • For geolocation data our standard 1 year data retention policy is applied. If you need a longer storage time, please contact support@seon.io.

Request

 

Request Attributes

TypeRequired
user_id
stringyes
device_ip
stringyes
geofence_id
stringyes
bet_id
stringno
session
stringyes

 

HTTP Endpoint

POST

https://geofence-api.eu-west-1-main.seondev.space/api/geofence/v1
Python
Generic
Generic

Response

The endpoint returns JSON structured response.

JSON Attributes

Type
allow
boolean
request_id
string
integrity
object
location
object
Response
{
 "allow": false,
 "request_id": "23a16b15095b6d23df",
 "integrity": {
  "allow": false,
  "proxy": true,
  "vpn": false,
  "ip_mismatch": true,
  "location_mismatch": false,
  "impossible_travel": false,
  "compromised": false,
  "remote_access": false
 },
 "location": {
  "allow": true,
  "country": "BR",
  "region": "BR-MT",
  "latitude": -13.4567,
  "longitude": -45.6789,
  "accuracy": 10,
  "created_at": "2024-10-04T14:35:52.905Z"
 }
}

Integrating Device Intelligence SDKs

Integrating the device fingerprinting module can be done on web and mobile platforms. For web applications, use the JavaScript agent through a CDN-hosted script to ensure the latest version is loaded.

For web, iOS and Android SDKs are available on GitHub, where you can find documentation, integration requirements, and code samples. All SDKs gather detailed data on the user’s hardware and software configurations, helping to ensure comprehensive device profiling and security across different platforms.

It is important to note that geolocation checks are not performed periodically by default. The responsibility lies with the customer to determine when a user should undergo geolocation validation based on their specific requirements or use cases.

Do you have any questions?

Contact us