post https://sandbox.cashfree.com/verification/liveliness
Use this API to verify if the customer is genuine and not a bot. We analyse the facial features of your customer in the picture or a selfie for identification. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | VALID | - |
| 200 | SUCCESS | FACE_NOT_DETECTED | Upload a different image with the individual's face in it. |
| 200 | SUCCESS | MULTIPLE_FACE_DETECTED | Upload a different image with only the individual's face in it. |
| 400 | ERROR | image is missing in the request. | Upload an image in the request. |
| 400 | ERROR | File size exceeded 10MB limit | Upload a file that does not exceed the maximum file size. |
| 400 | ERROR | verification_id can include only alphanum, dot, hyphen and underscores. | Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed. |
| 400 | ERROR | x-client-id is missing in the request. | Enter all the header information in the API request. |
| 400 | ERROR | Client secret belongs to test environment | Enter the correct environment credentials in the request. |
| 401 | ERROR | Invalid clientId and clientSecret combination | Ensure you enter valid x-client-id and x-client-secret information in the API request. |
| 403 | ERROR | IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://docs.cashfree.com/docs/ip-whitelisting-verification | Whitelist the IP address. |
| 409 | ERROR | verification id already exists | Enter a unique verification ID to identify the request. |
| 422 | ERROR | Insufficient balance to process this request | Try again with sufficient balance. |
| 500 | ERROR | something went wrong | Try again after some time. |
| 502 | ERROR | verification attempt failed | Try again after some time. |