Seamless Face Match Integration with Didit Web SDK
Integrating robust face match capabilities into your web application is crucial for modern identity verification. This guide provides a step-by-step walkthrough of integrating Didit's Web SDK for 1:1 Face Match, ensuring secure.

Effortless IntegrationIntegrating Didit's Web SDK for face matching is a streamlined process, enabling developers to quickly deploy advanced biometric verification without extensive custom coding.
Enhanced SecurityDidit's 1:1 Face Match technology, combined with Passive & Active Liveness, provides a multi-layered defense against identity fraud, ensuring the person presenting the document is its rightful owner.
Configurable WorkflowsDevelopers can customize verification thresholds and warning handling for face match scores, allowing for flexible risk management tailored to specific business needs.
Didit's AdvantageDidit offers a modular, AI-native platform with Free Core KYC, making advanced identity verification accessible and scalable for businesses of all sizes.
Understanding Face Match in Identity Verification
In today's digital landscape, verifying a user's identity is paramount for security, compliance, and trust. Face matching is a critical component of this process, ensuring that the individual interacting with your service is indeed the person they claim to be. Specifically, 1:1 Face Match compares a live image or video of a user against a reference image, typically extracted from their identity document during ID Verification. This powerful biometric check acts as a deterrent against impersonation and deepfake attacks, bolstering the integrity of your user base.
Didit's 1:1 Face Match not only performs this crucial comparison but also generates a similarity score, giving you a quantifiable measure of confidence in the match. This score, ranging from 0-100, is invaluable for automated decision-making and for flagging potentially suspicious verifications for manual review. By integrating face matching, businesses can significantly reduce fraud, comply with KYC (Know Your Customer) regulations, and provide a seamless, secure onboarding experience for legitimate users.
Setting Up Your Project for Didit Web SDK Integration
Integrating Didit's Web SDK for face matching begins with a straightforward setup process. As a developer-first platform, Didit provides clean APIs and comprehensive documentation to get you up and running quickly. First, ensure you have a Didit account and have familiarized yourself with the Didit Business Console. This console will be your hub for managing workflows, viewing verification reports, and configuring settings.
To integrate the Web SDK, you'll typically embed a small JavaScript snippet into your web page. This snippet initializes the SDK and allows you to trigger the face matching flow. Didit's modular architecture means you can integrate just the face match component or combine it with other identity primitives like ID Verification and Passive & Active Liveness detection for a robust, multi-step verification process. The SDK handles the complexities of camera access, image capture, and secure data transmission, allowing you to focus on your application's core logic.
Implementing 1:1 Face Match with Didit's Web SDK
Once your project is set up, implementing the 1:1 Face Match is a matter of calling the appropriate SDK functions. The process generally involves:
- Initiating a Session: Your backend will typically create a verification session with Didit, providing any necessary initial data.
- Launching the Face Match Flow: On your frontend, the Web SDK will guide the user through capturing a live image or video. This often involves liveness detection to ensure a real person is present and not a spoofing attempt.
- Submitting for Comparison: The captured biometric data is securely sent to Didit's backend. Here, Didit's AI-native platform compares the live capture with the reference image (e.g., from an ID document).
- Receiving Results: Your application will receive a callback or webhook with the face match results, including a status (Approved, Rejected, In Review) and a similarity score.
Didit's response structure for face match is detailed, providing not only the score but also temporary URLs for the source and target images (expiring after 60 minutes for security) and any warnings. Warnings such as LOW_FACE_MATCH_SIMILARITY indicate that while a match was attempted, the confidence level was below a configurable threshold, prompting further review or an automatic decline based on your settings. This granular feedback empowers developers to build sophisticated decisioning logic.
Handling Face Match Results and Warnings
The true power of integrating a sophisticated face match solution lies in how you interpret and act upon the results. Didit's 1:1 Face Match report provides a status, a score, and a list of warnings. A high score typically indicates a strong match, while a low score or specific warnings like LOW_FACE_MATCH_SIMILARITY suggest potential issues. Didit allows you to configure thresholds for these scores, enabling automated workflows. For instance, you can set a 'review threshold' where scores below a certain percentage are flagged for manual review by your team, and a 'decline threshold' for automatic rejection if the score is too low.
Beyond scores, Didit's system also provides specific warnings, such as NO_REFERENCE_IMAGE, which automatically declines the verification. These warnings are crucial for understanding the exact reason behind a verification status and for fine-tuning your risk orchestration. By leveraging Didit's modular architecture, you can integrate these results into your custom workflows, ensuring that legitimate users are onboarded quickly while suspicious cases are handled appropriately, whether through manual review or outright rejection. This flexibility is a cornerstone of Didit's approach to identity verification.
How Didit Helps
Didit stands out as the premier choice for face match integration due to its AI-native, developer-first approach. Our 1:1 Face Match and Passive & Active Liveness products are designed to provide industry-leading accuracy and fraud prevention, ensuring that your identity verification processes are robust and reliable. Didit's modular architecture allows you to seamlessly integrate face matching as a standalone component or as part of a comprehensive identity verification workflow, alongside our ID Verification (OCR, MRZ, barcodes), AML Screening & Monitoring, and Proof of Address solutions.
We offer Free Core KYC, eliminating setup fees and making advanced identity verification accessible to businesses of all sizes. Our clean APIs and instant sandbox environment ensure a smooth developer experience, accelerating your time to market. With Didit, you gain an open, modular identity layer that automates trust and orchestrates risk, all while providing structured identity data and global coverage. By choosing Didit, you're not just getting a product; you're gaining a partner committed to securing your digital interactions with cutting-edge technology.
Ready to Get Started?
Ready to see Didit in action? Get a free demo today.
Start verifying identities for free with Didit's free tier.