webhooks الكيانات: أحداث المستخدم والشركة

يُرسَل webhook عند كل تغيير في حالة كيان من نوع User أو Business أو في بيانات ملفه التعريفي، حتى يتمكن نظامك من الاستجابة في الوقت الفعلي. استخدم webhooks الكيانات لمزامنة بيانات الملف التعريفي، أو لنقل حالات الحظر إلى أنظمة أخرى، أو لتشغيل مسارات الامتثال اللاحقة.

كتالوج الأحداث

الحدث	المُشغِّل
`user.status.updated`	تتغير حالة كيان User (`ACTIVE` ↔ `FLAGGED` ↔ `BLOCKED`)
`user.data.updated`	تتغير حقول الملف التعريفي لكيان User (الاسم، وتاريخ الميلاد، والصورة الشخصية، والعدادات المجمّعة، والبيانات الوصفية)
`business.status.updated`	تتغير حالة كيان Business
`business.data.updated`	تتغير حقول الملف التعريفي لكيان Business (الاسم القانوني، ورقم التسجيل، والدولة، والعدادات)

يُقبل activity.created في subscribed_events ويغطيه Try Webhook للاختبار، لكن Didit لا يرسله حاليًا لحركة المرور الفعلية. لا تبنِ عكسًا للجدول الزمني اعتمادًا عليه.

ترسل Didit أيضًا أحداث الجلسات والمعاملات وجلسات الشركات التي تشير إلى حقول الكيانات. انظر:

webhooks التحقق من الشركات (KYB): أحداث جلسات الشركات
webhooks مراقبة المعاملات: أحداث المعاملات
مرجع webhooks: التحقق من التوقيع، وإعادة المحاولة، والوجهات

بنية الحمولة

webhooks الكيانات مسطّحة: لا يوجد غلاف data ولا مفتاح event. اقرأ webhook_type لتوجيه الحدث.

{
  "event_id": "7f3c2c1e-6a1d-4c36-9d8e-0d3b5f4e2a10",
  "webhook_type": "user.status.updated",
  "timestamp": 1776333600,
  "created_at": 1776333594,
  "application_id": "0c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "environment": "live",
  "vendor_user_id": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "vendor_data": "user-42",
  "status": "BLOCKED",
  "previous_status": "ACTIVE"
}

الحقل	الوصف
`vendor_user_id` / `vendor_business_id`	معرّف Didit للكيان. تستخدم أحداث `business.*` الحقل `vendor_business_id`.
`vendor_data`	معرّفك للكيان.
`status`	`ACTIVE` أو `FLAGGED` أو `BLOCKED`.
`previous_status`	يظهر فقط في `*.status.updated`.
`changed_fields` و`changes`	يظهران فقط في `*.data.updated`.
`created_at`	ثوانٍ منذ حقبة Unix وقت آخر تحديث للكيان.
`timestamp`	ثوانٍ منذ حقبة Unix وقت إرسال Didit للـ webhook.

`user.status.updated` / `business.status.updated`

يُرسَل مع كل تغيير في الحالة. تتضمن الحمولة status وprevious_status. لا توضح سبب تغيّر الحالة: افتح الكيان في Business Console إذا احتجت إلى معرفة السبب.

`user.data.updated` / `business.data.updated`

يُرسَل عند تغيّر حقول الملف التعريفي. يسرد changed_fields الحقول التي تغيّرت، ويحمل changes القيمتين previous وcurrent لكل حقل.

{
  "event_id": "5d1e8f9a-0c32-4b6a-a7b6-2b9d6f0a3c41",
  "webhook_type": "user.data.updated",
  "timestamp": 1776333700,
  "created_at": 1776333694,
  "application_id": "0c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "environment": "live",
  "vendor_user_id": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "vendor_data": "user-42",
  "status": "ACTIVE",
  "changed_fields": ["full_name", "session_count"],
  "changes": {
    "full_name": { "previous": null, "current": "John Doe" },
    "session_count": { "previous": 2, "current": 3 }
  }
}

الحقول التي قد تظهر في changed_fields هي:

User: vendor_data، وdisplay_name، وfull_name، وdate_of_birth، وmetadata، وportrait_image، وissuing_states، وapproved_emails، وapproved_phones، وfeatures، وsession_count، وapproved_count، وdeclined_count، وin_review_count، وfirst_session_at، وlast_session_at.
Business: vendor_data، وdisplay_name، وmetadata، وlegal_name، وregistration_number، وcountry_code، وsession_count، وapproved_count، وdeclined_count، وin_review_count، وfeatures، وfirst_session_at، وlast_session_at.

استخدم changed_fields وchanges لمزامنة الحقول التي تغيّرت فقط.

الإرسال وإعادة المحاولة والتوقيع

تتبع جميع webhooks الكيانات عقد التسليم القياسي:

موقَّع بخوارزمية HMAC-SHA256 في الرأس X-Signature-V2 (موصى به)، باستخدام secret_shared_key الخاص بالوجهة. كما يُرسل الرأس X-Signature والرأس X-Signature-Simple القديم أيضًا، إلى جانب X-Timestamp.
تُعاد المحاولة حتى مرتين، بعد نحو دقيقة ونحو 4 دقائق، عندما ترد endpoint الخاص بك برمز 5xx أو 404، أو عند انتهاء مهلة الاتصال أو فشله. يتضمن مرجع webhooks سياسة إعادة المحاولة كاملة.
‏idempotency: لكل webhook event_id فريد في الحمولة، لذا أزل التكرار من جهتك.

انظر مرجع webhooks لإعداد الوجهة وأمثلة كود التحقق من التوقيع.

الاشتراك

اشترك في أحداث الكيانات على وجهة webhook عبر Management API أو Business Console:

curl -X POST https://verification.didit.me/v3/webhook/destinations/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Entity sync",
    "url": "https://yourapp.com/webhooks/didit",
    "subscribed_events": [
      "user.status.updated",
      "user.data.updated",
      "business.status.updated",
      "business.data.updated"
    ]
  }'

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

مرجع webhooks

الوجهات، والتوقيعات، وإعادة المحاولة، والتحقق.

إنشاء وجهة

سجّل endpoint جديد لـ webhook.

عمليات المستخدم

التغييرات التي تشغّل webhooks المستخدم.

نظرة عامة

الأسعار

سير العمل والتحقق

المراجعة والعمليات

الكيانات (المستخدمون والشركات)

الإعدادات والتخصيص

الأمان والامتثال

Didit Academy

الموارد

webhooks الكيانات: أحداث المستخدم والشركة

كتالوج الأحداث

بنية الحمولة

`user.status.updated` / `business.status.updated`

`user.data.updated` / `business.data.updated`

الإرسال وإعادة المحاولة والتوقيع

الاشتراك

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

مرجع webhooks

إنشاء وجهة

عمليات المستخدم

​كتالوج الأحداث

​بنية الحمولة

​user.status.updated / business.status.updated

​user.data.updated / business.data.updated

​الإرسال وإعادة المحاولة والتوقيع

​الاشتراك

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

مرجع webhooks

إنشاء وجهة

عمليات المستخدم

كتالوج الأحداث

بنية الحمولة

`user.status.updated` / `business.status.updated`

`user.data.updated` / `business.data.updated`

الإرسال وإعادة المحاولة والتوقيع

الاشتراك

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