واجهة برمجة تطبيقات مراقبة المعاملات من Didit: قواعد فورية، إدارة حالات، وسير عمل تقارير الأنشطة المشبوهة (SARs) (AR)

إن إلحاق مستخدم عبر اعرف عميلك (KYC) يخبرك من هو في اليوم الأول، ولكنه لا يخبرك شيئًا عما يفعله في اليوم التسعين. تعتبر مراقبة المعاملات النصف الآخر من الامتثال — الطبقة المستمرة التي تراقب حركة الأموال وتحدد الأنماط الهامة: التجميع، والتدفقات السريعة للداخل والخارج، وارتفاعات السرعة، والأطراف المقابلة الخاضعة للعقوبات، والولايات القضائية عالية المخاطر.

إن واجهة برمجة تطبيقات مراقبة المعاملات من Didit هي محرك قواعد في الوقت الفعلي لذلك بالضبط. ترسل معاملة، فيعيد قرارًا في غضون أجزاء من الثانية، وأي شيء ينتهك قاعدة ما يرسل إلى مدير حالات مدمج حيث يقوم المحللون بالتحقيق، والتصعيد، وتقديم تقارير الأنشطة المشبوهة (SARs). يعمل هذا النظام لكل من العملات النقدية والمشفرة، ويكلف 0.02 دولار لكل معاملة بدون حد أدنى.

يشرح هذا الدليل كيفية عمله، وما تحتويه حزمة محرك القواعد، وكيفية دمجه.

النقاط الرئيسية

• اتخاذ القرارات في الوقت الفعلي. تعيد كل معاملة إحدى الحالات الأربع — APPROVED (موافق عليه)، IN_REVIEW (قيد المراجعة)، DECLINED (مرفوض)، أو AWAITING_USER (في انتظار المستخدم) — حتى تتمكن من التصرف قبل تسوية الأموال.
• 11 حزمة قواعد مدمجة تغطي مكافحة غسل الأموال وتمويل الإرهاب (AML/CTF)، واكتشاف الشذوذ، وأنماط FATF، وذكاء الجهاز، والاحتيال، ومراقبة العملات المشفرة، وفحص العملات المشفرة، والألعاب المسؤولة، والتجارة الإلكترونية. يمكنك بناء قواعدك الخاصة فوقها.
• إدارة الحالات المدمجة وسير عمل تقارير الأنشطة المشبوهة (SARs) — التنبيهات، وتعيين المحللين، وحالات التحقيق، وإيداع تقارير SARs تعيش داخل نفس المنتج، وليس أداة منفصلة.
• معالجة تلقائية للحالات AWAITING_USER تسمح للمعاملة التي تم وضع علامة عليها بتشغيل خطوة تحقق (إعادة KYC، إثبات الأموال) واستئنافها تلقائيًا بمجرد قيام المستخدم بتصفيتها.
• العملات النقدية والمشفرة في محرك واحد. يمكن لمعاملات العملات المشفرة أن تؤدي تلقائيًا إلى فحص المحفظة على السلسلة.
• 0.02 دولار لكل معاملة، الدفع حسب الاستخدام، بدون حد أدنى. يتم احتساب فحص مكافحة غسل الأموال على طرف تم وضع علامة عليه بشكل منفصل بسعر 0.20 دولار لكل فحص.

ماذا تفعل مراقبة المعاملات؟

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

تقوم Didit بتقييم كل معاملة فور حدوثها مقابل مكتبة من القواعد، وتلحق بها درجة مخاطر، وتعين حالة. تمر المعاملات منخفضة المخاطر بصمت. يتم الاحتفاظ بأي شيء يتجاوز عتبة للمراجعة، أو يتم رفضه بالكامل، أو يتم توجيهه مرة أخرى إلى المستخدم للمعالجة — ويتم فتح تنبيه لمحلل.

لماذا هي مهمة

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

