Fastfail

Ensure submitted documents meet basic requirements before full verification.

Fastfail is a pre-verification step that quickly evaluates whether a submitted document is suitable for further verification, allowing the system to provide immediate feedback and, in rare cases, avoid unnecessary processing.

Instead of running full verification immediately, the system performs a set of automatic checks in advance to filter out clearly unsuitable inputs. This helps your applicants quickly identify issues and fix them before continuing with the full verification flow.

When a document is uploaded to Sumsub, the system runs a set of initial checks to detect the following:

All pages and sides of the document are uploaded.
The uploaded images represent a valid document (not a non-document image).
The same side of the document is not submitted twice.
Document number, name fields, and MRZ are present, clearly visible, and can be recognized.
Document image is not a screenshot or a printout.
Image has not been cropped.
Document is not considered expired or issued in the forbidden territory in accordance with the settings.
Photo in the document contains the human face.
Image metadata does not indicate the use of prohibited editing software.

If the Fastfail check is not passed, the system notifies the applicant and requests a new document upload.

🚧
Important
Fastfail does not replace full verification and is designed to detect only obvious issues. It does not perform detailed quality checks, which are handled at later stages of the verification process. Passing Fastfail does not guarantee final approval.

Fastfail rejection tags

Tag	Description
`forbiddenDocument`	The submitted document's type or issuing country isn't accepted for verification (e.g. a restricted country, or a document type not supported for that country).
`missingImportantInfo`	Required information on the document is missing or can't be read, so the document can't be verified.
`dataNotReadable`	Text or data on the document image can't be read — usually due to poor image quality or the wrong document type/country being selected.
`expiredDoc`	The document's validity period has already ended.
`documentWayTooMuchOutside`	A significant part of the document falls outside the photo frame; the document doesn't fit the shot.
`noIdDocFacePhoto`	The applicant's face isn't visible on the document (e.g. the portrait/photo page is missing or obscured).
`shouldBeMrzDocument`	This document type is expected to have a machine-readable zone (MRZ), but no readable MRZ was found on the image.
`shouldBeDoubleSided`	The document type requires separate photos of the front and back, but they weren't both provided.
`shouldBeDoublePaged`	The document type requires a single photo showing both pages together (e.g. a passport's bio double-page), which wasn't provided correctly.
`documentDeclinedBefore`	The exact same image, for the same document type + subtype, was already uploaded before and was declined.
`sameSides`	The same side of the document was uploaded twice (e.g. the same image used for both front and back).
`screenshot`	The uploaded image is a screenshot rather than a real photo of the document.
`digitalDocument`	The uploaded image is a digital/soft copy of the document rather than a photo of the physical document.
`damagedDocument`	The physical document appears to be damaged, preventing verification.
`incompleteDob`	The document doesn't show a full date of birth (day, month, and year).
`missingDob`	The document type doesn't normally carry a date of birth field, but some such documents can still be accepted through specific handling logic.
`missingValidUntil`	The document type doesn't normally carry an expiration date, but can still be accepted if validity is confirmed via a check source.
`docExpiresSoon`	Per client-specific settings, the document is treated as already expired because it falls within a configured minimum-residual-validity window before its actual expiry.
`mrzNotReadable`	The document's machine-readable zone specifically can't be read.
`needTranslation`	The document's language/script isn't accepted as-is and needs a certified translation before review.
`suspiciousDocument`	The image shows signs the document may have been tampered with or modified.
`missingSignature`	The document is missing a required signature.
`documentAlreadyUsed`	The applicant has already used this same underlying document, but submitted it under a different ID document type.
`nfcHardwareMissing`	NFC-based document reading is required, but the current device/flow has no way to read the chip; must be run via MobileSDK.
`shouldBeNfcDocument`	The document is expected to contain an NFC chip, but the submitted document doesn't have one.

Updated 15 days ago

Did this page help you?