الانتقال إلى المحتوى الرئيسي
يرسل Didit أحداث webhook البنكية عند انتهاء الرابط، أو تغيّر الاتصال، أو اقتراب انتهاء الموافقة، أو عندما تخزّن المزامنة بيانات جديدة. تستخدم هذه الأحداث الغلاف نفسه والتوقيع نفسه وإعادة المحاولة نفسها مثل أي webhook آخر من Didit، ولا تتضمّن سوى المعرّفات والحالات: لقراءة الكائن، اجلبه.
تُرسل أحداث webhook البنكية للتطبيقات في بيئة الإنتاج وفي البيئة التجريبية. اختر الأحداث لكل وجهة webhook باستخدام تصفية الأحداث الخاصة بالوجهة، كما في الأحداث الأخرى. لمعرفة الغلاف ورؤوس التوقيع وإعادة المحاولة، راجع Webhooks.

الأحداث

تحمل كل الأحداث أيضًا الحقول المشتركة event_id وwebhook_type وtimestamp وcreated_at وapplication_id وenvironment. تحمل أحداث bank.link.* حقولها ضمن data، أما أحداث الاتصال والبيانات والمزامنة فتحمل حقولها في المستوى الأعلى. القيم الممكنة لـended_by هي end_user أو bank أو customer أو unknown. يرد المخطط الدقيق لكل حدث في مرجع API.

مثال

كيف تستخدمها

  • بيانات جديدة. الحدث bank.data.updated إشارة فقط ولا يُرسل أي بيانات. استدعِ خلاصة التغييرات باستخدام المؤشر المحفوظ لديك. استخدم bank.sync.completed فقط إذا أردت رؤية كل مزامنة، بما فيها المزامنات التي لم تُغيّر شيئاً.
  • التسجيل. انتظر bank.connection.created قبل قراءة الحسابات، وانتظر bank.connection.history_complete قبل الاعتماد على السجل الكامل.
  • الموافقة. عند وصول bank.connection.consent_expiring اطلب من الشخص تجديد الموافقة. عند وصول bank.connection.renewal_required تظل البيانات قابلة للقراءة لكنها لم تعد تُزامَن.
  • الإيقاف. عند وصول bank.connection.revoked أوقف الخلاصة الخاصة بك لهذا الاتصال، وقرّر ما إذا كنت ستقوم بحذف البيانات المخزنة.
  • التكرار. تعامل مع كل حدث وفق مبدأ idempotency: اعتمد على معرّف الحدث، وتوقع أن يصلك الحدث نفسه مرتين من حين لآخر.
  • لا تثق بالمتصفح أبداً. أكّد الرابط باستخدام bank.link.completed أو GET /v3/bank/links/{id}/، لا بمعرّف رابط ترسله صفحة.

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

آخر تعديل في ٢٢ نوفمبر ٢٠٢٦