This integration method is deprecated

The webview integration approach is no longer being maintained. Please use our native Mobile SDKs for better performance, security, and signal collection:

Verisoul can be integrated into mobile applications using webviews. This approach allows you to implement fraud prevention in React Native, Native iOS, and Native Android apps without requiring a full native SDK integration.

​
Overview

To use Verisoul in mobile apps, you’ll need to run the client SDK in a native webview. The webview can remain completely invisible to the user while still collecting the necessary signals for fraud prevention.

To run the app a Verisoul Project ID is required. Schedule a call here to get started.

​
Usage

The workflow follows the same pattern as the standard web integration except that you will need to listen for a session_id from a native webview.

​
1. Open the webview

Open a native webview and navigate to the following Verisoul URL with a valid project_id and env

​
iOS (Swift)

var webViewUrl : String {
  return "https://js.verisoul.ai/\(env)/webview.html?project_id=\(projectId)"
}

self.wkWebview.load(URLRequest(url: URL(string: webViewUrl)!))

​
Android (Kotlin)

val webViewUrl = "https://js.verisoul.ai/$env/webview.html?project_id=$projectId"
webView.loadUrl(webViewUrl)

​
2. Listen for session_id

Listen for a message from the webview that includes the session_id. The session_id is required to authenticate an account so you’ll need to pass that to your backend in order to call the Verisoul API.

​
iOS (Swift)

// listen for message from the webview
wkWebview.configuration.userContentController = userContentController
wkWebview.configuration.userContentController.add(self, name: nativeToWebHandler)

// parse session_id and pass to your backend
public func userContentController(_ userContentController: WKUserContentController,
                                      didReceive message: WKScriptMessage) {
        guard
            let body = message.body as? [String: String],
            message.name.lowercased() == nativeToWebHandler.lowercased(),
            let sessionId = body["session_id"]
  
            // pass to your backend
            // ...
        else {
            return
        }
}

​
Android (Kotlin)

// Set up JavaScript interface
webView.addJavascriptInterface(WebAppInterface(this), "Android")

// JavaScript interface class
private class WebAppInterface(private val context: Context) {
    @JavascriptInterface
    fun receiveSessionId(sessionId: String) {
        // Pass sessionId to your backend
        // ...
    }
}

// Enable JavaScript
webView.settings.javaScriptEnabled = true

​
3. Close the webview

Upon retrieving the session_id and authenticating the session you can close the webview.

​
iOS (Swift)

wkWebview.removeFromSuperview()

​
Android (Kotlin)

webView.removeAllViews()
webView.destroy()