Spot Check
Introduction
Welcome to IDWise's Spot Check Verification product documentation! IDWise Spot Check provides a robust and seamless method to reauthenticate users through selfie images. By utilizing the same biometric data captured during the onboarding phase, this product ensures secure, efficient, and frictionless identity verification for subsequent interactions. This system matches the selfie taken during a spot check against the selfie captured during the onboarding stage to verify user identity with precision and reliability.
Onboarding Journey vs. Spot Check Journey
Onboarding Journey
The onboarding journey involves the initial registration of a user, where their identity is verified through a series of checks, including document verification and biometric capture. This process captures and securely stores key data, such as selfie images and reference numbers, which serve as the baseline for future verification needs.
Spot Check Journey
The Spot Check journey is designed for reauthentication scenarios. It validates the identity of users by comparing their current selfie image against biometric data (i.e Selfie image) from their last accepted onboarding journey.
Info
The spot check will be performed on the latest successful onboarding journeys where its
final_decision
is eitherComplete
orApproved
.
Use Cases
-
Face ID for Relogin:
- Enable users to securely and conveniently reauthenticate using their selfie.
- Provides a faster and more user-friendly alternative to passwords or PINs.
-
Suspicious Activity Validation:
- Trigger selfie-based verification when unusual activity is detected, such as login attempts from unknown devices, location changes, or high-frequency access attempts.
- Ensures that only authorized users gain access in sensitive scenarios.
-
Ghost Driver Detection:
- Mitigate risks in transportation or delivery services by confirming the identity of drivers or personnel through periodic selfie checks.
- Prevent fraud by ensuring that registered individuals are operating under their claimed identity.
Key Benefits
- Enhanced Security: Reduce fraud risk with biometric reauthentication.
- Streamlined UX: Provide a hassle-free and quick verification process.
- Scalable Integration: Easily configure verification flows with minimal disruption to existing systems.
How to Use This Product
1. Configure the Verification Flow
- Access the Flow Builder in the IDWise Admin Portal.
- Create a custom Spot Check flow that includes only the selfie step.
- Save and publish the flow for immediate use.
2. Trigger Selfie Capture
- Utilize the IDWise Standard SDK to initiate the selfie capture step. This step is identical to the one used during the onboarding journey.
- Follow SDK documentation guidelines to ensure proper implementation.
Warning
If no onboarding journey has been accepted, an error will be returned indicating that there is no valid onboarding journey.
- SDK: The
onError
event will be triggered.- API: A Invalid Request error will be returned, with error code
invalid_spot_check_request
3. Pass the Reference Number
- During the spot check process, provide the same reference number that was assigned during the user’s onboarding journey.
- This reference number allows the system to retrieve the last accepted onboardingselfie for comparison against the spot check selfie.
4. Set Up Webhook Notifications
- Configure webhooks to receive real-time notifications for each verification attempt.
- Detailed setup instructions can be found here: Finished Spot Check Webhook.
Additional Features
- Integration with Existing Workflows: Spot Check seamlessly integrates with your existing authentication systems and workflows.
- Customizable Thresholds: Configure the verification thresholds to match your security requirements.
- Scalable Architecture: Supports high volumes of verification requests without compromising performance.
By following these steps and leveraging the unique features of IDWise Spot Check, you can enhance the security and trustworthiness of your platform while maintaining a seamless user experience. For more detailed technical guidance, refer to the IDWise Developer Portal.
Updated 6 days ago