المشكلة التشغيلية حقيقية بنفس القدر. تقوم معظم الفرق بتجميع المراقبة من بائع قواعد، وأداة منفصلة لإدارة الحالات، وعملية يدوية لتقارير SARs في جداول البيانات. تختصر Didit هذه المجموعة في واجهة برمجة تطبيقات واحدة ووحدة تحكم واحدة: القواعد، والتنبيهات، والتحقيق، والإبلاغ في نفس المكان، بسعر لكل معاملة بحيث تتناسب التكلفة مع الاستخدام بدلاً من تراخيص المقاعد.

التفاصيل الفنية

يتم إنشاء المعاملات مقابل واجهة برمجة التطبيقات الموحدة /v3/. كل معاملة مستقلة على transaction_id تتحكم فيه (فريد لكل تطبيق)، لذا لن تتسبب عمليات إعادة المحاولة أبدًا في احتساب مزدوج.

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_8f3a91",
    "category": "finance",
    "amount": 9800,
    "currency": "EUR",
    "currency_kind": "fiat",
    "txn_date": "2026-05-21T10:32:00Z",
    "subject": {
      "vendor_data": "user_4521",
      "role": "SENDER",
      "entity_type": "INDIVIDUAL"
    },
    "counterparty": {
      "role": "RECEIVER",
      "entity_type": "INDIVIDUAL"
    },
    "payment_method": "BANK_TRANSFER"
  }'

يقوم المحرك بتقييم المعاملة مقابل كل قاعدة نشطة ويعيد حالة بالإضافة إلى القواعد التي تم تشغيلها:

{
  "transaction_id": "txn_8f3a91",
  "status": "IN_REVIEW",
  "risk_score": 62,
  "triggered_rules": [
    { "name": "Structuring — amount below reporting threshold", "bundle": "AML/CTF", "action": "ADD_SCORE" },
    { "name": "High velocity — sender 24h count", "bundle": "Anomaly detection", "action": "CHANGE_STATUS" }
  ],
  "alert_id": "alrt_2c70d4"
}

الحالات. يتم تحديد كل معاملة إلى إحدى الحالات الأربع:

الحالة	المعنى
APPROVED	لم تتجاوز أي قاعدة عتبة الرفض — تستمر المعاملة.
IN_REVIEW	قامت قاعدة بوضع علامة على المعاملة — يتم فتح تنبيه للمحلل.
DECLINED	قاعدة صارمة (مثل طرف مقابل خاضع للعقوبات) منعت المعاملة.
AWAITING_USER	يتم تعليق المعاملة بانتظار إجراء من المستخدم — إعادة التحقق أو إثبات الأموال.

الفئات. تحمل المعاملات category بحيث تنطبق القواعد في السياق: finance، kyc، travel_rule، user_platform_event، gambling_bet، gambling_limit_change، gambling_bonus_change، و audit_trail_event.

السرعة والتجميع. تقوم القواعد المخصصة بالتقييم عبر نوافذ زمنية مع تجميعات العد، والمجموع، والعد المميز — بحيث يمكنك التعبير عن "أكثر من 5 تحويلات واردة من أطراف مقابلة مميزة في 24 ساعة" أو "حجم تراكمي يزيد عن 10,000 يورو في 7 أيام" دون كتابة معالج تدفق خاص بك.

خطافات الويب (Webhooks). اشترك في transaction.created و transaction.status.updated للحفاظ على دفتر الأستاذ الخاص بك متزامنًا عندما يحلل محلل تنبيهًا.

السعر. 0.02 دولار لكل معاملة، يتم الفواتير لكل مكالمة، بدون حد أدنى. إذا أدت معاملة تم وضع علامة عليها إلى فحص مكافحة غسل الأموال على طرف ما، يتم فواتير هذا الفحص بشكل منفصل بسعر 0.20 دولار.

11 حزمة قواعد مدمجة

لا تبدأ من دفتر قواعد فارغ. تقوم Didit بتزويد المحرك بـ 11 حزمة يمكنك تشغيلها وتعديلها:

