seon_sdk_flutter_plugin 1.0.0
seon_sdk_flutter_plugin: ^1.0.0 copied to clipboard
SEON SDK Flutter Plugin to access SEON's Device Fingerprinting SDK for both Android and iOS platforms.
Flutter SEON SDK Plugin #
The official Flutter plugin for integrating SEON's advanced fraud prevention and device fingerprinting capabilities into your Flutter applications. This plugin provides a unified interface to access the SEON SDK for both Android and iOS platforms.
To learn more about device fingerprinting please visit our knowledge base.
The plugin depends on the closed-source SEON SDK binaries. While the Flutter plugin itself is open-source and distributed under the BSD 3-Clause License, the SEON SDK binaries remain proprietary and are subject to their own licensing terms. Please visit https://seon.io/resources/legal-and-security/legal/#terms-of-service for more details.
Platform specific requirements #
Android
- Android 5.0 or higher (API level 21)
- INTERNET permission
- (optional) READ_PHONE_STATE permission for
is_on_call
anddevice_cellular_id
(under API 28) - (optional) ACCESS_WIFI_STATE permission for
wifi_ssid
(under API 27) - (optional) ACCESS_NETWORK_STATE permission for
network_config
for WiFi configurations and READ_PHONE_STATE for cellular data configurations - (optional) ACCESS_FINE_LOCATION (starting from API 29) and ACCESS_COARSE_LOCATION (starting from API 27) permission for
wifi_mac_address
,wifi_ssid
,device_location
* - (optional) ACCESS_BACKGROUND_LOCATION (starting from API 29) permission for to get location updates even if the application is in the background
- (optional) com.google.android.providers.gsf.permission.READ_GSERVICES for
gsf_id
Note: If the optional permissions listed are not available the application, the values collected using those permissions will be ignored. We recommend using as much permission as possible based on your use-case to provide reliable device fingerprint.
*device_location: Please see the Geolocation Integration section for more info
iOS
- iOS 12.0 or higher
- (optional) Access WiFi Information entitlement for
wifi_mac_address
andwifi_ssid
- (optional) Core Location permission for
device_location
*,wifi_mac_address
andwifi_ssid
(starting from iOS 13)
NOTE: If the listed permissions are not available for the application, the values collected using those permissions will be ignored. We recommend using as much permission as possible based on your use-case to provide reliable device fingerprint.
*device_location: Please see the Geolocation Integration section for more info
Using the plugin #
The SDK returns an encrypted, base64 encoded string. In order to receive the device details JSON a Fraud API request has to be made, and the result will be in the response. The base64 encoded string has to be added in the session property in the Fraud API request. It isn’t possible to access or modify the payload on the clients.
final _seonSdkFlutterPlugin = SeonSdkFlutterPlugin();
try {
String? fingerprint =
await _seonSdkFlutterPlugin.getFingerprint("<UNIQUE_SESSION_ID>");
// Set fingerprint as the value for the session property of the Fraud API request.
} catch (e) {
print("Error getting fingerprint: $e");
}
For more details about how to send the fingerprint to our API to receive the device details JSON visit our Fraud API documentation.
Geolocation Integration (Opt-in) #
To enable SEON’s geolocation feature on your account please reach out the customer success team to enable the functionality on your Admin page and your Scoring Engine!
Note: Currently even if the integration has been done correctly there won't be a device_location field in the Fraud API response until the feature flag has been set by our customer success team.
Enable or disable geolocation:
// Prompt the user for the appropriate location permission(s)
// ...
// Must be explicitly enabled to turn on the Geolocation data collection
_seonSdkFlutterPlugin.setGeolocationEnabled(true);
// Optionally set the timeout in milliseconds for the location service
_seonSdkFlutterPlugin.setGeolocationTimeout(1500);
Additional Information #
For more details on SEON's capabilities and how to integrate our services, refer to the official SEON Documentation and the integration guide of the native SDKs: