Additional Validations of the Verification Process
Some strategies perform additional validations on user data. It might be the useful information in case the user data is not valid.
Let's look at an example ended conversation:
{
"id": "c12c1adc-3ff0-4d32-b95c-c593135c903e",
"userKey": "7dfb9ded-c38f-49ae-95e2-307283a0b1f6",
"url": "https://sandbox.authologic.com/c/c12c1adc-3ff0-4d32-b95c-c593135c903e",
"status": "FINISHED",
"result": {
"identity": {
"status": "FINISHED",
"errors": [],
"user": {
"person": {
"ids": {
"nationalId": "02070803629"
},
"info": {
"nationality": "PL"
}
}
},
"checks": [
{
"name": "CONSISTENCY_CHECK",
"result": "FAILED",
"details": {
"field": "PERSON_IDS_NATIONAL_ID",
"reason": "FORMAT_ERROR"
}
}
]
}
}
}
In the example, the result.identity.checks section is visible. This is a list of validations performed on user data.
The following data may appear here:
name: the name of the validatorresult: the result of the validation process. This field may contain one of the following values:ACCEPTED- the validation was performed and the result is positive,FAILED- the validation was performed and the result is negative,ERROR- the validation was performed, but an unexpected error occurred
details: - validation process details. Details may have different properties depending on the validator
Available validators
Below is a list of currently available validators. Please note that the list of validators will be expanded over time. Some validators do not present the result if the result is positive.
| Name | Description | Details |
|---|---|---|
| CONSISTENCY_CHECK | Validates data returned in result.identity.user. | details properties: - field - the name of the validated field. Possible values: PERSON_IDS_NATIONAL_ID (social security number format)- reason - the reason for the negative result. Possible values: FORMAT_ERROR (the field format is incorrect)Validation is not presented if the result is positive. |
| FACE_MATCH | Interactive process of comparing the user's face with a photo from an identity document. | details properties: - matchResult - information whether the face matches the photograph. Possible values: - 0 to 9 for high quality images - 0 to 5 for low quality images - matchError - reason of negative check or an error in verification process. - Possible values: - FACE_MATCH_PROCESSING_ERROR - no face match verification performed,- FACE_MATCH_INVALID_IMAGE - the face was not recognised in the image,- FACE_MATCH_NO_PICTURE - no picture obtained in KYC process - FACE_MATCH_RESULT_ERROR - error obtaining face comparison results,- FACE_MATCH_TECHNICAL_ISSUE - face march process technical issue |
| PICTURE_MATCH | Interactive process of comparing the user's face image with a photo available in provider's resources. | details properties: - matchResult - information whether the face present on reference image matches the face image available in providers resources. Possible values: - 0 to 1 - matchError - reason of negative check or an error in verification process. - Possible values: - PICTURE_MATCH_PROCESSING_ERROR - no picture match verification performed, - FACE_DETECTION_ISSUE - the face was not found in reference image,- REFERENCE_PICTURE_NOT_FOUND - no image found in the verification provider's resources. - PICTURE_QUALITY_ISSUE - reference image or provider's image quality issue,- PICTURE_COMPARISON_ISSUE - provider unable to compare reference image with own resources, - REFERENCE_PICTURE_NOT_AVAILABLE - reference image not available |
Despite our sincere intentions, it is difficult to create perfect technical documentation.
If you have an idea on how to improve this documentation, or you have trouble understanding any section,
please email us at tech-support@authologic.com
Was this page helpful?