- Liveness score:
0
to1
. - Liveness result:
YES
orNO
. - Facial analysis metrics: Detailed indicators to support accurate detection.
Response fields and description
The Face Liveness utilises a diverse set of facial biometrics and image quality parameters to ensure accurate liveness detection, including:Feature field | Description |
---|---|
liveness | Indicates whether a live person is present or not. |
liveness_score | Gives the confidence score of liveness detection. |
gender | Gives the detected gender and its confidence. |
age_range | Gives an estimate of the age range, specifying the minimum and maximum values. |
eye_wear | Indicates the presence of eyewear. |
face_occluded | Indicates if the face is partially or fully blocked. |
quality | Image quality metrics, such as blur, brightness, and exposure, are analysed. |
pose | Detects the alignment of the face, indicating whether it is positioned to the left, right, or centre. |
eyes_open | Indicates if the eyes are open. |
Why choose Cashfree
Cashfree’s Face Liveness offers the following benefits:- Anti-spoofing tested: Actively detects and prevents real-world spoofing attacks, helping organisations ensure security and meet compliance requirements.
- Handles challenging image conditions: Built to perform reliably in real onboarding scenarios, including poor lighting, blurry selfies, partial faces, and off-angle captures.
- Real-time user feedback: Enables merchants to deliver actionable feedback on issues such as closed eyes, sunglasses, multiple faces in frame, or off-angle captures, boosting the success rate of subsequent face matching.
Use cases
You can use Face Liveness across the following industries for real-time identity detection:Business type | Use case |
---|---|
Fintech | Ensures live user presence during high-value transactions, digital KYC, and withdrawals. |
Banking | Enforces live user presence during onboarding, account opening, and instant loan disbursal. |
Insurance | Authenticate claimants and policyholders to reduce fraudulent claims. |
E-commerce and gaming | Guarantee single-user access to rewards, bonuses, and account withdrawal features. |
Workforce onboarding | Authenticate the identity and physical presence of new hires or gig workers remotely. |
Verify Face Liveness
Follow these steps to verify the Face Liveness in the Merchant Dashboard:- Log in to the Merchant Dashboard.
- Go to the Secure ID Dashboard > Regulated Digital KYC > Face Liveness Check.
- Click on Check Face Liveness and upload the image you want to verify for liveness.
- Click Verify. You will see the Liveness Result and the liveness score, along with detailed information about the image uploaded.

FAQs
How do I verify a user’s identity after the Face Liveness detection?
How do I verify a user’s identity after the Face Liveness detection?
After successfully completing the Face Liveness detection, use the Face Match API to compare the selfie with an official ID document photograph. Cashfree’s Face Match analyses facial features, computes a similarity score, and confirms whether both images belong to the same person.
How can merchants use our API responses to add prompts to improve face capture accuracy?
How can merchants use our API responses to add prompts to improve face capture accuracy?
Merchants can map API responses to simple prompts that guide users in real time. For instance, if the response is face occluded, prompt the user to uncover their face; if multiple faces detected, ask them to remain alone in the frame; and if poor lighting, request better illumination.
How long does the Liveness API take to detect user liveness?
How long does the Liveness API take to detect user liveness?
The Face Liveness detection typically returns results within 2 seconds after the selfie is uploaded.