Handle identity verification results
Analyze Non-Doc Identity Verification data to clarify rejection and approval reasons.
Once the check is performed, you will receive a webhook with the verification status:
- The
reviewResultobject contains extra information about verification. - The
reviewAnswerfield contains the final verification result, displaying the GREEN or RED status:- GREEN — the applicant has passed Non-Doc Identity Verification and their data has been successfully obtained from the government database.
- RED — the applicant has not passed verification; the
reviewRejectTypeis set toRETRYorFINAL.
The possible reasons of the RED status are:
- Low face match score.
- Lack of information on the applicant (i.e. personal data, selfie) in the database.
Get applicant data
To get a structured view of the applicant data, use this API method with the type parameter set to E_KYC_CHECK.
curl --request GET \
--url 'https://api.sumsub.com/resources/checks/latest?type=E_KYC_CHECK&applicantId=65c607aa36997b590dcdf127' \
Check for obtained data
Make sure that you have received all the necessary information after Non-Doc Identity Verification is complete. The name and date of birth are the basic fields that are always present in the response from the database.
In some cases, however, some additional information may not be available, for example, the address in Brazil might be missing.
In such cases, you can perform an additional check to collect the missing data:
- Use Workflow Builder to request an additional document if some data is missing. For example, request a proof of address document if the address is missing.
- Request a new access token for a different level which contains additional steps. For example, you can collect additional data using a questionnaire.
Clarify rejection reason
For every rejection reason, we have a particular buttonId attached to the applicant or photo. To get a list of rejection reasons based on the applicant ID, use this API method.
| Rejection type | Value | Rejection label | Rejection reason |
|---|---|---|---|
FINAL | fraudulentPatterns_selfieMismatch | SELFIE_MISMATCH | The selfie submitted by the applicant and the selfie from the government database do not match. |
FINAL | ekycReject_notEnoughDataInSource | PROBLEMATIC_APPLICANT_DATA | There is no data nor selfie in the government database. |
FINAL | ekycReject_dataMismatch | PROBLEMATIC_APPLICANT_DATA | The selfie and data submitted by the applicant and the information on this applicant from the database do not match or data found in the database has some issues. |
FINAL | ekycReject_skip | PROBLEMATIC_APPLICANT_DATA | An applicant skips the e-KYC step (SDK only). |
RETRY | selfie_selfieLiveness | BAD_SELFIE | An issue related to Liveness & Face match occurred. |
RETRY | selfie_badFaceComparison | BAD_SELFIEBAD_FACE_MATCHING | Poor face comparison. |
RETRY | ekycRetry_checkUnavailable | CHECK_UNAVAILABLE | The government database is currently unavailable. We couldn't verify the user data with this method. |
Did you know?
When applicants skip or fail Non-Doc Identity Verification, they can be moved to another flow for passing verification using documents.
Updated 2 months ago