مراقبة الأحداث

اختر نمط التكامل

POST /api/v1/decisions/evaluate

{
  "eventName": "payment.attempt",
  "eventCategory": "TRANSACTION",
  "customer": {
    "externalId": "cust_123",
    "email": "user@example.com"
  },
  "device": {
    "externalId": "device_abc123",
    "fingerprint": "fp_abc123"
  },
  "ip": "203.0.113.42",
  "sessionId": "session_xyz789",
  "metadata": {
    "amount": 250,
    "currency": "SAR",
    "paymentMethod": "card"
  }
}

POST /api/v1/events/async

{
  "eventName": "user.login",
  "eventCategory": "AUTHENTICATION",
  "customer": { "externalId": "cust_123" },
  "device": { "externalId": "device_abc123" },
  "ip": "203.0.113.42",
  "country": "SA",
  "sessionId": "session_xyz789"
}

نمذجة الأحداث بشكل متسق

أبقِ أسماء الأحداث مستقرة ومحددة بالمجال، مثل user.signup أو payment.attempt أو withdrawal.requested.

• customer.externalId — معرف العميل المستقر لديك.
• device.externalId أو device.fingerprint — سياق جهاز مستقر.
• sessionId — يجمع النشاط من زيارة واحدة.
• metadata — حقول خاصة بالمنتج يمكن للقواعد تقييمها.

من القواعد إلى القرار

تقيّم القواعد حمولة الحدث وتنتج إجراءً. استخدم إشارات احتيال عالية الثقة لـ BLOCK، والإشارات الغامضة لـ REVIEW، والنشاط الطبيعي لـ ALLOW.

أبقِ أسماء القواعد قابلة للقراءة لأنها تظهر في مراجعة العمليات وسير عمل الملاحظات.

متابعة النتائج

احفظ معرفات الاستجابة من القرارات المتزامنة واستخدم correlationIds.eventId عند استعلام حدث أو إرسال ملاحظات.

{
  "decision": "REVIEW",
  "riskScore": 82,
  "correlationIds": {
    "requestId": "req_abc123xyz",
    "eventId": "evt_ckm9876543210"
  }
}

POST /api/v1/feedback/event/:id

{
  "label": "FRAUD",
  "notes": "Customer confirmed the payment was unauthorized",
  "externalCaseId": "case_12345"
}