Getting started
Statuses and decision reasons
Session statuses, feature statuses and the reasons behind a decision.
#Session status
| Status | Meaning |
|---|---|
Not Started | Created, not opened yet |
In Progress | The user is in the flow |
In Review | Needs a person to decide |
Approved | Passed |
Declined | Failed |
Resubmitted | Sent back to the user to redo some steps |
Expired | Never opened, 7 days after creation |
Abandoned | Started but never submitted |
Each feature in the decision has its own status: Approved, Declined, In Review or Not Finished.
#Decision reasons
| Reason | Meaning |
|---|---|
document_missing | No ID document was captured |
document_expired | The ID has expired |
mrz_unreadable, mrz_checksum_failed | The machine-readable zone could not be read or fails its check digits |
name_mismatch, dob_mismatch | Details differ from the document or from expected_details |
underage, dob_unknown | Below the minimum age, or no date of birth |
document_reused | The same document was used by another user |
selfie_missing, face_mismatch, face_manual | No selfie, selfie does not match, or match needs review |
liveness_failed | The liveness check failed |
poa_missing | Proof of address was required but not given |
sanctions_hit, pep_hit | A sanctions or PEP match |
high_risk_country | The document or address country is on your high-risk list |
blocklist:face, blocklist:document | Matched your blocklist |
list:<kind>, list_watch:<kind> | Matched one of your block or watch lists |
processing_error | Something failed on our side. The session goes to review |
Forensic reasons are prefixed with the file they came from, for example doc_front:file_reused or poa:ela_tamper_regions. Address reasons are listed in Proof of address.