التحقق من الشركات (KYB): دليل البدء السريع في 10 دقائق

يرشدك هذا الدليل خلال عملية التحقق الكامل من KYB في أقل من 10 دقائق. ستنشئ سير عمل، وتبدأ جلسة، وترسل رابط التحقق المستضاف إلى جهة الاتصال لديك في الشركة، ثم تنتظر webhook وتجلب القرار النهائي.

المتطلبات الأساسية

تطبيق Didit مفعّل فيه KYB. أنشئ تطبيقاً عبر business.didit.me إذا لزم الأمر.
مفتاح API من Developer Settings → API Keys.
endpoint الخاص بـ webhook يمكن الوصول إليه من الإنترنت (لاستقبال webhook القرار).

الخطوات

أنشئ سير عمل KYB في لوحة التحكم

انتقل إلى Workflows → Create workflow. اختر التحقق من الشركات باعتباره نوع سير العمل.فعّل الميزات التي تحتاجها:

البحث في سجل الشركات (مطلوب)
فحص AML للشركة (موصى به)
الأشخاص الرئيسيون (مطلوب في معظم القطاعات الخاضعة للتنظيم)
المستندات (اختياري: اختر أنواع المستندات التي ستشترطها)

احفظ workflow_id وانسخه، فستحتاج إليه في الخطوة التالية.

أنشئ جلسة التحقق من الشركات (KYB) عبر API

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_KYB_WORKFLOW_ID",
    "vendor_data": "biz-acme-001"
  }'

تتضمن الاستجابة session_id وsession_number وurl، وهو رابط التحقق المستضاف الذي تسلّمه لجهة الاتصال في الشركة. يضع نوع سير العمل (KYB) علامة تلقائياً على الجلسة بوصفها جلسة شركة.

أرسل الرابط إلى جهة الاتصال في الشركة

سلّم url إلى مسؤول الشركة عبر بريدك الإلكتروني أو قناة المحادثة الخاصة بك. يفتح الرابط، ويملأ بيانات السجل، ويضيف الأشخاص الرئيسيين والمستفيدين الحقيقيين (UBO)، ويرفع المستندات.يمكنك تخصيص التجربة المستضافة بالهوية التجارية والشعار والنطاق، انظر العلامة البيضاء.

استقبل webhook الحالة

عندما تُنهي الشركة التدفق وتصل معالجة KYB إلى حالة نهائية، يرسل Didit حدث status.updated بطريقة POST إلى endpoint الخاص بـ webhook لديك. تحمل أحداث جلسات الشركات القيمة session_kind: "business" داخل data، فصفِّ الأحداث بهذه القيمة لتوجيه الحدث إلى معالج KYB لديك.تحقق من توقيع HMAC الموجود في الرأس X-Signature-V2 قبل الوثوق بالحدث (انظر webhook)، ثم شغّل المنطق اللاحق. خزّن secret_shared_key الخاص بالوجهة (الذي يُعاد عند تسجيل الـ webhook) باسم DIDIT_WEBHOOK_SECRET في ملف .env.مثال على payload:

{
  "event_id": "7f3c2c1e-6a1d-4c36-9d8e-0d3b5f4e2a10",
  "webhook_type": "status.updated",
  "session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "business_session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "session_kind": "business",
  "vendor_data": "biz-acme-001",
  "status": "Approved",
  "created_at": 1776515400,
  "timestamp": 1776515401,
  "decision": { "...": "full KYB decision" }
}

استرجع القرار (اختياري)

يحتوي payload الخاص بـ webhook من نوع status.updated على القرار الكامل بالفعل. لا تحتاج إلى استدعاء endpoint هذا إلا إذا لم تشترك في webhook، أو أردت جلب القرار عند الطلب لاحقاً.

curl https://verification.didit.me/v3/session/bs_01H.../decision/ \
  -H "x-api-key: YOUR_API_KEY"

يتضمن القرار بيانات السجل، والأشخاص الرئيسيين (المستفيدين الحقيقيين، والمساهمين، والمديرين، والممثلين)، ومطابقات AML، والمستندات، والنتائج لكل ميزة. انظر مخطط الاستجابة للاطلاع على مرجع payload الكامل.

تصرّف بناءً على القرار

بناءً على status:

"Approved": أدرج الشركة.
"Declined": ارفض الطلب وسجّل الوسوم warnings[] من القرار.
"In Review": انتظر قرار المحلل، وستتلقى webhook آخر عند حسم القرار.

مثال Node.js

import fetch from 'node-fetch';

const API_KEY = process.env.DIDIT_API_KEY!;
const WORKFLOW_ID = process.env.DIDIT_KYB_WORKFLOW_ID!;
const BASE_URL = 'https://verification.didit.me';

async function startKybVerification(vendorData: string) {
  const res = await fetch(`${BASE_URL}/v3/session/`, {
    method: 'POST',
    headers: {
      'x-api-key': API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ workflow_id: WORKFLOW_ID, vendor_data: vendorData }),
  });
  if (!res.ok) throw new Error(`Session create failed: ${res.status}`);
  return res.json();
}

async function getDecision(sessionId: string) {
  const res = await fetch(`${BASE_URL}/v3/session/${sessionId}/decision/`, {
    headers: { 'x-api-key': API_KEY },
  });
  return res.json();
}

// Kick off the flow
const { session_id, url } = await startKybVerification('biz-acme-001');
console.log('Deliver this URL to your contact:', url);

// ... later, after the webhook confirms completion:
const decision = await getDecision(session_id);
console.log('KYB status:', decision.status);

ما يحدث تلقائياً

البحث في سجل الشركات عبر 190+ ولاية قضائية.
استخراج المستفيدين الحقيقيين (UBO) والمسؤولين من بيانات السجل.
فحص AML على مستوى الشركة (العقوبات، والأشخاص المعرضون سياسياً PEP، والأخبار السلبية).
فحص AML على مستوى الشخص لكل طرف محدد.
التعرف الضوئي على المستندات (OCR) وإجراء المقارنة المرجعية بينها.
إنشاء الملف التعريفي للشركة وتجميعه بحسب vendor_data.

الخطوات التالية

دليل التكامل

بنية شاملة من البداية إلى النهاية، والاستطلاع مقابل webhook، ومنطق إعادة المحاولة.

webhook الخاص بـ KYB

كل أحداث KYB وشكل payload كل منها.

الحالات

مرجع لحالات الجلسة والميزة والسجل.

مخطط الاستجابة

payload الكامل لقرار KYB.

كيانات الشركات

كيفية تجميع الملفات التعريفية عبر الجلسات.

البدء

الميزات

ملفات الشركات

المرجع

Console

التحقق من الشركات (KYB): دليل البدء السريع في 10 دقائق

المتطلبات الأساسية

الخطوات

مثال Node.js

ما يحدث تلقائياً

الخطوات التالية

دليل التكامل

webhook الخاص بـ KYB

الحالات

مخطط الاستجابة

كيانات الشركات

​المتطلبات الأساسية

​الخطوات

​مثال Node.js

​ما يحدث تلقائياً

​الخطوات التالية

دليل التكامل

webhook الخاص بـ KYB

الحالات

مخطط الاستجابة

كيانات الشركات

المتطلبات الأساسية

الخطوات

مثال Node.js

ما يحدث تلقائياً

الخطوات التالية