IAL2 Verification Flow - Sandbox

Overview

b.well integrates with Kantara certified IAL2 vendors to enable IAL2-compliant identity proofing for b.well clients. This workflow allows end users to verify their identities securely through a WebView flow, with minimal intervention from client apps for a frictionless experience.

Setup Requirements

Integrating the identity verification flow is simple and requires minimal code changes to your codebase to fully support this workflow.

Important: Replace all Webview references with platform-specific alternatives:

• Android: Android Custom Tab
• iOS: ASWebAuthenticationSession

Integration Steps

1. Deeplink Configuration

   • Supply b.well with the mobile application deeplink
   • Format: myapp://callback
   • Note: Universal links are also acceptable

2. SDK Integration

   • Prepare your codebase to handle the new WebView* (see note above) implementation
   • Implement the SDK method to initiate the verification process

3. Callback Handling

   • b.well's backend will redirect to the provided callback
   • Callback includes a parameter indicating success or failure

4. Verification Status

   • Use the Retrieve Identity Verification Status method guide to retrieve the user's IAL2 verification status

Client SDK Integration

Verification Process

1. Call BWellSdk.user.createVerificationUrl(request) to start the session
   1. See Optional Request Parameters below
2. Provide the response to the WebView implementation
3. Handle the callback and close the WebView

Optional Request Parameters

• includeAttributeMatchingCheck(true): This will cause the b.well Backend to validate the demographics returned from the IAL2 vendor against the demographics already on the user's profile. If the demographics do not match above the threshold according to our proprietary Person Matching algorithm, the status returned will be VAL_FAIL.
• callbackUrl: This can optionally be passed into the request or can be configured in the client configuration in the b.well backend