Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.didit.me/llms.txt

Use this file to discover all available pages before exploring further.

Didit’s Biometric Authentication solution provides a streamlined verification experience for returning users. This workflow can be configured to perform a liveness-only check for simple presence verification, or combine liveness with facial recognition for stronger identity confirmation against a stored portrait. This flexibility creates a frictionless experience while maintaining high security standards.

​
Key Features

​
Fast Re-Verification

  • No document scanning required
  • Complete verification in seconds
  • Reduces user friction and abandonment

​
Advanced Security

  • Uses the same neural network architecture as Face Match 1:1
  • Prevents account takeover attempts
  • Includes liveness detection to prevent spoofing

​
Integration Flexibility

  • Available as web-based
  • Configurable matching thresholds
  • Optional Device & IP Analysis for enhanced security

​
How It Works

Session Creation

When you create a biometric authentication session:
  • For workflows with face matching, provide the portrait_image in Base64 (from a previous verification or your own database)
  • If you omit portrait_image, the system performs a liveness-only check
  • The biometric authentication workflow is initialized
{
  "workflow_id": "11111111-2222-3333-4444-555555555555",
  "vendor_data": "user-123",
  "callback": "https://example.com/verification/callback",
  "metadata": { "login_attempt": "2" },
  "portrait_image": "/9j/4AAQSkZJRgABAQEAyQDJAAD/2...Y+QrTcpH/9k="
}

Live Photo Capture

During the authentication process:
CheckDescription
Liveness verificationPrevents spoofing using Passive Liveness or 3D Action & Flash
Image qualitySystem evaluates lighting, positioning, and clarity
Retry guidancePoor quality images are rejected with improvement instructions
Real-time feedbackUser sees positioning guides for optimal capture

Verification & Result Processing

The system processes the verification based on your workflow configuration:
If no portrait_image is provided, the system confirms the user’s liveness. A successful check results in an approved authentication — useful for simple presence verification.
If a portrait_image is provided:
  1. System performs the liveness check first
  2. If liveness passes, compares the new selfie with the stored portrait
  3. A similarity score (0–100%) is generated
  4. Score above your configured threshold → Approved
  5. Score below threshold → Declined
Results are available via API response, Business Console, and webhooks.