Quick start: launch your first KYC verification flow

Create your Didit account

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

Build a verification workflow

Navigate to Workflows in the sidebar and click Create New. Choose a workflow type:

Type	Description
Simple Workflow	Steps run in a defined order — ideal for standard onboarding flows
Node-Based Workflow	Flexible branching logic — build conditional paths based on verification results

Pick a template to get started:

Template	Use case
KYC	Standard user onboarding
Adaptive Age Verification	Selfie age check with ID fallback
Biometric Authentication	Passwordless selfie re-auth
Address Verification	Proof of address flow

Customize by toggling blocks: Liveness, Face Match, AML, NFC, Phone, Email, and more.

Configure webhook and copy API key

Go to API & Webhooks in the sidebar:

Add your Webhook URL — Didit sends status updates here
Copy your API Key — keep it server-side only, never expose in frontend code
Save the destination’s signing secret as DIDIT_WEBHOOK_SECRET in your .env — it’s required to verify the X-Signature-V2 HMAC on incoming webhooks

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.

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:

Endpoint	Purpose
`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.

Receive real-time results

Didit sends webhook events to your endpoint — no polling needed.

Event	Trigger
`status.updated`	User-session or business-session status changes
`data.updated`	Session or business-session verification data changes
`user.status.updated`	Vendor user status changes
`user.data.updated`	Vendor user profile or aggregate data changes
`business.status.updated`	Vendor business status changes
`business.data.updated`	Vendor business profile or aggregate data changes
`activity.created`	Activity event recorded
`transaction.created`	Transaction created
`transaction.status.updated`	Transaction status changes

See Webhooks for payload format and signature verification.

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?

Fastest response — reach us directly.

Email

hello@didit.me

Overview

Pricing

Workflows & Verification

Review & Operations

Entities (Users & Businesses)

Settings & Customization

Security & Compliance

Resources

Quick start: launch your first KYC verification flow

Need help?

WhatsApp

Email

​Need help?

WhatsApp

Email

Need help?