Skip to main content
The Workflows page enables your business to create, manage, and customise verification workflows with minimal technical effort. The page lists all your onboarding flows. For each flow you can see the flow name, the app it is linked to, its status (Published or Draft), the estimated cost per verification, and the date it was created. Summary counts at the top show total flows, published, and drafts. Use the search bar to find a flow by name. Use filters to narrow by status or app. Click ’+ Create Flow’ to start a new one.

​
Creating a flow

When you click ’+ Create Flow’, you are given two options:
  • Start from Template: choose from pre-built verification templates with expert-configured steps already in place. The fastest way to get started.
  • Build from Scratch: create a fully custom flow using AI assistance or by configuring it manually.

​
Editing a flow

Clicking into any flow opens the flow editor. At the top you can see the flow name, its live/draft status, and buttons to Preview, Apply changes, and Unpublish (or Publish). The editor has five tabs: Appearance, Steps, Fraud Check, Settings, and Integration.

​
Appearance tab

Controls how the verification widget looks to your users.
  • Linked App: the app this flow is associated with.
  • Logo: upload a PNG, SVG, or JPG (max 2MB) to display in the widget header.
  • Brand Color: choose from preset colours or enter a custom hex code. This colour is applied to buttons and key UI elements in the widget.
  • Support Display Name: toggle on to show a support contact name to users who need help during verification.
  • Font: choose the font used throughout the widget.
  • Button Border Radius: adjust the roundness of buttons in the widget (e.g. 10px for slightly rounded, higher values for fully rounded).
A live preview of the widget is shown on the right side of the screen and updates as you make changes.

​
Steps tab

Defines the sequence of verification steps a user goes through. The default flow includes a Get Started welcome screen followed by your configured verification steps. Each step can be reordered using the drag handle, deleted using the trash icon, or expanded to configure its settings using the dropdown. Click ’+ Add a new step’ to open the step picker modal. Available steps include:
  • Get Started: welcome screen before verification begins
  • Government Data: verifies identity against government databases, covering NIN and BVN
  • Business Data: company registration information
  • User Data: collects name and date of birth
  • Phone Number: phone number verification via OTP
  • Email: email address verification via OTP
  • Business ID: verifies CAC document
  • Address: residential address verification
  • Government-Issued ID: document capture/upload and verification
  • Liveness: face capture with liveness detection
  • Upload “other IDs/Documents”: lets users upload supporting documents
  • Signature: collects a digital signature from the user
  • Questions: presents custom questions to the user
Steps already added to the flow are labelled ‘Added’ in the picker. Select the steps you want to add and click Add steps. The estimated cost per verification is shown at the bottom of the Steps tab, calculated based on the steps in the flow.

​
Fraud Check tab

Contains fraud rules that run during verification to detect suspicious behaviour. Each rule can be individually enabled or disabled, and when triggered, can be set to either put the verification in pending (for manual review) or fail it outright. The available fraud rules are: User Data: checks for consistency of user-provided data across multiple sources. When data is inconsistent, you choose whether the verification goes to Pending or Fail. Age Limit: blocks users below a set minimum age. Enable the rule, set the minimum age (e.g. 18 years), and choose whether underage verifications go to Pending or Fail. Liveness Check: verifies that the user is a real, live person by analysing liveness and image match scores. When enabled, you set thresholds on two sliders: Liveness Score and Image Match. Each slider maps scores to three outcomes: Failed (red zone), Pending (yellow zone), and Succeeded (green zone). Adjust the boundaries to set how strict the check is. AML Screening: screens users against sanctions lists and PEP (Politically Exposed Persons) databases. When enabled, configure which databases to screen against: PEP, Adverse Media, Sanctions, and Warning. Set a match score threshold (e.g. above 50%) and choose what happens when a match is found: Pending or Fail. Duplicate ID: blocks reuse of the same ID number, ID document or face across verifications. When a duplicate is detected, choose whether it goes to Pending or Fail. IP / Device Screening: flags suspicious devices, VPNs, or proxies. When a blacklisted IP is detected, choose whether it goes to Pending or Fail. Digital Address: verifies a user’s address via geolocation matching, utility bill, and proof of address (images of their residential building) Each active rule shows status badges (active, pending, and fail) next to its name in the collapsed list so you can see the configuration at a glance without expanding it.

​
Settings tab

Controls how the flow behaves after verification is completed and how your team and users are notified. Review Process: determines how verification results are handled:
  • Automatic: the system processes and returns results without any human involvement.
  • Manual: your team reviews each verification before a result is returned to the user.
Business Notifications: configures how your team is notified about verification activity:
  • Webhook notifications: send verification results to your server via webhook.
  • Email notifications: receive email alerts when verifications are completed, failed, or need review.
User Notifications: configures how users are notified about their verification:
  • Email notifications: notify users about their verification status via email.
  • Support Email: the email address users can contact if they encounter issues during verification.
Countries: controls which countries can use this verification flow:
  • Allow all countries: users from any country can proceed.
  • Allow only selected countries: only users from specified countries can verify.
  • Block selected countries: users from specified countries are blocked from verifying.
Resume Verifications: when enabled, users who exit mid-flow can return and continue from where they left off instead of starting from scratch. Multiple Device Verification: when enabled, users can start verification on one device (e.g. desktop) and continue on another (e.g. mobile) via a secure link or QR code. Confirmation Page: controls what happens after a user completes verification. Toggle on Use default confirmation page to show Dojah’s built-in success page, or toggle it off to redirect users to your own custom page.

​
Integration tab

The Integration tab gives you everything you need to deploy the verification flow to your users. Shareable Link: an auto-generated URL that you can send directly to users to start verification. This is the quickest way to share a flow without any technical integration. SDK & API Documentation: click the link to open the full integration guide covering web, mobile, and API setup for embedding the verification widget directly into your product.