Skip to main content

Manual Review

The Manual Review process ensures that verification results requiring human intervention are properly evaluated by authorized personnel before a final disposition is reached.

How It Works​

  1. Flagging: When a verification result (DV or KYB) cannot be automatically determined, it is assigned the REQUIRES_MANUAL_REVIEW status.
  2. Notification: The system triggers a REVIEW webhook event to notify the organization.
  3. Review: An authorized reviewer accesses the dashboard to inspect the result, including AI-generated suggestions and confidence scores.
  4. Decision: The reviewer submits a final status (Approved, Rejected, or Failed).
  5. Processing: A background worker processes the decision and triggers subsequent workflow actions and webhooks.

Review Statuses​

StatusDescription
ApprovedThe result is verified as valid and the flow continues.
RejectedThe result is determined to be fraudulent or invalid.
FailedThe verification process could not be completed (e.g., poor image quality).

Permissions​

Access to manual review operations is governed by the following permission levels:

  • ORG_OPERATOR: Can review results currently in the RequiresManualReview status.
  • ORG_ADMIN: Can review results in the RequiresManualReview status.
  • Platform Admin: Can review results in RequiresManualReview, RequiresAdminReview, Partial, and Failed statuses.

Webhook Events​

  • REVIEW: Sent immediately when a result is flagged for manual review.
  • COMPLETED / FAILED / REJECTED: Sent after the manual review decision has been processed, reflecting the final state of the verification.