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

# مراقبة المعاملات: دليل البدء السريع في 10 دقائق

> مع Didit، أرسل أول معاملة وشاهد القواعد تعمل وأعدّ webhooks في أقل من 10 دقائق. تشمل 1,000 معاملة شهرياً، ثم $0.001 لكل معاملة.

أعدّ مراقبة المعاملات في أقل من 10 دقائق. سترسل معاملة تجريبية، وتفحص درجتها، وتفعّل قاعدة جاهزة، وتعيد الإرسال لترى تفعيلها، ثم تتحقق من وصول الـ webhook.

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

* تطبيق Didit مع تفعيل مراقبة المعاملات (*الإعدادات ← مراقبة المعاملات ← تفعيل*).
* مفتاح API.
* endpoint للـ webhook يمكن الوصول إليه من الإنترنت.

## الخطوات

**1. إرسال معاملة أساسية**

```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 '{
    "transaction_id": "baseline-0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "500.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-42", "full_name": "Jane Doe" },
    "counterparty": { "entity_type": "company", "full_name": "Acme Supplier" }
  }'
```

تتضمّن الاستجابة:

* `status`: القيمة `APPROVED` إذا لم تُفعَّل أي قاعدة، والقيمتان `IN_REVIEW` / `DECLINED` إذا تم تشغيل أي قاعدة.
* `score`: عدد صحيح من 0 إلى 100+.
* `rule_runs`: مصفوفة تضم كل قاعدة قيّمت هذه المعاملة.

**2. تفعيل قاعدة جاهزة**

انتقل إلى *المعاملات ← القواعد ← المكتبة* في Business Console. اختر إعدادًا مسبقًا، على سبيل المثال **Structuring (outbound)**: يُشغَّل عندما يرسل المستخدم نفسه 20+ تحويلًا صادرًا أقل من €10,000 خلال 30 يومًا. فعّله واحفظ.

**3. إرسال معاملات تُفعّل القاعدة**

أرسل 20 معاملة بسرعة للمستخدم نفسه، كل منها أقل من €10,000:

```bash theme={null}
for i in $(seq 1 20); do
  curl -X POST https://verification.didit.me/v3/transactions/ \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"transaction_id\": \"struct-$i\",
      \"transaction_category\": \"finance\",
      \"transaction_details\": {
        \"direction\": \"outbound\",
        \"amount\": \"9500.00\",
        \"currency\": \"EUR\"
      },
      \"subject\": { \"entity_type\": \"person\", \"vendor_data\": \"user-42\", \"full_name\": \"Jane Doe\" },
      \"counterparty\": { \"entity_type\": \"company\", \"full_name\": \"Shell Co $i\" }
    }"
done
```

عند الإرسال العشرين، تُفعَّل قاعدة Structuring. تُعيد المعاملة `status: IN_REVIEW`، ويعكس `score` القيمة `score_delta` الخاصة بالقاعدة.

**4. الاشتراك في webhooks المعاملات**

```bash theme={null}
curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "TM events",
    "url": "https://yourapp.com/webhooks/didit-tm",
    "subscribed_events": ["transaction.created", "transaction.status.updated"]
  }'
```

تتضمن الاستجابة `secret_shared_key`. احفظه فورًا باسم `DIDIT_WEBHOOK_SECRET` في ملف `.env` الخاص بك:

```bash theme={null}
DIDIT_WEBHOOK_SECRET=whsec_...   # signing secret returned from webhook registration
```

ثم تحقق من HMAC الخاص بـ `X-Signature-V2` في كل webhook واردة قبل الوثوق بها (أعد حساب HMAC-SHA256 على الجسم بعد تطبيعه، وقارن بطريقة ثابتة الزمن، وارفض الطوابع الزمنية القديمة). راجع [webhooks المعاملات](https://docs.didit.me/ar/transaction-monitoring/webhooks.md) للاطلاع على payload وكود التحقق الكامل.

ترسل كل معاملة لاحقة إلى endpoint الخاص بك في الوقت الفعلي.

**5. الفحص في وحدة التحكم**

انتقل إلى *المعاملات* في وحدة التحكم:

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

**6. استرجاع معاملة عبر API**

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

يُعيد [مخطط الاستجابة الكامل](https://docs.didit.me/ar/transaction-monitoring/response-schema.md): ‏score والقواعد المطابقة وإثراء الأطراف وفحص AML والمزيد.

## ما الذي أعددته للتو

* **احتساب الدرجات في الوقت الفعلي**: تمر كل معاملة عبر كل قاعدة نشطة.
* **فحص AML**: تُفحص الأطراف المقابلة تلقائيًا مقابل العقوبات والأخبار السلبية.
* **إثراء عنوان IP**: تُثرى كل معاملة ببيانات دولة عنوان IP وASN وعلامات VPN/Tor.
* **webhooks**: إشعار فوري عند كل معاملة.
* **سجل التدقيق**: يمكن الاستعلام عن عمليات تشغيل القواعد والتنبيهات وانتقالات الحالة كلها في وحدة التحكم.

## الخطوات التالية الشائعة

> [card] [دليل التكامل](https://docs.didit.me/ar/transaction-monitoring/integration-guide.md)
>
> البنية الكاملة وأنماط التنفيذ.

> [card] [شرح مفصل للقواعد](https://docs.didit.me/ar/transaction-monitoring/rules.md)
>
> كيف تعمل القواعد، والشروط، والتجميعات، والإجراءات.

> [card] [احتساب درجة المخاطر](https://docs.didit.me/ar/transaction-monitoring/risk-scoring.md)
>
> كيف تتحول الدرجات إلى حالات.

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

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

> [card] [الحالات](https://docs.didit.me/ar/transaction-monitoring/cases.md)
>
> التحقيق في الحالات وحلّها.


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