> ## 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.

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

> تحقق من الشركات مع Didit في أقل من 10 دقائق: السجل، والمستفيدون الحقيقيون، وAML، وwebhook. من $2.00 لكل عملية تحقق حسب الدولة والمستوى، بلا عقود.

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

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

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

## الخطوات

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

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

فعّل الميزات التي تحتاجها:

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

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

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

```bash theme={null}
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) علامة تلقائياً على الجلسة بوصفها جلسة شركة.

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

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

يمكنك تخصيص التجربة المستضافة بالهوية التجارية والشعار والنطاق، انظر [العلامة البيضاء](https://docs.didit.me/ar/console/white-label.md).

**4. استقبل webhook الحالة**

عندما تُنهي الشركة التدفق وتصل معالجة KYB إلى حالة نهائية، يرسل Didit حدث `status.updated` بطريقة POST إلى endpoint الخاص بـ webhook لديك. تحمل أحداث جلسات الشركات القيمة `session_kind: "business"` داخل `data`، فصفِّ الأحداث بهذه القيمة لتوجيه الحدث إلى معالج KYB لديك.

تحقق من توقيع HMAC الموجود في الرأس `X-Signature-V2` قبل الوثوق بالحدث (انظر [webhook](https://docs.didit.me/ar/integration/webhooks.md))، ثم شغّل المنطق اللاحق. خزّن `secret_shared_key` الخاص بالوجهة (الذي يُعاد عند تسجيل الـ webhook) باسم `DIDIT_WEBHOOK_SECRET` في ملف `.env`.

مثال على payload:

```json theme={null}
{
  "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" }
}
```

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

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

```bash theme={null}
curl https://verification.didit.me/v3/session/bs_01H.../decision/ \
  -H "x-api-key: YOUR_API_KEY"
```

يتضمن القرار بيانات السجل، والأشخاص الرئيسيين (المستفيدين الحقيقيين، والمساهمين، والمديرين، والممثلين)، ومطابقات AML، والمستندات، والنتائج لكل ميزة. انظر [مخطط الاستجابة](https://docs.didit.me/ar/business-verification/response-schema.md) للاطلاع على مرجع payload الكامل.

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

بناءً على `status`:

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

## مثال Node.js

```typescript theme={null}
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) وإجراء المقارنة المرجعية بينها.
* إنشاء [الملف التعريفي للشركة](https://docs.didit.me/ar/business-verification/business-profiles.md) وتجميعه بحسب `vendor_data`.

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

> [card] [دليل التكامل](https://docs.didit.me/ar/business-verification/integration-guide.md)
>
> بنية شاملة من البداية إلى النهاية، والاستطلاع مقابل webhook، ومنطق إعادة المحاولة.

> [card] [webhook الخاص بـ KYB](https://docs.didit.me/ar/business-verification/webhooks.md)
>
> كل أحداث KYB وشكل payload كل منها.

> [card] [الحالات](https://docs.didit.me/ar/business-verification/statuses.md)
>
> مرجع لحالات الجلسة والميزة والسجل.

> [card] [مخطط الاستجابة](https://docs.didit.me/ar/business-verification/response-schema.md)
>
> payload الكامل لقرار KYB.

> [card] [كيانات الشركات](https://docs.didit.me/ar/entities/businesses/overview.md)
>
> كيفية تجميع الملفات التعريفية عبر الجلسات.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.