Navigate to ID Check

Once you have fetched a valid session token, you can navigate the user to Verisoul’s ID Check URL to complete the verification process.

​

ID Check URL

The ID Check URL is: https://app.{env}.verisoul.ai/ where {env} is:

• prod for production
• sandbox for sandbox

The ID Check URL accepts the following query parameters:

​

On Completion

Once the ID Check session is complete, the user will be sent to the redirect_url configured in the query parameters. By default, ID Check redirects to https://verisoul.ai.

The completed redirect URL will contain the following parameters:

​

Navigation Options

function redirectToIDCheck(sessionId) {
  const redirectUrl = encodeURIComponent(window.location.origin + '/verification-complete');
  const idcheckUrl = `https://app.prod.verisoul.ai/?session_id=${sessionId}&redirect_url=${redirectUrl}`;
  
  window.location.href = idcheckUrl;
}

function redirectToIDCheck(sessionId) {
  const redirectUrl = encodeURIComponent(window.location.origin + '/verification-complete');
  const idcheckUrl = `https://app.prod.verisoul.ai/?session_id=${sessionId}&redirect_url=${redirectUrl}`;
  
  window.location.href = idcheckUrl;
}

import { WebView } from 'react-native-webview';

function IDCheckVerification({ sessionId, onComplete }) {
  const idcheckUrl = `https://app.prod.verisoul.ai/?session_id=${sessionId}&redirect_url=yourapp://verification-complete`;
  
  return (
    <WebView
      source={{ uri: facematchUrl }}
      onNavigationStateChange={(navState) => {
        // Handle redirect back to your app
        if (navState.url.startsWith('yourapp://')) {
          // Extract parameters from URL
          const url = new URL(navState.url);
          const status = url.searchParams.get('status');
          const errorMessage = url.searchParams.get('error_message');
          
          onComplete({ status, errorMessage });
        }
      }}
    />
  );
}

​

Error Handling

Error messages can include:

• invalid_session_id: The session token provided is expired or invalid
• session_id_not_found: No session token was provided
• failed_to_get_camera_permission: The user did not agree to give the browser camera permissions
• failed_to_complete_face_scan: The user was not able to complete the face scan process
• failed_to_process_id_scan: This user was not able to complete the identity document capture process
• failed_to_collect_device_data: The user’s device/network was not able to send device data
• liveness_check_failed: The user did not pass liveness verification

​

Next Steps

After the user completes the ID Check verification, you can verify and enroll the user to implement uniqueness checks or authentication.