1. المالية — التجميع، والمعاملات الكبيرة، وتجنب العتبات.
2. مكافحة غسل الأموال وتمويل الإرهاب (AML/CTF) — الحجم التراكمي، والتدفق السريع للداخل/الخارج، والعقوبات، والتعرض للشخصيات البارزة سياسياً (PEP)، والولايات القضائية عالية المخاطر.
3. اكتشاف الشذوذ — ارتفاعات السرعة، وإعادة تنشيط الحسابات الخاملة، والشذوذات السلوكية.
4. FATF — أنماط تتوافق مع مؤشرات العلامة الحمراء لفرقة العمل المعنية بالإجراءات المالية (FATF).
5. ذكاء الجهاز — بصمة الجهاز وإشارات مخاطر الجلسة.
6. منع الاحتيال — أنماط النقل، والحسابات المتعددة، وإشارات الاستيلاء على الحساب.
7. مراقبة العملات المشفرة — أنماط المعاملات على السلسلة.
8. فحص العملات المشفرة — مخاطر المحفظة والتعرض لمصدر الأموال.
9. الألعاب المسؤولة — سرعة الإيداع، وتغييرات الحد، وسوء استخدام المكافآت.
10. التجارة الإلكترونية — أنماط رد المبالغ المدفوعة وسوء استخدام استرداد الأموال.
11. مخصص — قواعدك الخاصة بشروط، ونوافذ سرعة، وإجراءات.

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

العملات المشفرة، فحص المحفظة، وقاعدة السفر

اضبط currency_kind: "crypto" مع اتجاه (INBOUND أو OUTBOUND) ويمكن للمحرك تشغيل فحص المحفظة على السلسلة تلقائيًا على عنوان الطرف المقابل — للتحقق من التعرض للكيانات الخاضعة للعقوبات، وأسواق الشبكة المظلمة، والخلاطات، وبرامج الفدية، والأموال المسروقة. يبدأ فحص المحفظة بسعر 0.02 دولار لكل فحص مع مفتاحك الخاص (Crystal أو Merkle Science).

بالنسبة لمقدمي خدمات الأصول الافتراضية، يدعم نفس المحرك قاعدة السفر الخاصة بـ FATF: تبادل بيانات المنشئ والمستفيد مع تتبع الالتزامات عبر البروتوكولات، وحالات قاعدة السفر المخصصة (COMPLIANT، PENDING_ACTION، PENDING_COUNTERPARTY، EXEMPT، والمزيد). يغطي منتج واحد المراقبة، والفحص، وقاعدة السفر.

إدارة الحالات وسير عمل تقارير الأنشطة المشبوهة (SARs)

عندما تطلق قاعدة، يتم فتح تنبيه. توفر Didit بيئة العمل للتعامل معه — لا توجد حاجة لأداة حالات منفصلة.

• تحمل التنبيهات مصدرًا (تم تشغيله بواسطة قاعدة، أو تم تشغيله بواسطة مزود، أو تم إنشاؤه بواسطة محلل) وتنتقل عبر الحالات: OPEN (مفتوح)، INVESTIGATING (قيد التحقيق)، AWAITING_USER (في انتظار المستخدم)، PENDING_SAR (في انتظار تقرير SAR)، SAR_FILED (تم تقديم تقرير SAR)، RESOLVED (تم الحل)، DISMISSED (تم الرفض).
• تقوم الحالات بتجميع التنبيهات ذات الصلة، وتحمل الأولوية والخطورة، وتتبع التحقيق عبر OPEN (مفتوح)، UNDER_REVIEW (قيد المراجعة)، AWAITING_USER (في انتظار المستخدم)، ON_HOLD (معلق)، و RESOLVED (تم الحل).
• يتم تعيين المحللين، ويمكن قياس الأداء، ويتم تنفيذ سير عمل تقارير SARs في نفس وحدة التحكم حيث تم إطلاق التنبيه.

