Design an Onfido Studio workflow branch that routes a failed document or facial similarity check back to a recapture step instead of an automatic hard decline

domain: onfido.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. In Workflow Studio, add a decision/condition node after the document and facial similarity check steps that inspects the check's output (result and sub-result/reason fields)
  2. Branch on recoverable failure reasons (e.g., poor image quality, glare, cropped capture) to route the applicant back to a capture step for a bounded number of attempts
  3. Branch on non-recoverable or fraud-indicative reasons (e.g., document tampering signals) directly to a manual review or hard-decline outcome instead of recapture
  4. Cap the number of recapture loops within the workflow definition so a user cannot indefinitely retry
  5. Use the workflow run's webhook event to notify your backend of the final outcome only after the branching logic resolves, not on each intermediate loop iteration
  6. Generate the workflow run's audit trail/timeline file at completion for compliance record-keeping regardless of which branch was taken

Known gotchas

Related routes

Configure an Onfido Studio workflow with a document capture step followed by a facial similarity report and retrieve the result via webhook
documentation.onfido.com · 5 steps · unrated
Run an Onfido document and facial similarity check workflow
documentation.onfido.com · 6 steps · unrated
Generate and retrieve a Timeline File audit trail PDF for a completed Onfido Studio workflow run for compliance record-keeping
documentation.onfido.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans