يجعل قانون الخدمات الرقمية للاتحاد الأوروبي وحزمة مكافحة غسل الأموال الجديدة التحقق من البائعين
التزامًا قانونيًا. تقدم Didit هذا كمسار عمل واحد: البحث في السجل،
استخراج المالك، KYC لكل مالك، والتعرف الضوئي على الحروف (OCR) للمستندات, كل ذلك مرتبط بنفس
سجل البائع. 2.00 دولار لكل بائع، 0.33 دولار لكل مالك. 500 عملية تحقق مجانية كل
شهر.
كيف يعمل
من التسجيل إلى مستخدم موثق في أربع خطوات.
الخطوة 01
أنشئ مسار العمل
اختر الفحوصات التي تريدها, الهوية، الحيوية، مطابقة الوجه، العقوبات، العنوان، العمر، الهاتف، البريد الإلكتروني، الأسئلة المخصصة. اسحبها إلى مسار عمل في لوحة التحكم، أو انشر نفس المسار إلى واجهة برمجة التطبيقات (API) الخاصة بنا. قم بالتفرع بناءً على الشروط، وقم بإجراء اختبارات A/B، لا يتطلب الأمر أي كود.
الخطوة 02
ادمج
ادمج بشكل أصلي مع SDK الخاص بنا للويب، iOS، Android، React Native، أو Flutter. أعد التوجيه إلى صفحة مستضافة. أو ببساطة أرسل لمستخدمك رابطًا, عبر البريد الإلكتروني، الرسائل القصيرة، واتساب، أي مكان. اختر ما يناسب نظامك.
الخطوة 03
يمر المستخدم بالعملية
تستضيف Didit الكاميرا، إشارات الإضاءة، التسليم عبر الهاتف المحمول، وإمكانية الوصول. بينما يكون المستخدم في المسار، نقوم بتقييم أكثر من 200 إشارة احتيال في الوقت الفعلي ونتحقق من كل حقل مقابل مصادر البيانات الموثوقة. النتيجة في أقل من ثانيتين.
الخطوة 04
تتلقى النتائج
تحافظ الـ webhooks الموقعة في الوقت الفعلي على مزامنة قاعدة بياناتك لحظة الموافقة على المستخدم، أو رفضه، أو إرساله للمراجعة. استعلم من الـ API عند الطلب. أو افتح وحدة التحكم لفحص كل جلسة، كل إشارة، وإدارة الحالات بطريقتك.
مصمم للأسواق · تسعير كالبنية التحتية
مسار عمل واحد. 2.00 دولار لكل بائع.
التحقق المنظم من بائع السوق ليس فحصًا واحدًا, إنه وصفة من البحث في السجل، استخراج المالك، KYC لكل مالك، فحص AML، التعرف الضوئي على المستندات (OCR)، والمراقبة المستمرة. قم بتبديل كل وحدة لكل مسار عمل.
مستمدة مباشرة من المصدر الرسمي للبلد, Companies House (المملكة المتحدة)، Mercantil (إسبانيا)، Handelsregister (ألمانيا)، Junta Comercial (البرازيل)، وأكثر من 200 سجل آخر. الاسم القانوني، رقم التسجيل، الحالة، تاريخ التأسيس. لا يوجد كشط بيانات، ولا بيانات قديمة.
Government registries direct, no scraping.$2.00 per KYB
02 · استخراج المالك المستفيد
كل مالك يمتلك أكثر من 25%.
يستخرج تحديد المالك المستفيد النهائي (UBO) كل فرد يمتلك ربع أو أكثر من البائع، جاهزًا لـ KYC ذي الحلقة المغلقة. يسحب المديرين والمساهمين من مصدر السجل ليكونت القائمة قابلة للإثبات، وليست معتمدة ذاتيًا.
Each UBO gets a linked /v3/session/ for KYC at $0.33.
03 · KYC لكل مالك
تحقق هوية متكامل لكل مالك.
يحصل كل مالك مستفيد على جلسة KYC مستضافة, التحقق من الهوية، الحيوية السلبية، مطابقة الوجه 1:1، تحليل الجهاز وعنوان IP، AML, بتكلفة 0.33 دولار لكل مالك. تعود النتيجة إلى سجل KYB الرئيسي بحيث يؤدي موافقة واحدة إلى رفع مستوى البائع بأكمله.
قوائم العقوبات، الأشخاص المعرضين سياسياً (PEP)، ووسائل الإعلام السلبية, يتم تحديثها يومياً، بـ 14 لغة. تؤدي النتائج الإيجابية إلى فتح قضية تلقائياً وتحجب البائع قبل التخليص. تغطي الشركة وكل مالك.
14 languages · daily delta refresh$0.20 / individual
05 · جمع المستندات + OCR
حزمة إثباتات واحدة، موقّعة.
شهادة التأسيس، التسجيل الضريبي، إثبات عنوان العمل, يتم جمعها من خلال المسار المستضاف وقراءتها بواسطة OCR. يتم التحقق منها مقابل سجل السجل بحيث يفشل التحميل الذي تم التلاعب به قبل أن يصل إلى سجل التدقيق الخاص بك.
Certificate of incorporationAuto-OCR · registry match
Tax / VAT registrationNumber validated against authority
Proof of business addressUtility, bank, registry letter
Bank statement (last 90d)Optional · owner verification
One evidence pack, signed and timestamped.
06 · المراقبة المستمرة
حافظ على التحقق بعد الإعداد الأولي.
مكافحة غسل الأموال (AML) اليومية المستمرة على البائع وكل مالك (0.07 دولار/مستخدم/سنة)، مراقبة حالة السجل للحلول، تنبيهات عند تغيير المالك فوق عتبة 25%، تذكيرات بانتهاء صلاحية المستندات. يبقى البائع متوافقًا طالما يبيع.
الصق في Claude Code أو Cursor أو Codex أو Devin أو Aider أو Replit Agent. املأ بيانات الـ stack الخاص بك. يقوم الوكيل ببناء سير العمل، ويطلق الجلسة لكل بائع، ويدير KYC المرتبط لكل مالك، ويربط الـ webhook.
didit-integration-prompt.md
You are integrating Didit into a marketplace that lists third-party sellers (Etsy, Shopify, Faire, Amazon Handmade, OnBuy archetype). EU Digital Services Act Article 30 and the new EU Anti-Money Laundering (AML) package require you to verify the seller (KYB) before any listing goes live, and to keep that verification fresh while they sell.
Four obligations on every seller:
1. Pull the company's registry record (legal name, registration number, status, incorporation date) from the authoritative government source.
2. Extract every Ultimate Beneficial Owner (UBO) — anyone owning 25% or more — and run a closed-loop KYC on each one.
3. Screen the company AND every UBO against sanctions, Politically Exposed Persons (PEP), and adverse-media lists.
4. Collect the corporate evidence (certificate of incorporation, tax registration, proof of business address) and watch the seller continuously for status changes, UBO turnover, AML hits, and document expiry.
Pricing (verified live):
- KYB session (registry + company AML + documents + key-people flow): $2.00 per seller, pay-per-call
- Linked KYC per UBO: $0.33 per UBO (ID + Passive Liveness + Face Match + IP + AML)
- Ongoing AML monitoring: $0.07 per user per year
- First 500 KYC 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.
- A workflow_id for KYB from the Workflow Builder. The workflow's type (KYC or KYB) drives the session shape — no explicit business flag is needed on the request.
- A workflow_id for KYC bundled with ID + Passive Liveness + Face Match + IP + AML, used for the linked UBO sessions.
STEP 1 — Create the KYB session
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: <your api key>
Content-Type: application/json
Body:
{
"workflow_id": "<your KYB workflow id>",
"vendor_data": "<your seller id, max 256 chars>",
"callback_url": "https://<your-app>/sellers/kyb/callback",
"expected_country": "GB",
"metadata": {
"seller_id": "<your internal seller id>",
"marketplace_segment": "handmade"
}
}
Response: 201 Created with the hosted session URL. Email it to the seller or embed it in your onboarding UI. Behind the scenes, Didit runs:
- kyb_registry — live registry lookup against the country's authoritative source
- kyb_company_aml — sanctions / PEP / adverse media on the company
- kyb_documents — document collection + Optical Character Recognition (OCR) (incorporation, TIN, proof of address)
- kyb_key_people — UBO + director extraction with linked-KYC sessions
STEP 2 — Read the signed webhook on KYB completion
Didit POSTs to your callback. KYB SESSION statuses are UPPER_SNAKE_CASE:
Body (excerpted):
{
"session_id": "<uuid>",
"session_kind": "business",
"vendor_data": "<your seller id>",
"status": "APPROVED",
"decision": {
"company": {
"legal_name": "Maker Goods Ltd.",
"registration_number": "1029847",
"country_code": "GB",
"registry_status": "ACTIVE"
},
"features": [
{ "node_id": "kyb_registry", "status": "APPROVED" },
{ "node_id": "kyb_company_aml", "status": "APPROVED", "total_hits": 0 },
{ "node_id": "kyb_documents", "status": "APPROVED" },
{ "node_id": "kyb_key_people", "status": "APPROVED",
"key_people": [
{ "uuid": "<uuid>", "name": "Sara Ortega", "role": "director", "is_ubo": true, "ownership_percentage": 60, "kyc_status": "Approved", "kyc_session_url": "https://verify.didit.me/..." },
{ "uuid": "<uuid>", "name": "Niels Janssen", "role": "shareholder", "is_ubo": true, "ownership_percentage": 30, "kyc_status": "Approved", "kyc_session_url": "https://verify.didit.me/..." }
]
}
]
}
}
SESSION status enum (KYB · UPPER_SNAKE_CASE):
NOT_STARTED | IN_PROGRESS | AWAITING_USER | APPROVED | DECLINED | IN_REVIEW | RESUBMITTED | ABANDONED | EXPIRED
FEATURE status enum (inside decision.features[].status · UPPER_SNAKE_CASE):
NOT_FINISHED | APPROVED | DECLINED | IN_REVIEW | RESUB_REQUESTED | AWAITING_USER
Note: kyc_status on key_people IS Title Case ("Approved" / "Declined" / "Pending") — those are KYC sessions linked from inside the KYB feature, not KYB features themselves.
Verify the X-Signature-V2 header BEFORE reading the body — HMAC SHA-256 of the raw bytes with your webhook secret.
STEP 3 — Linked KYC on each UBO is automatic
When the seller completes the hosted KYB flow and submits the UBO list, Didit spawns a child KYC session per UBO using the KYC workflow you configured on the KYB workflow. Each child session has its own session_id and its own hosted URL on the kyc_session_url field inside the key-people block.
You don't need to call POST /v3/session/ again for the UBOs — they're stitched to the parent KYB session automatically. You DO need to drive each UBO through their hosted KYC URL (email it, SMS it, embed it in your seller dashboard).
Per-UBO KYC session status is Title Case With Spaces (KYC convention):
Approved | Declined | In Review | Resubmitted | Expired | Not Finished | Kyc Expired | Abandoned
Linked-KYC pricing: $0.33 per UBO.
STEP 4 — Retrieve the decision
GET https://verification.didit.me/v3/session/{sessionId}/decision/
Headers:
x-api-key: <your api key>
Returns the full KYB decision payload — company block, AML hits, document OCR, every UBO with their kyc_status and kyc_session_url. Use this for audit-pack export and for re-rendering the seller status in your admin UI.
STEP 5 — Decide
Branch logic:
APPROVED → activate the seller, allow listings.
IN_REVIEW → keep listings off, wait for analyst webhook update.
DECLINED → refuse onboarding, log the decision_reason_code.
AWAITING_USER → nudge the seller to complete the pending step (typically UBO list submission).
Pre-DSA Article 30: store the trader information (legal name, registration number, address, contact) in your trader-information record alongside the decision payload.
STEP 6 — Ongoing monitoring is automatic when enabled
Enable Ongoing AML on the seller and on each UBO ($0.07/user/year). The session status updates automatically as new sanctions hits land, dissolutions are filed in the registry, or document expirations approach. Your webhook fires on every state change.
No separate endpoint to call — the same workflow drives it.
WEBHOOK EVENT NAMES
- status.updated — session status changed (filter on data.session_kind === "business" for KYB).
- data.updated — session data changed (registry refresh, key-people submission, document upload, ongoing AML hit).
- business.status.updated — the linked Business entity changed.
- business.data.updated — Business entity data changed.
Verify X-Signature-V2 on every payload. The webhook secret is per-environment — sandbox key is separate from production.
CONSTRAINTS
- KYB session statuses use UPPER_SNAKE_CASE (APPROVED, IN_REVIEW, DECLINED). KYC session statuses use Title Case (Approved, In Review, Declined). They live in different APIs — don't mix them in the same code path.
- Default record retention is 5 years post-relationship per the EU AML package; some jurisdictions go higher.
- You cannot replace the registry lookup with a self-attested form — DSA Article 30 requires the data to come from an authoritative source.
Read the docs:
- https://docs.didit.me/business-verification/integration-guide
- https://docs.didit.me/business-verification/statuses
- https://docs.didit.me/business-verification/webhooks
- 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 KYC verifications free every month, no credit card.
متوافق حسب التصميم
افتح دولة جديدة بنقرة واحدة. نحن نقوم بالعمل الشاق.
نحن نفتح الشركات التابعة المحلية، ونؤمن التراخيص، ونجري اختبارات الاختراق، ونحصل على الشهادات، ونتوافق مع كل لائحة جديدة. لنشر عمليات التحقق في بلد جديد، ما عليك سوى تفعيل مفتاح. أكثر من 220 دولة تعمل، يتم تدقيقها واختبار اختراقها كل ربع سنة, المزود الوحيد للهوية الذي وصفته حكومة دولة عضو في الاتحاد الأوروبي رسميًا بأنه أكثر أمانًا من التحقق الشخصي.