تُرسل أحداث 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}/، لا بمعرّف رابط ترسله صفحة.
الخطوات التالية
- تغذية بيانات بنكية مستمرة للمحاسبة
- البيئة التجريبية: يُطلق Didit Test Bank هذه الأحداث.