إن مسار AWAITING_USER هو ما يجعل هذا عمليًا على نطاق واسع: بدلاً من الرفض القاطع، يمكن لمعاملة تم وضع علامة عليها أن تتوقف وتطلب من المستخدم تصفيتها — إعادة التحقق من الهوية، أو تقديم إثبات الأموال — ثم تستأنف تلقائيًا بمجرد قيامهم بذلك. تحدث الاحتكاكات فقط حيث توجد المخاطر.

كيفية الدمج مع Didit

1. بناء سير العمل. في وحدة تحكم الأعمال، قم بتشغيل حزم القواعد ذات الصلة بعملك وضبط العتبات. تم تصميم منشئ القواعد المخصص ليكون متاحًا فقط في وحدة التحكم، لذا تراجع الامتثال كل تغيير.
2. إرسال المعاملات. POST /v3/transactions/ من الواجهة الخلفية الخاصة بك مع حركة الأموال. استخدم transaction_id مستقرًا لضمان الاستمرارية، ومرر vendor_data لربط المعاملات بالمستخدم أو الكيان التجاري الذي تنتمي إليه.
3. التعامل مع خطافات الويب. استمع إلى transaction.status.updated للتفاعل عندما يحل محلل تنبيهًا أو عندما تكتمل معالجة AWAITING_USER.
4. معالجة التنبيهات في وحدة التحكم. قم بالتحقيق، والتصعيد إلى حالة، وتقديم تقارير SARs من نفس الواجهة.

نظرًا لأنه يتم كل ذلك على واجهة برمجة التطبيقات الموحدة /v3/، يمكن لجلسة KYB أن تولد جلسات KYC لأصحاب المصلحة النهائيين، وتتدفق هؤلاء المستخدمين إلى مراقبة المعاملات، ويمكن لمعاملة تم وضع علامة عليها أن تولد عملية KYC تصحيحية — منصة واحدة للهوية والاحتيال، من البداية إلى النهاية.

الأسئلة الشائعة

كم تكلفة مراقبة المعاملات؟

0.02 دولار لكل معاملة، يتم الفواتير لكل مكالمة بدون حد أدنى. يتم فواتير فحص مكافحة غسل الأموال على طرف تم وضع علامة عليه بشكل منفصل بسعر 0.20 دولار لكل فحص، ويبدأ فحص المحفظة على السلسلة بسعر 0.02 دولار لكل فحص مع مفتاحك الخاص.

هل يعمل للعملات المشفرة وكذلك العملات النقدية؟

نعم. اضبط currency_kind على fiat أو crypto. يمكن لمعاملات العملات المشفرة أن تؤدي تلقائيًا إلى فحص المحفظة على السلسلة وتدعم قاعدة السفر الخاصة بـ FATF.

هل يجب علي بناء أداة إدارة الحالات الخاصة بي؟

لا. التنبيهات، وتعيين المحللين، وحالات التحقيق، وسير عمل تقارير SARs مدمجة في نفس المنتج ووحدة التحكم.

هل يمكنني كتابة قواعدي الخاصة؟

نعم. بالإضافة إلى الحزم الـ 11 المضمنة، يمكنك بناء قواعد مخصصة بشروط، ونوافذ سرعة، وتجميعات. تتم إدارة القواعد في وحدة التحكم بحيث تراجع الامتثال كل تغيير.

ما هي المعالجة التلقائية للحالات AWAITING_USER؟

بدلاً من الرفض القاطع، يمكن لمعاملة تم وضع علامة عليها أن تتوقف وتطلب إجراءً من المستخدم — إعادة التحقق أو إثبات الأموال — ثم تستأنف تلقائيًا بمجرد قيام المستخدم بتصفيتها.

هل أنت مستعد للبدء؟

اقرأ نظرة عامة على مراقبة المعاملات في الوثائق، واطلع على كيفية توافقها مع بقية المنصة على صفحة منتج مراقبة المعاملات، وتحقق من الأسعار الشفافة لكل مكالمة على صفحة الأسعار. عندما تكون مستعدًا، ابدأ مجانًا — 500 فحص KYC مجاني كل شهر، ومراقبة المعاملات بسعر 0.02 دولار لكل مكالمة.