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

# معاملات الشركات: سجل KYT

> استرجع سجل معاملات كيان شركة في Didit، واطلع على كيفية تغذية النشاط المستمر لقواعد مراقبة المعاملات المتعلقة بالسرعة والسلوك والفحص.

تُربط بملف الشركة كل معاملة ترسلها مع معرّف `vendor_data` يطابق كيان شركة، سواء كانت الشركة مقدّم الطلب أو المُرسِل أو المستفيد أو الطرف المقابل. تصبح الشركة سجلاً مستمراً لنشاطها، وتستخدم مراقبة المعاملات هذا السجل لتغذية قواعد السرعة والسلوك والفحص على مستوى الشركة.

## استرجاع معاملات الشركة

قم بتصفية قائمة المعاملات باستخدام `vendor_data` الخاص بالشركة:

```bash theme={null}
curl -G https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=biz-acme" \
  --data-urlencode "page_size=50"
```

يعيد هذا كل معاملة تظهر فيها الشركة بصفتها مقدّم الطلب. لمعرفة سجل الطرف المقابل، قم بالتصفية في Business Console (تصفّي endpoint العامة لقائمة المعاملات حسب مقدّم الطلب فقط).

## كيف ترتبط المعاملات بالشركات

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0042"]
    A["applicant:<br/>vendor_data=biz-acme"]
    C["counterparty:<br/>vendor_data=biz-widgets"]
    B1[Business: biz-acme]
    B2[Business: biz-widgets]
    T --> A
    T --> C
    A -.-> B1
    C -.-> B2
```

تتضمن كل معاملة ما يصل إلى أربعة أطراف (`applicant` و`remitter` و`beneficiary` و`counterparty`). عندما يتضمن أحد الأطراف `vendor_data` يطابق كيان شركة في تطبيقك، يربط Didit ذلك الطرف بتلك الشركة. أما الأطراف التي لا تتضمن `vendor_data` فتُخزَّن كلقطات خارجية دون أي ربط بكيان.

راجع [إرسال المعاملات](https://docs.didit.me/ar/transaction-monitoring/transactions.md) للاطلاع على نموذج الأطراف الكامل.

## أنواع الأطراف المختلطة

يمكن لمعاملة واحدة أن تجمع بين المستخدمين والشركات في أطرافها، كأن يدفع مستخدم فرد لشركة:

```json theme={null}
{
  "txn_id": "tx-0099",
  "direction": "OUTBOUND",
  "amount": "500.00",
  "currency": "EUR",
  "applicant": { "vendor_data": "user-42" },
  "counterparty": { "vendor_data": "biz-acme" }
}
```

أو تحويل بين شركتين (B2B):

```json theme={null}
{
  "txn_id": "tx-0100",
  "direction": "OUTBOUND",
  "amount": "120000.00",
  "currency": "USD",
  "applicant": { "vendor_data": "biz-acme" },
  "counterparty": { "vendor_data": "biz-widgets" }
}
```

يحلّل Didit كل طرف على حدة بناءً على `vendor_data`، فتُضاف المعاملة الواحدة إلى ملف كل كيان مطابق.

## إشارات المخاطر المجمّعة

تغذي المعاملات إشارات على مستوى الشركة التالية:

| الإشارة | تستخدمها |
| - | - |
| إجمالي الحجم الوارد / الصادر | قواعد السرعة، وتحديد العتبات |
| عدد المعاملات ضمن نافذة زمنية | قواعد السرعة |
| الأطراف المقابلة الفريدة | قواعد السلوك |
| الولايات القضائية عالية المخاطر التي تم التعامل معها | قواعد الجغرافيا |
| التعرض لأطراف مقابلة خاضعة للعقوبات | قواعد الفحص |
| تنوع وسائل الدفع | قواعد الاحتيال |

تُحسب هذه الإشارات في الوقت الفعلي، وتُقيَّم مقابل [قواعد المعاملات](https://docs.didit.me/ar/transaction-monitoring/rules.md) النشطة لديك. عندما تنطبق قاعدة، يمكن نقل الشركة تلقائياً إلى `FLAGGED` أو `BLOCKED`، بحسب إجراء القاعدة.

## كيف تؤثر القواعد في الشركات

يمكن أن تتضمن `actions` في قاعدة المعاملات ما يلي:

* `add_score`: يزيد درجة المخاطر للمعاملة.
* `change_status`: يحدد حالة المعاملة (`IN_REVIEW` أو `DECLINED` أو `AWAITING_USER`).
* `add_tags`: يضيف وسوماً إلى المعاملة.
* `add_to_list`: يضيف `vendor_data` الخاص بالشركة إلى قائمة الحظر أو قائمة مخصصة.

عندما تضيف القاعدة الشركة إلى قائمة الحظر، يتحول كيان الشركة إلى `BLOCKED` ويُطلق webhook باسم `business.status.updated`.

## مراقبة سلوك الشركة

استخدم تبويب المعاملات في صفحة تفاصيل الشركة داخل Business Console من أجل:

* الاطلاع على كل المعاملات بترتيبها الزمني.
* التصفية حسب الحالة أو المبلغ أو الاتجاه أو الطرف المقابل.
* فتح أي معاملة لفحص تشغيلات القواعد، وإثراء عنوان IP، ونتائج فحص العملات المشفرة.
* فتح حالة ضد الشركة لتتبع تحقيق.

## وسائل الدفع المملوكة للشركة

يمكن أن ترتبط بكل معاملة وسيلة دفع واحدة أو أكثر (بطاقات مصرفية، وحسابات مصرفية، ومحافظ إلكترونية، ومحافظ مشفرة). وعندما تكون وسيلة الدفع مملوكة لشركة، فإنها ترتبط بها عبر `vendor_data`، فتطّلع على كل وسيلة دفع استخدمتها الشركة تاريخياً مباشرة في صفحة تفاصيل الشركة.

## استيعاب السجل التاريخي

لاستيعاب معاملات تاريخية لشركة قائمة، مرّر `txn_date` بتاريخ سابق:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "txn_id": "legacy-0001",
    "txn_date": "2024-03-15T10:00:00Z",
    "direction": "INBOUND",
    "amount": "25000.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "biz-acme" },
    "counterparty": { "name": "Historic payer" }
  }'
```

> [!NOTE]
>
> تمر المعاملات التاريخية عبر محرك القواعد. إذا أردت استيعاب السجل **دون** تشغيل القواعد، فاستخدم مسار الاستيراد في الواجهة، الذي يدعم وضع **الاستيعاب دون تشغيل القواعد**.

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

> [card] [إرسال المعاملات](https://docs.didit.me/ar/transaction-monitoring/transactions.md)
>
> مرجع كامل لـ payload.

> [card] [القواعد](https://docs.didit.me/ar/transaction-monitoring/rules.md)
>
> كيف تُقيِّم القواعد المعاملات وتتصرف تجاه الشركات.

> [card] [الحالات](https://docs.didit.me/ar/transaction-monitoring/statuses.md)
>
> مرجع حالات المعاملات وحالات المعالجة.


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