Skip to main content
Didit Raises $7.5M to Build the Infrastructure for Identity and Fraud
Didit
Back to blog
Blog · March 6, 2026

Seamless Face Matching in React Native with Didit's SDK

Implement robust 1:1 face matching in your React Native applications using Didit's powerful SDK. This guide covers installation, integration, and handling verification results, ensuring a secure and user-friendly identity.

By DiditUpdated
seamless-face-matching-in-react-native-with-didits-sdk.png

Effortless IntegrationDidit's React Native SDK simplifies the integration of advanced face matching, liveness detection, and NFC verification into your mobile applications with minimal code.

Robust Security FeaturesBenefit from 1:1 Face Match, Passive & Active Liveness, and ID Verification to ensure the person presenting the document is its legitimate owner, preventing fraud and spoofing attempts.

Configurable Verification WorkflowsCustomize face match thresholds to automatically approve, review, or decline sessions based on similarity scores and risk factors, aligning with your specific business needs and compliance requirements.

Didit's AdvantageDidit provides an AI-native, modular identity platform with a Free Core KYC tier, making enterprise-grade identity verification accessible and scalable for all developers.

In today's digital-first world, secure and seamless identity verification is paramount for mobile applications. Whether you're onboarding new users, securing transactions, or complying with regulatory requirements, ensuring that a user is who they claim to be is critical. Face matching, specifically 1:1 face match, plays a pivotal role in this process by comparing a live user's face against a photo on their identity document.

React Native, with its cross-platform capabilities, offers an excellent framework for building such applications. However, integrating complex biometric verification can be challenging. This is where Didit's React Native SDK comes in, providing a robust, developer-friendly solution for implementing secure face matching directly within your app.

Understanding 1:1 Face Match for Identity Verification

1:1 Face Match is a core component of modern identity verification. It involves comparing two facial images to determine if they belong to the same person. In the context of identity verification, this typically means comparing a real-time selfie or video of a user with the portrait image extracted from their government-issued ID document (e.g., passport, driver's license). The goal is to confirm that the person presenting the document is indeed the document's rightful owner, thereby preventing impersonation and synthetic identity fraud.

Didit's 1:1 Face Match technology goes beyond simple image comparison. It integrates with advanced liveness detection to ensure the user is physically present and not using a spoofing attempt like a photo, video, or deepfake. The process generates a similarity score, indicating the likelihood that the two faces match. This score, combined with configurable thresholds, allows businesses to automate verification decisions or flag suspicious cases for manual review.

Crucially, Didit's solution provides detailed reports, including similarity scores and potential warnings such as LOW_FACE_MATCH_SIMILARITY or NO_REFERENCE_IMAGE, giving you granular control and insight into each verification attempt. For enhanced security, the URLs for face match images are temporary and expire after 60 minutes, minimizing biometric data retention risks.

Integrating Didit's React Native SDK for Face Matching

Integrating Didit's identity verification capabilities into your React Native application is streamlined thanks to our comprehensive SDK. The SDK is designed to provide a seamless user experience, optimal performance, and full access to device capabilities, including NFC for ePassport/eID verification and advanced camera controls for liveness detection.

Installation and Setup

Didit's React Native SDK supports React Native 0.76+ (New Architecture / TurboModules), Node.js 20+, TypeScript 5+, iOS 13.0+ (NFC requires iOS 15+), and Android API 23+ (Android 6.0). For Expo users, installation is simple:

npx expo install @didit-protocol/sdk-react-native

Then, add the plugin to your app.json:

{
  "expo": {
    "plugins": ["@didit-protocol/sdk-react-native"]
  }
}

For React Native CLI projects, you can install via npm:

npm install @didit-protocol/sdk-react-native

And configure your iOS Podfile and Android settings.gradle as specified in the Didit documentation to ensure proper linking of native dependencies. The SDK handles the complexities of camera permissions, NFC reading, and liveness detection out of the box, ensuring a smooth integration process.

Performing a Face Match Session

Once installed, initiating a verification session that includes face matching involves a few steps. Your backend server will first create a verification session with Didit. The Didit React Native SDK then orchestrates the capture of the user's ID document, passive and active liveness checks, and the real-time selfie needed for the 1:1 face match. The SDK guides the user through the process with intuitive prompts, ensuring high-quality captures.

Upon completion, the SDK securely transmits the collected data to Didit's platform for processing. Didit's AI-native engine then performs the 1:1 face match, comparing the extracted ID photo with the live selfie, alongside other checks like ID Verification. The result, including a similarity score and any warnings, is then relayed back to your backend.

Handling Face Match Results and Warnings

Didit's Face Match API returns a detailed report, providing critical information to inform your verification decisions. The core of this report is the face_match object, which includes a status (e.g., 'Approved', 'Rejected', 'In Review'), a numerical score (ranging from 0-100 indicating similarity), and a list of any warnings.

Understanding and configuring how to handle these warnings is crucial for a robust identity verification system. Didit offers configurable settings for various verification issues, allowing you to define review and decline thresholds. For instance, you can set a 'review threshold' where sessions with face match scores below a certain percentage are flagged for manual review, and a 'decline threshold' for scores below which sessions are automatically rejected.

Common warnings include LOW_FACE_MATCH_SIMILARITY, indicating that the facial features don't closely match, and NO_REFERENCE_IMAGE, meaning a reference image was unavailable. Didit's modular architecture allows you to tailor these responses to your specific risk appetite and compliance needs. By leveraging these detailed reports, you can build sophisticated workflows that balance user experience with stringent security requirements.

How Didit Helps

Didit is the AI-native, developer-first identity platform that simplifies the integration of advanced identity verification into any application, including those built with React Native. Our modular architecture allows you to compose verification checks like 1:1 Face Match, Passive & Active Liveness, and ID Verification as needed, ensuring a tailored and efficient solution.

With Didit, you benefit from a Free Core KYC tier, making enterprise-grade identity verification accessible without upfront costs or setup fees. Our AI-native approach ensures high accuracy and fraud detection capabilities, while our developer-first philosophy provides clean APIs, instant sandboxes, and comprehensive documentation for quick integration. Didit's React Native SDK further enhances this by offering an optimized camera experience, NFC verification for ePassports/eIDs, and liveness detection out of the box, delivering the best possible user experience and security for your mobile users.

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.

Infrastructure for identity and fraud.

One API for KYC, KYB, Transaction Monitoring, and Wallet Screening. Integrate in 5 minutes.

Ask an AI to summarise this page
React Native Face Matching: Integrate Didit's SDK.