SUSPECTED when the document and face checks themselves succeeded, but the system attached one or more fraudTags or mismatchTags to the result. SUSPECTED never appears without at least one of those tags present — it exists specifically to carry that signal to you.
Worked Examples
The same shape repeats every time:autoDocument/autoFace (and manualDocument/manualFace, if reviewed) come back clean, but a tag is present. Only the tag differs.
A Data Mismatch
You created the session withfirstName: "Jon". The document reads “John”.
An Age Policy Flag
You configuredageLimit, and the document’s date of birth puts the client under it.
An AML/Watchlist Hit
AML screening (checkAml) found the client on a PEPs or sanctions list.
A Duplicate Signal
checkDuplicateFaces is enabled, and this selfie matches a face from a previous verification — possibly under a different clientId.
iDenfy Does Not Evaluate SUSPECTED
ForAPPROVED and DENIED, iDenfy’s automated and manual review pipeline commits to a decision on your behalf. SUSPECTED is different by design: iDenfy detects and reports the signal — the specific tag — but does not judge whether that signal disqualifies the user. Whether a name mismatch, an age flag, an AML hit, or a duplicate face should block someone depends on your risk appetite, your jurisdiction, and your product. Those are business decisions only you can make, so iDenfy leaves the result open rather than guessing on your behalf.
Build Your Own Evaluation Procedure
Because iDenfy won’t resolveSUSPECTED for you, treat evaluating it as a required part of your integration, not an edge case you’ll handle manually the first time it comes up:
- Read every tag your configuration can produce — Fraud Tags and Mismatch Tags — and decide, per tag, whether it should auto-approve, auto-deny, or route to manual review.
- Write that decision down as an internal procedure that your team (support, compliance, risk) actually follows, rather than leaving it to ad hoc judgment calls each time a case comes up.
- Decide who is authorized to override a
SUSPECTEDresult, and how — see Resolving a SUSPECTED or DENIED Result for the available mechanisms. - Log the decision against the
scanReffor audit purposes, especially whenever a fraud tag is overridden.
Next Steps
Status Handling
What to do with every overall status, not just SUSPECTED.
Verification Statuses
Full definitions of every tag value.
Resolving False Positives
Clear a tag from the dashboard.
Request Update
Reactivate the token — POA, Risk Assessment, or Questionnaire cases only.