> ## 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 والدول

> احظر كيانات شركات Didit حسب vendor_data أو الدولة، واطّلع على طريقة فحص الحظر ومسارات الواجهة والـAPI لإضافته أو إزالته.

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

## أنواع المعرّفات المدعومة للشركات

| النوع | المفتاح | يتطابق عندما… |
| - | - | - |
| الشركة | `BUSINESS` | تستخدم جلسة جديدة أو معاملة `vendor_data` المدرج في القائمة |
| الدولة | (يُضبط بشكل منفصل) | تتطابق دولة الشركة مع قائمة الدول الخطرة |
| IP | `IP_ADDRESS` | يتطابق عنوان IP الخاص بمُقدِّم الطلب (أو نطاق CIDR) |
| بصمة الجهاز | `DEVICE_FINGERPRINT` | يتطابق جهاز مُقدِّم الطلب |
| عنوان المحفظة | `WALLET_ADDRESS` | تتطابق المحفظة الرقمية المرتبطة بالشركة |
| الحساب البنكي | `BANK_ACCOUNT` | يتطابق رقم IBAN أو الحساب البنكي |

> [!NOTE]
>
> تعمل قوائم الحظر الخاصة بالوجوه والمستندات على مستوى الفرد (المستخدم)، لا على مستوى الشركة. لحظر المديرين أو المستفيدين الحقيقيين (UBO)، أدرجهم في قوائم الحظر بوصفهم مستخدمين، فتنتقل مشاركتهم في أي شركة بعد ذلك إلى مراجعة الأشخاص الرئيسيين فيها.

## كيف يتم الإدراج في قائمة الحظر

> [!NOTE]
>
> لا يؤدي رفض جلسة التحقق من الشركات (KYB) إلى إدراج الشركة في قائمة الحظر. تنتهي الجلسة بحالة `Declined`، وتبقى الشركة في حالة `ACTIVE`، ولا يُكتب أي إدخال في القائمة. الإدراج في قائمة الحظر خطوة يدوية: أضف الإدخال من [صفحة قائمة الحظر](https://docs.didit.me/ar/console/blocklist-users.md) أو باستخدام [Lists API](https://docs.didit.me/ar/management-api/lists/overview.md). كما أن إدخال `BUSINESS` (أي `vendor_data`) يغيّر حالة الشركة أيضاً إلى `BLOCKED`.

**1. تلقائي: عند وجود الدولة في القائمة الخطرة**

إذا ظهرت دولة تأسيس الشركة في قائمة الدول الخطرة التي ضبطتها، يُرفض جلسة التحقق من الشركات (KYB).

**2. تلقائي: عند وجود كيان خاضع للعقوبات**

يؤدي تطابق الشركة في فحص AML، إذا تجاوز حد الرفض، إلى رفض الجلسة. ولا يُكتب أي إدخال في القائمة، لذا أدرج الشركة في قائمة الحظر بنفسك إذا أردت رفض `vendor_data` الخاص بها من تلك اللحظة فصاعداً.

**3. يدوي: من وحدة التحكم**

يُدرج المحلل الشركة في قائمة الحظر من *Businesses → \[business] → Actions → Add to blocklist*.

**4. برمجي: عبر Lists API**

استخدم [Lists API](https://docs.didit.me/ar/management-api/lists/overview.md) لإضافة إدخالات مباشرة إلى قائمة حظر الشركات.

## الدول الخطرة

يأتي كل تطبيق مع قائمة افتراضية بالدول الخطرة يمكن ضبطها من *Settings → Blocklist → Countries*. من أمثلة رموز ISO المدرجة افتراضياً: `IRN` و`PRK` و`SYR` و`AFG` و`RUS` و`MMR` (وقد تتغير هذه القائمة، إذ تتبع القائمة الافتراضية إرشادات FATF وOFAC).

عند إنشاء شركة مع `country_code` مطابق:

* تُرفض جلسة التحقق من الشركات (KYB).
* لا يُصدر أي رابط للجلسة.
* يُنشأ كيان الشركة بحالة `BLOCKED`.

## إضافة شركة إلى قائمة الحظر عبر API

استخدم [Lists API](https://docs.didit.me/ar/management-api/lists/overview.md) لإضافة إدخال إلى قائمة الحظر برمجياً:

1. [اعرض جميع القوائم](https://docs.didit.me/ar/management-api/lists/list.md) مع تصفية `entry_type=business` و`is_system=true` للعثور على قائمة حظر الشركات الخاصة بالنظام.
2. [أنشئ إدخالاً](https://docs.didit.me/ar/management-api/lists/create-entry.md) في تلك القائمة مع ضبط `value` على `vendor_data` الخاص بالشركة، مع `display_label` و`comment` اختياريين لأغراض التدقيق.

## التطبيق وقت المعاملة

تنتقل الشركات المدرجة في قائمة الحظر إلى مراقبة المعاملات تلقائياً:

* تُرفض تلقائياً المعاملات التي تتضمن **شركة مقدِّم طلب مدرجة في قائمة الحظر**.
* تُعلَّم المعاملات التي تتضمن **شركة طرف مقابل مدرجة في قائمة الحظر** أو تُرفض، بحسب إعدادات القواعد لديك.

تُفعَّل القواعد المعدّة مسبقاً، مثل "Sanctioned counterparty"، عند حدوث هذه التطابقات.

## إزالة شركة من قائمة الحظر

* **Console**: *Blocklist → Businesses → row actions → Remove*.
* **API**: استخدم endpoint [Delete entry](https://docs.didit.me/ar/management-api/lists/delete-entry.md) مع UUID للقائمة وUUID للإدخال.

لا تغيّر الإزالة قيمة `status` الخاصة بالشركة تلقائياً. استخدم `PATCH /v3/businesses/{vendor_data}/update-status/` لإعادة الشركة إلى `ACTIVE`.

## سجل التدقيق

تُسجَّل كل عملية إضافة أو إزالة في [سجل التدقيق](https://docs.didit.me/ar/console/audit-logs.md) مع:

* الجهة الفاعلة (البريد الإلكتروني للمستخدم أو `'system'` أو `'api'`).
* الطابع الزمني.
* التعليق الاختياري.
* الجلسة المرجعية إذا أُنشئ الإدخال تلقائياً.

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

> [card] [Lists API](https://docs.didit.me/ar/management-api/lists/overview.md)
>
> مرجع كامل لواجهة برمجة قوائم الحظر.

> [card] [قائمة الحظر في وحدة التحكم](https://docs.didit.me/ar/console/blocklist-users.md)
>
> إدارة قوائم الحظر من الواجهة.

> [card] [العمليات](https://docs.didit.me/ar/entities/businesses/operations.md)
>
> تغيير حالة الشركة.


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