Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.didit.me/llms.txt

Use this file to discover all available pages before exploring further.

1

Create your Didit account

  1. Go to business.didit.me
  2. Sign up with SSO or email and password
  3. Create your Organization — this is where your team manages workflows, API keys, and verification activity
2

Build a verification workflow

Navigate to Workflows in the sidebar and click Create New. Choose a workflow type:
TypeDescription
Simple WorkflowSteps run in a defined order — ideal for standard onboarding flows
Node-Based WorkflowFlexible branching logic — build conditional paths based on verification results
Pick a template to get started:
TemplateUse case
KYCStandard user onboarding
Adaptive Age VerificationSelfie age check with ID fallback
Biometric AuthenticationPasswordless selfie re-auth
Address VerificationProof of address flow
Customize by toggling blocks: Liveness, Face Match, AML, NFC, Phone, Email, and more.
3

Configure webhook and copy API key

Go to API & Webhooks in the sidebar:
  1. Add your Webhook URL — Didit sends status updates here
  2. Copy your API Key — keep it server-side only, never expose in frontend code
You can test webhooks directly from this page with different data and statuses — no need to run a full verification. This lets you validate your integration is working correctly before going live.
4

Start a verification session

Option A — Hosted sessions (recommended)Our preferred integration method. Hosted sessions are optimized with A/B testing for onboarding rate, speed, and security — plus AI-powered UX, charge optimization, and more.In the Console, click ”+” → select a workflow → generate a link or QR code. Or create sessions programmatically:
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workflow_id": "your-workflow-id"}'
Find your workflow_id under Workflows in the sidebar.
Option B — Standalone APIs (advanced)Call endpoints directly from your backend — no session required. Best for server-to-server or custom flows:
EndpointPurpose
POST /v3/id-verification/Document check
POST /v3/face-match/Selfie vs ID
POST /v3/aml/Sanctions & PEP
POST /v3/passive-liveness/Deepfake detection
See the full list in API Reference.
5

Receive real-time results

Didit sends webhook events to your endpoint — no polling needed.
EventTrigger
status.updatedUser-session or business-session status changes
data.updatedSession or business-session verification data changes
user.status.updatedVendor user status changes
user.data.updatedVendor user profile or aggregate data changes
business.status.updatedVendor business status changes
business.data.updatedVendor business profile or aggregate data changes
activity.createdActivity event recorded
transaction.createdTransaction created
transaction.status.updatedTransaction status changes
See Webhooks for payload format and signature verification.
6

Manage and monitor

Use the Console to:
  • View session progress in real time
  • Download PDF/CSV reports for compliance
  • Blocklist suspicious IDs or faces
  • Manually update or reject sessions

​
Need help?

WhatsApp

Fastest response — reach us directly.

Email

hello@didit.me