> ## 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 له لقواعد مراقبة المعاملات. 1,000 شهرياً مشمولة، ثم $0.001 لكل استدعاء.

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

## استرجاع معاملات المستخدم

صفِّ قائمة المعاملات حسب `vendor_data`:

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

تُعيد هذه الواجهة كل معاملة يكون فيها المستخدم هو المتقدِّم. للاطلاع على سجل الطرف المقابل، صفِّ النتائج في Business Console (endpoint القائمة العامة يصفّي بالمتقدِّم فقط).

## كيف ترتبط المعاملات بالمستخدمين

```mermaid theme={null}
flowchart LR
    T["Transaction<br/>txn_id=tx-0001"]
    A["applicant:<br/>vendor_data=user-42"]
    C["counterparty:<br/>vendor_data=user-99"]
    U1[User: user-42]
    U2[User: user-99]
    T --> A
    T --> C
    A -.-> U1
    C -.-> U2
```

تتضمن كل معاملة حتى أربعة أطراف (المتقدِّم، والمُرسِل، والمستفيد، والطرف المقابل). عندما يتضمن أحد الأطراف `vendor_data`، تربطه Didit بهذا المستخدم. الأطراف التي لا تتضمن `vendor_data` تُخزَّن كلقطات خارجية (دون ربط بكيان).

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

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

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

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

تُحتسب هذه الإشارات في الوقت الفعلي وتُقيَّم مقابل [قواعد المعاملات](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` الخاص بالمستخدم إلى قائمة الحظر أو قائمة مخصصة.

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

## مراقبة سلوك المستخدم

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

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

## جلسات المعالجة

عندما تنتقل معاملة إلى `AWAITING_USER`، تُنشئ Didit **جلسة معالجة** مرتبطة تطلب من المستخدم إكمال تحقق إضافي (على سبيل المثال، مستندات مصدر الأموال، أو هوية محدَّثة). جلسة المعالجة مرتبطة بالـ`vendor_data` نفسه، وعند إكمالها تُحدَّث حالة المعاملة تلقائياً.

راجع [حالات المعاملات](https://docs.didit.me/ar/transaction-monitoring/statuses.md) للاطلاع على آلة الحالات الكاملة.

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

لاستيعاب المعاملات التاريخية في كيان User موجود، مرِّر `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": "2500.00",
    "currency": "EUR",
    "applicant": { "vendor_data": "user-42" },
    "counterparty": { "name": "Historic payer" }
  }'
```

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

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

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