Additional Information About Verification Failure Reasons

In some cases, it may be important to know in detail why the verification was considered unsuccessful. This is especially important when verifying with a photo of an ID document. The photo may be blurry, in which case it is worth repeating the verification. The reason for the refusal may also be an invalid document, in which case repeating the verification is pointless.

Authologic executes this scenario, returning a failure cause list as a result. Example:

{
  "id": "2161d11b-24ff-1430-8635-e3d4dc138fff",
  "userKey": "ff97b4cc-81f4-413a-8bab-d0bd89da9a1f",
  "url": "https://id.sandbox.authologic.com/c/2161d11b-24ff-1430-8635-e3d4dc138fff",
  "status": "FINISHED",
  "result": {
    "identity": {
      "status": "FAILED",
      "errors": ["SCAN_DOCUMENT_NOT_DETECTED"],
      "user": {}
    }
  }
}

In the given example, we could not find the document in the photo.

Authologic returns the following grounds for refusal:

• SCAN_GENERIC_ERROR: Other errors associated with scanning documents
• SCAN_DOCUMENT_NOT_DETECTED: Document not detected in the picture
• SCAN_DOCUMENT_TYPE_MISMATCH: given a different type than the actual scanned document
• SCAN_DOCUMENT_EXPIRED: The expiration date of the document passed
• SCAN_DOCUMENT_SIDE_MISMATCH: Document page not shown
• SCAN_DOCUMENT_NOT_SUPPORTED: This document type is not supported by the vendor
• SCAN_DOCUMENT_TOO_BLURRY: Document photo too blurry
• SCAN_DOCUMENT_COUNTRY_MISMATCH: The country selected by the user does not match the document
• SCAN_DOCUMENT_DAMAGED: The document is corrupted in some way
• SCAN_DOCUMENT_NOT_FULLY_VISIBLE: Document not fully visible
• SCAN_DOCUMENT_READ_FAILED_ID: Could not read document number
• SCAN_DOCUMENT_READ_FAILED_NATIONAL_ID: Failed to read user ID
• SCAN_DOCUMENT_READ_FAILED_FIRSTNAME: Failed to read name
• SCAN_DOCUMENT_READ_FAILED_LASTNAME: Could not read name
• SCAN_DOCUMENT_READ_FAILED_FULLNAME: Could not read full name
• SCAN_DOCUMENT_READ_FAILED_ADDRESS: Could not read address
• SCAN_DOCUMENT_READ_FAILED_ISSUE_DATE: Failed to read document issue date
• SCAN_DOCUMENT_READ_FAILED_EXPIRY_DATE: Failed to read document expiration date
• SCAN_DOCUMENT_READ_FAILED_BIRTHDATE: Date of birth could not be read
• SCAN_DOCUMENT_DATA_INCONSISTENCY: The data in the document is inconsistent. For example, the dates in the document are not logically consistent
• SCAN_DOCUMENT_MRZ_NOT_DETECTED: The document MRZ data could not be found
• SCAN_DOCUMENT_MRZ_READ_FAILED: Could not read document MRZ data
• SCAN_DOCUMENT_PROBABLY_FAKE: The document may be fake
• SCAN_DOCUMENT_LOW_QUALITY: The quality of the scanned document is too low
• SCAN_DOCUMENT_WRONG_ADDRESS: The address does not match the one in the database
• SCAN_DOCUMENT_UNIQUE_DOCUMENT: The uniqueness of the document is not confirmed
• SCAN_DOCUMENT_DATA_MISMATCH: User data does not match the data in the documents
• SCAN_FACE_TOO_MANY_PEOPLE: More people have been detected in the photo
• SCAN_FACE_TOO_BLURRY: Photo of the face is too blurry
• SCAN_FACE_NOT_DETECTED: No face detected on the photo
• SCAN_FACE_UNCERTAIN: The face cannot be confirmed to match the photo
• SCAN_FACE_MISMATCH: The face does not match the face in the photo
• SCAN_FACE_PROBABLY_FAKE: The face cannot be confirmed to match the photograph
• ABANDONED: User abandoned the verification process
• ABANDONED_AFTER_PROCESSED: User abandoned the verification process after the data was processed
• FRAUD_SUSPICION: Suspected fraud
• INSUFFICIENT_AGE - User has insufficient age to perform operation requested by identity service provider
• INSUFFICIENT_PRIVILEGES - The user has insufficient privileges to perform operation requested by identity service provider e.g. user has an account with limited access
• ELECTRONIC_DOCUMENT_ACCESS_ERROR - Failed to read the electronic layer of the document or wrong PIN number provided
• BANK_NO_ACCOUNTS_SHARED - The user has not selected an account on the bank's side or the accounts have not been made available
• NO_DATA_SHARED - User authentication or authorization process has not been completed based on a user action e.g. user rejected to share personal data, user cancelled process on identity provider side
• NO_IDENTITY_FOUND - The end user does not have an identity that matches the assumptions made by the identity provider e.g. user not eligible
• NO_USER_FOUND - The user account was not found by identity service provider e.g. the identity provider could not find the user account associated with the specified national identification number
• PROVIDER_SERVER_ERROR - Provider has returned technical error (for example internal server error)
• PROVIDER_UNAVAILABLE - There is a problem with connecting to provider's system(s)
• SOURCE_UNAVAILABLE - There was a problem connecting the provider to the identity source system, e.g. between the provider and the banking system
• PROVIDER_BLACKLIST - The user is blacklisted by the provider
• USER_NOT_AUTHORIZED - The user could not be authorized due to providing wrong password, pin, code, etc.
• ENQUIRY_FORM_NOT_FILLED - The user didn't fill out the requested form fully.
• E_IDENTITY_ACCESS_ERROR - The user could not be authorized due to a problem with accessing the electronic id wallet.
• TOO_MANY_ATTEMPTS - The user attempted to go through the process too many times, resulting in the provider rejecting the verification.
• MANUAL_OPERATION_REQUIRED - Verification process requires manual verification.