Session management and configuration

Updated on 16.01.26
6 minutes to read
Copy link

Overview

Proper session management is key to a smooth user experience and reducing abandonment, while thoughtful configuration helps you fine-tune your risk strategy.

Understanding these components is key to fine tuning your verification workflow, reducing abandonment rates and making data-driven decisions to fine-tune your risk strategy.

 

Key operational benefits

BenefitDescription
Flexible user journeysPre-initialized sessions and automatic session transfer allow you to design flexible, non-linear verification flows that accommodate different user contexts and devices.
Reduced user frictionBy saving progress and enabling seamless desktop-to-mobile handoffs, you minimize user frustration and reduce the likelihood of session abandonment.
Granular risk controlConfigurable thresholds for liveness, face match and document checks give you precise control over the trade-off between security and user experience.
Data-driven optimizationActionable operational metrics provide the insights needed to monitor performance, identify bottlenecks and make informed decisions when tuning your configuration.

 

Session management

SEON provides a robust session management system to handle the entire lifecycle of a verification.

 

Pre-initialized sessions

You can create verification sessions in advance and share a unique, secure URL with your users. This is ideal for asynchronous workflows, such as sending verification links via email or SMS.

  • 7-Day validity: Sessions remain valid for 7 days, giving users ample time to complete the verification.
  • 5 retries: Users are allowed a maximum of 5 retries within a single session if they make a mistake.
  • Saved progress: If a user is interrupted, their progress is automatically saved, allowing them to resume where they left off.
  • URL recovery: If a user loses their unique link, it can be re-copied from the session details page in the SEON Admin Panel.

 

Session transfer

To ensure a seamless experience, SEON automatically handles cases where users start on an incompatible device (e.g., a desktop computer without a camera).

1. A QR code is automatically generated on the desktop screen.
2. The user scans the QR code with their mobile device, creating a transferred session that is valid for 1 hour.
3. The mobile session resumes at the exact step where the user left off.
4. Once the mobile verification is complete, the results are automatically synced back to the original session and the user can continue on their desktop.

 

Session outcomes

Upon completion, every verification session is assigned a clear and actionable outcome. The primary statuses are:

  • PENDING: The verification process is currently in progress.
  • APPROVE: All required checks were successfully passed.
  • REVIEW: The system could not reach a definitive conclusion and the session requires manual review.
  • DECLINE: One or more checks failed, indicating a high risk of fraud or a non-compliant user.
  • ABANDONED: The user started the verification process but did not complete it within the allowed time.

 

Configuration and tuning

SEON's verification engine is highly configurable, allowing you to tune its performance to match your specific risk appetite and user base.

 

Match level thresholds

You can adjust the sensitivity for individual checks within SEON:

  • Liveness threshold: Controls the strictness of the anti-spoofing detection. A higher threshold is more secure but may be more sensitive to poor lighting or camera quality.
  • Face match threshold: Sets the minimum similarity score required for a successful biometric match between the selfie and the ID photo.
  • Document check thresholds: Adjusts the sensitivity for detecting photocopies, screen captures and other signs of forgery.

 

Configuration principles

Follow these principles when tuning your settings:

1. Start with defaults: SEON's default thresholds represent a balanced approach to risk and user friction and are a great starting point.

2. Loosen cautiously: If you relax a threshold, document the reason and monitor the impact on your metrics. Avoid making multiple changes at once.

3. Consider per-market tuning: Document quality can vary by region. You may need to apply slightly different thresholds for markets with older or lower-quality identity documents.

4. Monitor for drift: Fraud patterns and user behavior change over time. Regularly review your metrics to ensure your configuration remains effective.

Our team can assist with any tuning your organization requires. Reach out to your account manager to adjust your current setup.

 

Operational metrics to track

Focus on these actionable metrics to guide your tuning decisions, rather than abstract academic measures like FRR/FAR.
 

MetricWhat it measuresWhy it matters
Approval rateThe percentage of total sessions that result in a verified identity.This is your primary success metric for frictionless, successful onboarding.
Rejection rateThe percentage of total sessions that are automatically declined.A key indicator of fraud pressure, but a sudden spike could also signal that a threshold is too strict.
Abandonment rateThe percentage of users who start a session but do not complete it.A high rate can signal user experience issues or problems with the capture process.
Forced retry rateThe percentage of users who are asked to re-capture an image.A direct measure of capture quality and a signal that your users may be in a challenging environment (e.g., poor lighting).
Check-level failure distributionA breakdown of which specific checks are failing most often.This is your most important tuning signal, telling you exactly which thresholds may need adjustment.