Blocklist Overview
The Blocklist helps prevent known fraudulent or spam individuals from completing identity verifications. During verification, iDenfy compares new data (face, document, or personal info) against entries in the blocklist. If a match is found, the verification is marked “suspected” and flagged with one of the following tags:Face_Blacklisted— selfie image matchedDoc_Face_Blacklisted— face from document matchedData_Blacklisted— personal details matched
Interface Notes
- Access via sidebar: Menu → Blocklist
- Tabs:
- Selfie
- 🪪 Face in Document
- Document Data
- Use the search bar to find existing records by ScanRef or enable Search all records.
- Use the Create new button to open the blocklist creation form.
- Required fields are marked — incomplete entries cannot be submitted.
Operational Tips
- Use ScanRef when you already have a completed verification—this ensures accurate data/face extraction and saves time.
- For Document data, adding a Personal number and Nationality significantly improves matching accuracy.
- Keep Reason short but specific (e.g., “Chargeback fraud, 2025-10-21; internal case #1234”).
Face Blocklist (Selfie / Face in Document)
Use when you want to block by image.Fields in “Create new → Face”
| Field | Values / Format | Required | Notes |
|---|---|---|---|
| Ban by | Photo or ScanRef | Choose Photo to upload; choose ScanRef to pull images from an existing verification. | |
| Ban type | Selfie or Document Face | Select which face source to block. | |
| Upload photo | PNG, JPG, HEIF | if Ban by = Photo | Drag & drop or click to upload. |
| Reason | Free text | Optional | Internal note/context. |
- If Ban by = Photo → you must upload a file.
- If Ban by = ScanRef → the system uses the face(s) from that verification.
- On future approved verifications, the system compares faces and flags with
Face_BlacklistedorDoc_Face_Blacklisted.
Document Data Blocklist (Personal Information)
Use when you want to block by identity details (no image required).Fields in “Create new → Document data”
| Field | Values / Format | Required | Notes |
|---|---|---|---|
| Ban by | Data (or ScanRef, if enabled in your setup) | With ScanRef, fields auto-fill from that verification. | |
| Full name | Text | Person’s full legal name. | |
| Date of birth | Date | Date picker; must be a valid date. | |
| Personal number | Text | Optional | National ID / personal code (improves match accuracy). |
| Nationality | Country select | Optional | ISO country selection (improves match accuracy). |
| Document number | Text | Optional | Adds another strong identifier. |
| Reason | Free text | Optional | Internal note / context. |
- If details match on a future approved verification, it’s flagged with
Data_Blacklisted. - If created via ScanRef, the system pre-fills name, DOB, personal number, and nationality (when available).
Validation & Behavior
- Required fields are enforced (you’ll see “Please fill in all required fields.” if missing).
- Files: Accepts PNG / JPG / HEIF.
- Dates: Must be valid (DOB uses a date picker).
- Submission: Create is disabled until the required fields are completed.
Directly from a Verification
On any verification results page, click Add verification to a blocklist (top-right corner). This opens a quick-action modal allowing you to add that verification immediately. Fields:| Field | Description / Options |
|---|---|
| Block reason | Choose the reason: |
- Fake document
- Same person, multiple identities
- Deepfake / AI-generated face
- Fraudulent behavior during onboarding
- Blocklist by internal risk rules
- Confirmed criminal activity
- Other
