اسحب الوحدات إلى لوحة العمل، اربطها بالحواف، أضف التفرعات، انشر إصدارًا،
ثم مرر `workflow_id` لتطبيقك. عندما تتغير القواعد، يقوم مدير المنتج
بتعديل المسودة ونشرها, لا حاجة لتذكرة هندسية، ولا إعادة نشر.
يبقى التكامل على بعد `POST /v3/session/` واحد.
كيف يعمل
من التسجيل إلى مستخدم موثوق به في أربع خطوات.
الخطوة 01
أنشئ سير العمل
اختر الفحوصات التي تريدها, الهوية، التحقق من الوجود، مطابقة الوجه، العقوبات، العنوان، العمر، الهاتف، البريد الإلكتروني، الأسئلة المخصصة. اسحبها إلى سير عمل في لوحة التحكم، أو انشر نفس سير العمل إلى واجهة برمجة التطبيقات (API) الخاصة بنا. تفرع بناءً على الشروط، قم بإجراء اختبارات A/B، لا يتطلب أي كود.
الخطوة 02
ادمج
ادمج بشكل أصلي باستخدام SDK الخاص بنا للويب، iOS، Android، React Native، أو Flutter. أعد التوجيه إلى صفحة مستضافة. أو ببساطة أرسل لمستخدمك رابطًا, عبر البريد الإلكتروني، الرسائل القصيرة، واتساب، أي مكان. اختر ما يناسب بيئتك التقنية.
الخطوة 03
يمر المستخدم عبر سير العمل
تستضيف Didit الكاميرا، إشارات الإضاءة، التسليم عبر الهاتف المحمول، وإمكانية الوصول. بينما يكون المستخدم في سير العمل، نقوم بتقييم أكثر من 200 إشارة احتيال في الوقت الفعلي والتحقق من كل حقل مقابل مصادر البيانات الموثوقة. النتيجة في أقل من ثانيتين.
الخطوة 04
تتلقى النتائج
تحافظ الـ webhooks الموقعة في الوقت الفعلي على مزامنة قاعدة بياناتك لحظة الموافقة على المستخدم، أو رفضه، أو إرساله للمراجعة. استعلم من الـ API عند الطلب. أو افتح لوحة التحكم لفحص كل جلسة، كل إشارة، وإدارة الحالات بطريقتك.
مصمم لأصحاب المنتجات · تسعير كالبنية التحتية
ستة عناصر أساسية. Workflow Builder مجاني.
ادفع فقط مقابل الوحدات التي يتم تشغيلها فعليًا في كل جلسة. لوحة العمل، التفرعات، القوالب، اختبارات A/B، إدارة الإصدارات, كلها متضمنة.
اسحب الهوية، التحقق من الوجود، مطابقة الوجه، البحث عن الوجه، الجهاز + IP، AML، NFC، إثبات العنوان، KYB، فحص المحفظة، الاستبيانات إلى لوحة العمل. اربط الحواف. انتهى.
تفرع بناءً على أي إشارة, اكتشاف VPN / Tor، بلد الإصدار، العمر، نتيجة AML، مستخدم عائد، درجة الاحتيال، نوع المستند. لا يوجد حد للعمق. عدّل التفرعات دون إعادة نشر التطبيق.
الهوية + مطابقة الوجه، الهوية + التحقق من الوجود + مطابقة الوجه (KYC بقيمة 0.33 دولار)، الهوية + مخاطر IP، مخاطر الهاتف، مراجعة البلدان عالية المخاطر، هويتان، التحقق من السائق، التحقق من الشركات في الاتحاد الأوروبي (KYB)، والمزيد, قم بتشغيل أو إيقاف الوحدات.
قسّم حركة المرور عبر متغيرات سير العمل, التحقق السلبي من الوجود مقابل النشط، شاشة تسجيل الدخول تشغيل/إيقاف، AML عند التقديم مقابل AML عند أول معاملة. يتم إرسال معرف المتغير في كل webhook لربط التحليلات بين نتيجة القرار والمتغير.
عدّل المسودة بحرية؛ النشر ينشئ إصدارًا غير قابل للتغيير. تشير الجلسات دائمًا إلى إصدارها الدقيق، لذا يمكن إعادة إنتاج جلسة سابقة بالكامل للمراجعة. يتم الاحتفاظ بالإصدارات السابقة إلى الأبد.
SDKs، خادم MCP، واجهة مستخدم مستضافة, نفس الـ workflow_id.
مرر `workflow_id` إلى `POST /v3/session/`. تتولى Didit تنسيق العمليات من جانب الخادم وتعيد webhook موقّعًا. يتيح خادم Didit MCP (بروتوكول سياق النموذج) لوكلاء الذكاء الاصطناعي إنشاء وتعديل سير العمل برمجيًا.
201تم الإنشاءيعيد الـ uuid الخاص بسير العمل · جاهز للاستخدام كـ workflow_id.
ترتيب الميزات خطي. نفس شكل منشئ الـ Console.الوثائق ←
تكامل جاهز للوكيل
أطلق سير عمل هوية بدون كود في أمر واحد.
الصق في Claude Code، Cursor، Codex، Devin، Aider، أو Replit Agent. املأ الوحدات والفروع الخاصة بك. يقوم الوكيل بإنشاء سير العمل، ونشر الإصدار، وربط الويب هوك الموقّع بتطبيقك.
didit-integration-prompt.md
You are integrating Didit's no-code Workflow Builder into a product. The product manager, the compliance officer, or the founder can change identity rules in the Business Console; your app only ever hands Didit a workflow_id, gets a verdict back, and routes the user.
Three pillars:
1. Compose the workflow in the visual builder — drag ID, Liveness, Face Match, AML, NFC, KYB modules onto the canvas, connect them with edges, add conditional branches.
2. Publish a version — the published version is immutable; sessions reference the exact version they were created with.
3. Open POST /v3/session/ with the published workflow_id. Didit handles every module and every branch server-side.
Cost:
- Pay per completed module per session (e.g. ID $0.15 + Liveness $0.10 + Face Match $0.05 + AML $0.20 = $0.50, or bundle = $0.33)
- Workflow Builder itself is free
- MCP server (for AI coding agents to manage workflows programmatically) is free, included
- First 500 verifications free every month, forever
PRE-REQUISITES
- Production API key from https://business.didit.me (sandbox key in 60s, no card).
- Webhook endpoint with HMAC SHA-256 verification using the X-Signature-V2 header and your webhook secret.
- Access to the Business Console's Workflow Builder (every account has it).
- The 11 seeded templates are a good starting point:
"ID + Face Match"
"ID + Liveness + Face Match" (the $0.33 KYC bundle)
"ID + IP risk-based" (extra Liveness on VPN / Tor)
"Phone risk-based verification"
"High-risk country review"
"Two ID documents"
"Driver verification"
"EU Company Verification" (KYB)
... plus four more
- Plus "Start from Scratch" for fully bespoke flows.
STEP 1 — Compose the workflow
Console → Workflows → New → pick a template OR Start from Scratch:
- Drag modules from the sidebar onto the canvas
- Connect them with edges (the user moves left-to-right through them)
- Add branching conditions (right-click a node → Add condition)
- Set per-workflow options: Include custom style (white label), retention override, callback URL
Click Save Draft. The draft is fully editable; only published versions are immutable.
STEP 2 — Publish a version
Click Publish on the draft. The version receives a number (v1, v2, v3…) and becomes immutable.
Versioning rules:
- Sessions reference the exact published version they were created with
- You can iterate on a new draft while sessions on the old version continue to use it
- Past versions are kept; you can inspect any past session's configuration
- To change a published workflow, create a new draft from it, edit, publish
STEP 3 — Open a session with the workflow_id
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: <your api key>
Content-Type: application/json
Body:
{
"workflow_id": "<your published workflow id>",
"vendor_data": "<your user id, max 256 chars>",
"callback": "https://<your-app>/identity/callback"
}
Response: 201 Created with the hosted session URL. Didit walks the user through every module and every branch defined in the workflow.
STEP 4 — Read the signed webhook on completion
Didit POSTs to your callback when the session reaches a terminal status. Session statuses are Title Case With Spaces:
Body (excerpted):
{
"session_id": "<uuid>",
"workflow_id": "<the workflow id>",
"workflow_version": "<v3>",
"vendor_data": "<your user id>",
"status": "Approved",
"id_verification": { "status": "Approved" },
"liveness": { "status": "Approved" },
"face": { "status": "Approved", "similarity_score": 0.94 },
"aml": { "status": "Approved", "hits": [] }
}
Status enum (exact case): Approved | Declined | In Review | Resubmitted | Expired | Not Finished | Kyc Expired | Abandoned.
Verify the X-Signature-V2 header BEFORE reading the body — HMAC SHA-256 of the raw bytes with your webhook secret.
Each module that ran inside the workflow returns its own sub-status; the top-level status is the rolled-up verdict.
STEP 5 — Iterate without redeploying
When the rules need to change — a new country flagged as high-risk, a tighter age threshold, a new module added to the bundle — the workflow owner edits the draft in the Console and publishes. New sessions automatically use the new version.
Your app doesn't change. You don't redeploy. The workflow_id is the same; the underlying behaviour is updated.
STEP 6 — Run A/B tests
Built-in A/B testing splits traffic across variant workflows. Configure variants in the Console (e.g. variant A uses Passive Liveness, variant B uses Active Liveness), set the split percentage, and read the variant id back on every session webhook.
Measure conversion + verdict mix per variant in the Business Console's analytics. Promote the winner; the loser becomes a previous version retained for audit.
STEP 7 — Drive the Workflow Builder from AI coding agents
The Didit MCP (Model Context Protocol) server (free, included) exposes the Workflow management primitives as MCP tools. Any MCP-compatible host — Claude Code, Cursor, Codex, Replit Agent, Devin, Aider — can list workflows, create new drafts, edit nodes, and publish versions on your behalf.
Useful for ops teams that want to script tenant-specific workflow provisioning, A/B-variant generation, or per-customer-brand template materialisation.
WEBHOOK EVENT NAMES
- Sessions: status changes flow through the standard session webhook.
- Verify X-Signature-V2 on every payload.
CONSTRAINTS
- Session statuses use Title Case With Spaces (Approved, In Review). Don't transform them.
- Published workflow versions are immutable. To change behaviour, publish a new version.
- Conditional branches are unlimited in depth; keep flows readable for the next operator.
- The cost model is pay-per-completed-module — adding a module that runs only conditionally only costs you on the branches that hit it.
Read the docs:
- https://docs.didit.me/console/workflows
- https://docs.didit.me/sessions-api/create-session
- https://docs.didit.me/sessions-api/retrieve-session
- https://docs.didit.me/integration/webhooks
Start free at https://business.didit.me — sandbox key in 60 seconds, 500 verifications free every month, no credit card.
هل تحتاج إلى المزيد من السياق؟ اطلع على وثائق الوحدة الكاملة.docs.didit.me ←
متوافق حسب التصميم
افتح دولة جديدة بنقرة واحدة. نحن نقوم بالعمل الشاق.
نحن نفتح الشركات التابعة المحلية، ونؤمن التراخيص، ونجري اختبارات الاختراق، ونحصل على الشهادات، ونتوافق مع كل لائحة جديدة. لنشر عمليات التحقق في بلد جديد، ما عليك سوى تفعيل مفتاح. أكثر من 220 دولة تعمل، يتم تدقيقها واختبار اختراقها كل ربع سنة, المزود الوحيد للهوية الذي وصفته حكومة دولة عضو في الاتحاد الأوروبي رسميًا بأنه أكثر أمانًا من التحقق الشخصي.
ابدأ مجانًا ← ادفع فقط عند إجراء الفحص ← افتح Enterprise لعقد مخصص، أو SLA، أو إقامة البيانات.
FAQ
أسئلة شائعة
What is Didit?
Didit is infrastructure for identity and fraud, the platform we wished existed when we were building products ourselves: open, flexible, and developer-friendly, so it works as a real part of your stack instead of a black box you integrate around.
One API covers verifying people (KYC, know your customer), verifying businesses (KYB, know your business), screening crypto wallets (KYT, know your transaction), and monitoring transactions in real time, on a stack built to be:
Fast, sub-2-second p99 on every session
Reliable, in production with 1,500+ companies across 220+ countries
Secure, SOC 2 Type 1, ISO 27001, GDPR-native, and formally attested by Spain's financial regulator as safer than verifying someone in person
The footprint underneath: 14,000+ document types in 48+ languages, 1,000+ data sources, and 200+ fraud signals on every session. The Didit infrastructure dynamically learns from every session and gets better every day.
What's a no-code identity workflow, in plain English?
It's a way to design what your KYC / AML / KYB flow checks, in what order, and under which conditions, all in a visual drag-and-drop canvas instead of code.
In practice:
A product manager drags ID Verification, Passive Liveness, Face Match 1:1, and AML Screening onto the canvas
They draw a branch: if Device & IP signals say the user is on a VPN, add Active Liveness
They draw another branch: if the AML check returns a hit, block and open a case
They publish the workflow and hand the workflow_id to the engineering team
The engineering team passes that workflow_id into POST /v3/session/, done
When the rules need to change, the product manager edits the draft and publishes. The app doesn't redeploy.
Why does this matter? Couldn't we just code the flow ourselves?
You could. Most teams that try learn three lessons:
Rules change faster than deploys, a new country flags as high-risk, regulator tightens an age threshold, fraud team needs a new step-up. Every change is an engineering ticket, a PR, a review, a release.
State machines are fiddly, "if VPN then liveness else face match, unless returning user in which case skip to reusable KYC, but only when document was issued before 2020" gets ugly fast in application code
A/B testing your verification flow requires shipping two versions, splitting traffic at your edge, joining the variant id to the verdict for analytics, non-trivial infra
The Workflow Builder collapses all three into one drag-drop canvas. The rules become product configuration; the code becomes one POST /v3/session/ call.
How fast is the verification for my end user?
The full flow normally takes under 30 seconds end-to-end, pick up the ID, snap the document, snap the selfie, done. That is the fastest in the market. Legacy KYC providers usually take more than 90 seconds for the same flow.
On the back end, Didit returns the result in under two seconds at p99, measured from the moment the user finishes the selfie to the moment your webhook fires. Mobile capture is tuned for slow phones and slow networks: progressive image compression, lazy software development kit load, and a one-tap hand-off from desktop to phone via QR code if the user starts on web.
What modules can I drag onto the canvas?
Every Didit primitive ships as a node:
Identity & document, ID Verification ($0.15), NFC Reading ($0.15), Proof of Address ($0.20), Database Validation (variable), Custom Questionnaires ($0.10)
Biometric, Passive Liveness ($0.10), Active Liveness ($0.15), Face Match 1:1 ($0.05), Face Search 1:N (free), Age Estimation ($0.10), Biometric Authentication ($0.10)
Risk & fraud, AML Screening ($0.20, 1,300+ lists), Ongoing AML ($0.07/user/yr), Device & IP Analysis ($0.03)
Plus branching nodes (if/else, switch) and terminal nodes (Approve, Decline, Review).
What happens if a user fails, abandons, or expires?
Every session lands on one of seven clear statuses, so your code always knows what to do:
Approved, every check passed. Move the user forward.
Declined, one or more checks failed. You can allow the user to resubmit the specific failed step (for example, re-take the selfie) without re-running the whole flow.
In Review, flagged for compliance review. Open the case in the console, see every signal, decide approve or decline.
In Progress, user is mid-flow.
Not Started, link sent, user has not opened it yet. Send a reminder if it sits too long.
Abandoned, user opened the link but did not finish in time. Re-engage or expire.
Expired, the session link aged out. Create a new session.
A signed webhook fires on every status change, so your database always stays in sync. Abandoned and declined sessions are free.
Where does my customer data live and how is it protected?
Production data is processed and stored in the European Union by default, on Amazon Web Services. Enterprise contracts can request alternative regions for jurisdictions whose regulators require it.
Encryption everywhere. AES-256 at rest across every database, object store, and backup. Transport Layer Security 1.3 in transit on every API call, webhook, and Business Console session. Biometric data is encrypted under a separate Customer Master Key.
Retention is yours to control. Default retention is indefinite (unlimited) unless you configure shorter, between 30 days and 10 years per application, and you can delete any individual session at any time from the dashboard or the API.
Certifications: SOC 2 Type 1 (Type 2 audit in progress), ISO/IEC 27001:2022, iBeta Level 1 PAD, and a public attestation from Spain''s Tesoro / SEPBLAC / CNMV that Didit''s remote identity verification is safer than verifying someone in person. Full report at /security-compliance.
Is Didit compliant for my industry?
Didit ships compliant by default for the regulators that matter to identity infrastructure:
GDPR + UK GDPR, controller / processor split, full Data Processing Agreement published, lead supervisory authority named (Spain''s AEPD).
AMLD6 + EU AML Single Rulebook, 1,300+ sanctions, politically exposed person, and adverse-media lists screened in real time.
eIDAS 2.0, EU Digital Identity Wallet aligned; reusable-identity ready.
MiCA (Markets in Crypto-Assets), ready for crypto on-ramps, exchanges, and custodians.
DORA, Digital Operational Resilience Act, EU financial-services operational resilience.
BIPA, CUBI, Washington HB 1493, CCPA / CPRA, US biometric privacy (Illinois, Texas, Washington) and California consumer privacy.
UK Online Safety Act, age-gating and child-safety obligations.
FATF Travel Rule, originator and beneficiary data on crypto transfers, IVMS-101 interoperable.
Draft, fully editable. Add, remove, restructure nodes freely. Doesn't affect any live session.
Published, immutable. Receives a numeric version (v1, v2, v3...). Live sessions use the latest published version at the time the session was created.
To change a published workflow, you create a new draft from it, edit, publish. The new published version becomes v3 (or whatever); v2 stays in place forever as the historical record. Past sessions are fully reproducible, the session payload includes the exact workflow_version it ran on.
This matches what a regulator wants for audit: "show me the exact configuration of the workflow this user ran on, on this date". Every Didit account gets it for free, no setup.
How does this fit with the SDKs and the MCP server?
Everything ships under the same /v3/ contract.
SDKs, Web (React, Vue, vanilla), iOS (Swift), Android (Kotlin), React Native (TurboModules), Flutter (Dart). All five accept a workflow_id and walk the user through the same orchestration server-side. Free.
Hosted UI, branded or unbranded via the White Label add-on. Same workflow_id, same orchestration.
Didit MCP (Model Context Protocol) server, free, included. Exposes the Workflow management primitives as MCP tools so AI agents (Claude Code, Cursor, Codex, Replit Agent, Devin, Aider) can list workflows, create drafts, edit nodes, and publish versions on your behalf.
The net: one workflow_id flows from the Console → into your app → into the SDK or hosted UI → server-side orchestration → signed webhook. Zero glue code beyond the single POST /v3/session/.
What does the integration look like for a small team?
Three wires, one afternoon:
Open business.didit.me, sandbox key in 60 seconds, no credit card
Open the Workflow Builder, pick a template (e.g. "ID + Liveness + Face Match"), add or remove modules, save the draft, publish
In your app, call POST /v3/session/ with the published workflow_id and wire the signed webhook (X-Signature-V2, HMAC SHA-256) into your decision logic
That's the entire integration. When rules change, the workflow owner edits the draft in the Console and publishes, your app doesn't change.
For scripted workflow management, the Didit MCP server is free and lets any MCP-compatible agent host (Claude Code, Cursor, etc.) drive the Workflow Builder programmatically.