Validations & Warnings

List of validations and warnings generated within the API

For every transaction, a series of validations will be performed against the document and/or face image based on your KYC profile settings. One or more warnings may be generated if the validation failed to pass. Each validation component can be enbaled or disabled through your profile, how each validation componenet interact with the final decision can also be configured.

Document and OCR Warnings

CodeSeverityConfidenceDescription
UNRECOGNIZED_DOCUMENTHigh=1Document not recognized.
UNRECOGNIZED_BACK_DOCUMENTMedium=1Back document not recognized.
UNRECOGNIZED_BACK_BARCODELow=1Cannot read barcode from back document, barcode reading requires high resolution focused image.
INVALID_BACK_DOCUMENTHigh=1Document back is invalid.
DOCUMENT_EXPIREDHigh0 ~ 1 (OCR Confidence)Document has already expired.
DOCUMENT_COUNTRY_MISMATCHHigh=1Issuing country discrepancy between front and back document. Front: %s, Back: %s
DOCUMENT_STATE_MISMATCHHigh=1Issuing state discrepancy between front and back document. Front: %s, Back: %s.
DOCUMENT_NAME_MISMATCHHigh=1Name discrepancy between front and back document. Front: %s, Back: %s.
DOCUMENT_DOB_MISMATCHHigh=1Birthday discrepancy between front and back document. Front: %s, Back: %s.
MISSING_EXPIRY_DATEHigh=1Document expiry date is missing or cannot be read.
MISSING_ISSUE_DATEHigh=1Document issue date is missing or cannot be read.
MISSING_BIRTH_DATEHigh=1Birthday information is missing or cannot be read.
MISSING_DOCUMENT_NUMBERHigh=1Document number is missing or cannot be read.
MISSING_PERSONAL_NUMBERHigh=1Personal number or national ID number is missing or cannot be read.
MISSING_ADDRESSMedium=1Address is missing or cannot be read.
MISSING_POSTCODEMedium=1Postcode is missing or cannot be read.
MISSING_NAMEHigh=1Given name or family name is missing or cannot be read.
MISSING_LOCAL_NAMELow=1Localized name is missing or cannot be read.
MISSING_GENDERMedium=1Gender is missing or cannot be read.
MISSING_HEIGHTLow=1Height is missing or cannot be read.
MISSING_WEIGHTLow=1Weight is missing or cannot be read.
MISSING_HAIR_COLORLow=1Hair color is missing or cannot be read.
MISSING_EYE_COLORLow=1Eye color is missing or cannot be read.
MISSING_RESTRICTIONSLow=1Driving license restriction is missing or cannot be read.
MISSING_VEHICLE_CLASSLow=1Driving license vehicle class is missing or cannot be read.
MISSING_ENDORSEMENTLow=1Endorsement is missing or cannot be read.
UNDER_18None0 ~ 1 (OCR Confidence)Document holder is under 18.
UNDER_19None0 ~ 1 (OCR Confidence)Document holder is under 19.
UNDER_20None0 ~ 1 (OCR Confidence)Document holder is under 20.
UNDER_21None0 ~ 1 (OCR Confidence)Document holder is under 21.
NAME_VERIFICATION_FAILEDHigh=1Failed to verify document holder's name against supplied name.
DOB_VERIFICATION_FAILEDHigh=1Failed to verify document holder's birthday against supplied name.
AGE_VERIFICATION_FAILEDHigh=1Failed to verify document holder's age against supplied age range.
ID_NUMBER_VERIFICATION_FAILEDHigh=1Failed to verify ID number against supplied ID number.
ADDRESS_VERIFICATION_FAILEDHigh=1Failed to verify document holder's address against supplied address.
POSTCODE_VERIFICATION_FAILEDHigh=1Failed to verify document holder's postcode against supplied postcode.
TYPE_NOT_ACCEPTEDHigh=1This type of document is not on the accepted document type list.
COUNTRY_NOT_ACCEPTEDHigh=1This document is issued by a country outside of the accepted country list.
STATE_NOT_ACCEPTEDHigh=1This document is issued by a state outside of the accepted state list.
LOW_TEXT_CONFIDENCEMedium0 ~ 1 (1.0 - OCR Confidence)Low text confidence score detected for field %s.
GLARE_DETECTEDLow0 ~ 1The document image contains possible glare.

