Webview

Integrating Verisoul in mobile app webviews

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:

• Android Integration
• iOS Integration
• React Native Integration
• Flutter Integration

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()