API Reference
Didit Console
Start typing to search…

Biometric Authentication

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 IP analysis for enhanced security

How It Works

  1. Session Creation

    When you create a biometric authentication session:
    • For workflows that include face matching, you must provide the portrait_image in Base64. This image can be from a previous verification or your own database.
    • If you omit the portrait_image, the system will perform a liveness-only check.
    • The biometric authentication workflow is then initialized.
{
  // Replace with biometric authentication workflow id
  "workflow_id": "11111111-2222-3333-4444-555555555555",
  "vendor_data": "user-123",
  "callback": "https://example.com/verification/callback",
  "metadata": {
    "login_attempt": "2"
  },
  // portrait_image is optional; include it only for face matching
  "portrait_image": "/9j/4AAQSkZJRgABAQEAyQDJAAD/2...Y+QrTcpH/9k="
}

  1. Live Photo Capture

During the authentication process:

  • User takes a new selfie, and a liveness check is performed to prevent spoofing.
  • Our platform offers multiple liveness methods, including Passive Liveness and 3D Action & Flash, to ensure the user is physically present.
  • System evaluates image quality
  • Poor quality images are rejected with guidance for improvement
  • User can retry if needed

  1. Verification and Result Processing

    The system processes the verification based on the workflow configuration:
    • Liveness-Only: If no portrait_image is provided, the system confirms the user's liveness. A successful check results in an approved authentication.
    • Liveness + Face Match: If a portrait_image is provided, the system first performs a liveness check. If successful, it compares the new selfie with the stored portrait.
      • A similarity score (0-100%) is generated.
      • If the score is above your configured threshold, the authentication is approved.
      • If the score is below the threshold, it is declined.
    • Results for all scenarios are available via API, dashboard, and webhooks