Biomertic Warnings

CodeSeverityConfidenceDescription
SELFIE_FACE_NOT_FOUNDHigh=1Could not detect face in selfie image.
SELFIE_MULTIPLE_FACESHigh=1Multiple faces detected in selfie image.
DOCUMENT_FACE_NOT_FOUNDHigh=1Could not detect face in document image.
DOCUMENT_FACE_LANDMARK_ERRHigh=1Could not calculate facial landmarks for document photo, the face is too blurry.
SELFIE_FACE_LANDMARK_ERRHigh=1Could not calculate facial landmarks for selfie photo, the face is too blurry.
FACE_MISMATCHHigh0 ~ 1Face mismatch between document photo and selfie photo, similarity score: %.2f.
FACE_IDENTICALMedium0 ~ 1Selfie photo appears to be the exact same photo as document photo.
FACE_LIVENESS_ERRHigh0 ~ 1Selfie photo liveness verification failed.
FACE_MISMATCHHigh0 ~ 1Face mismatch between document photo and selfie photo, similarity score: %.2f.
FACE_IDENTICALMedium0 ~ 1Selfie photo appears to be the exact same photo as document photo.
FACE_LIVENESS_ERRHigh0 ~ 1Selfie photo liveness verification failed.
RECAPTURED_FACEHigh0 ~ 1Selfie photo appears to be recaptured.
INTERNAL_FACE_VERIFICATION_ERRHigh=1Internal server error occurred when verifying faces.

Anti-Forgery Warnings

CodeSeverityConfidenceDescription
RECAPTURED_DOCUMENTMedium0 ~ 1The document is possibly recaptured from a screen.
SCREEN_DETECTEDMedium0 ~ 1The document image contains a screen, monitor or mobile device therefore is possibly recaptured.
IMAGE_FORGERYHigh0 ~ 1The document image possibly contains forged elements which warrants a manual review or rejection.
FEATURE_VERIFICATION_FAILEDHigh=1Document features does not match with official document, the document could be fake, blurry or low resolution.
IMAGE_EDITEDMedium0 ~ 1The %s document image contains exif header indicating that it was edited in %s
FAKE_IDHigh=1The document uploaded is a fake or sample document, not an authentic document.
ARTIFICIAL_IMAGEHigh0 ~ 1Document appears to be created artificially, not a naturally taken photo.
ARTIFICIAL_TEXTMedium0 ~ 1Most texts within the image appears to be created artificially.
TEXT_FORGERYMedium0 ~ 1Possible artificial text modification detected on the following text fragments: %s.
IP_COUNTRY_MISMATCHLow0 ~ 1Inconsistency between user IP address country (%s) and document country (%s).
IMAGE_TOO_SMALLMedium0 ~ 1The document image is too small and unlikely to be a genuine document.
IMAGE_TOO_BLURRYMedium0 ~ 1The document image is too blurry and should be retaken for improved result accuracy.
INVALID_CAMERA_PERSPECTIVEMedium0 ~ 1The document image is not a naturally taken photo using a camera, it could be scanned or computer generated.
CHECK_DIGIT_FAILEDHigh=1The document is not a valid document because %s contains invalid check digit.
BLACK_WHITE_DOCUMENTMedium=1The document appears to be black & white photocopy.
PHYSICAL_DOCUMENT_MISSINGHigh=1Could not detect physical card or passport object.

AML/PEP Warnings

CodeSeverityConfidenceDescription
AML_SANCTIONMedium0 ~ 1Potential match from AML sanction database.
AML_CRIMEMedium0 ~ 1Potential match from AML crime database.
AML_PEPMedium0 ~ 1Potential match from AML politically exposed person database.

πŸ“˜

Threshold Levels

Please refer Thresholds for more details on what threshold values ranges are available and their relevant triggering Code in case the threshold barrier is broken.