React Native
Integrating Verisoul in React Native Apps
Verisoul provides a React Native SDK that allows you to implement fraud prevention in your cross-platform mobile applications. This guide covers the installation, configuration, and usage of the Verisoul React Native SDK.
Installation
Using NPM
Using Yarn
EXPO
The Verisoul SDK is not supported in Expo Go, so if you are using the managed workflow, you will need to use Expo’s custom development client. If you already have it set up, you can skip to step 3.
- Open the command line and navigate to your Expo project directory. Then, run the following command to install expo-dev-client.
- Modify the scripts section in your package.json file to use expo-dev-client, it should look like this.
- Then install Verisoul SDK using npm or yarn
- If an exception occurs during the build stating that the
ai.verisoul:android
package cannot be downloaded, add the following Maven repository inside yourandroid/build.gradle
file:
Usage
1. Initialization
When this is called Verisoul library will be initialized, initial data together with session ID will be gathered and uploaded to Verisoul backend.
2. Get Session ID
Once the minimum amount of data is gathered the session ID becomes available. The session ID is needed in order to request a risk assessment from Verisoul’s API. Note that session IDs are short lived and will expire after 24 hours. The application can obtain session ID by providing the callback as shown below:
3. Provide Touch Events
Wrap your App With VerisoulTouchRootView
Android
1. Provide Touch Events (Android only)
In order to gather touch events and compare them to device accelerometer sensor data, the app will need to provide touch events to Verisoul. you need to Edit th MainActivity
, to override dispatchTouchEvent
function and pass the data to Verisoul like shown below.
iOS
Capabilities
To fully utilize VerisoulSDK, you must add the App Attest
capability to your project. This capability allows the SDK to perform necessary checks and validations to ensure the integrity and security of your application.
Update your app’s entitlements file:
Update the privacy manifest file
Next Steps
- Learn about Backend Integration for API implementation
- See Integration Best Practices
- See the React Native Sample App for a complete implementation
- See Verisoul’s NPM page React Native SDK