Browser Integration

Flow version supported: v1.2 (or earlier)

Redirect users to a launch URL to run the identity verification flow directly in their browser.

Prerequisites

  • Generate a launch URL by calling the Initiate Flow API
  • Configure a redirect URL where users return after the flow completes

How It Works

The browser integration uses a redirect-based flow:

  1. Your application calls the Initiate Flow API and receives a launch URL.
  2. Redirect the user's browser to the launch URL to start the verification flow.
  3. The user completes the flow on the hosted page.
  4. After the flow completes, fails, or the user exits, they are redirected back to your configured redirect URL with query parameters indicating the outcome.

Handling the Redirect

When the user is redirected back to your application, inspect the query parameters appended to the redirect URL to determine the flow result and take the appropriate action (e.g., show a confirmation screen, prompt a retry, or log the outcome).

📄

For the full list of query parameters and status codes returned during redirection, refer to the Partner Redirection document.