> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# webhooks البنوك: أحداث الربط والاتصال والبيانات

> أحداث bank.link وbank.connection وbank.data وbank.sync في Didit: متى تُرسل، وما تحتويه، وكيفية استخدامها لتشغيل قراءة البيانات اليومية.

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

> [!NOTE]
>
> تُرسل أحداث webhook البنكية للتطبيقات في بيئة الإنتاج وفي البيئة التجريبية.
> اختر الأحداث لكل وجهة webhook باستخدام تصفية الأحداث الخاصة بالوجهة، كما في الأحداث الأخرى.
> لمعرفة الغلاف ورؤوس التوقيع وإعادة المحاولة، راجع [Webhooks](https://docs.didit.me/ar/integration/webhooks.md).

## الأحداث

| الحدث | متى يحدث | الحقول |
| - | - | - |
| `bank.link.completed` | قام المستخدم النهائي بربط بنك. | `data.link_id`, `data.status`, `data.connection_id`, `data.check_id`, `data.error_code` (القيمة دائمًا `null`) |
| `bank.link.cancelled` | ألغى المستخدم النهائي العملية. | `data.link_id`, `data.status` |
| `bank.link.expired` | انتهت صلاحية الرابط قبل إكماله. | `data.link_id`, `data.status` |
| `bank.link.failed` | انتهى الرابط بخطأ. | `data.link_id`, `data.status`, `data.error_code` |
| `bank.connection.created` | انتهت المزامنة الأولى، وأصبحت الحسابات قابلة للقراءة. | `connection_id`, `initial_status` |
| `bank.connection.history_complete` | انتهى استكمال السجل السابق، لأي سبب. | `connection_id`, `status` |
| `bank.connection.updated` | تغيّرت الحالة أو الموافقة أو حالة المزامنة. | `connection_id`, `status`, `revocation_status` |
| `bank.connection.consent_expiring` | قبل 14 يومًا و7 أيام ويوم واحد من انتهاء الموافقة. | `connection_id`, `days_left`, `consent_expires_at`, `renew_by` |
| `bank.connection.renewal_required` | انتهت الموافقة، أو طلب البنك من المستخدم النهائي تسجيل الدخول مجددًا. | `connection_id`, `status`, `reason`, `renew_by`, `renewable_until` |
| `bank.connection.renewed` | اكتمل رابط التجديد. | `connection_id`, `status`, `consent_version`, `link_id`, `consent_expires_at` |
| `bank.connection.revoked` | انتهى الوصول. | `connection_id`, `status`, `ended_by`, `status_reason`, `ended_at`, `retain_until` |
| `bank.connection.deleted` | حُذف الاتصال وبياناته. | `connection_id`, `status`, `erasure_status`, `reason`, `erased_at` |
| `bank.data.updated` | قامت المزامنة بحفظ تغييرات. | `connection_id`, `sync_id`, `trigger`, `accounts` (المعرّفات مع الأعداد), `balances_changed` |
| `bank.sync.completed` | انتهت كل عمليات المزامنة. | `connection_id`, `sync_id`, `trigger`, `outcome`, `changed` |
| `bank.sync.failed` | تستمر المزامنة في الفشل. | `connection_id`, `sync_id`, `error_code`, `failing_since` |
| `bank.sync.recovered` | عادت المزامنة الفاشلة إلى العمل. | `connection_id`, `sync_id` |

تحمل كل الأحداث أيضًا الحقول المشتركة `event_id` و`webhook_type` و`timestamp` و`created_at` و`application_id` و`environment`.
تحمل أحداث `bank.link.*` حقولها ضمن `data`، أما أحداث الاتصال والبيانات والمزامنة فتحمل حقولها في المستوى الأعلى.
القيم الممكنة لـ`ended_by` هي `end_user` أو `bank` أو `customer` أو `unknown`.
يرد المخطط الدقيق لكل حدث في [مرجع API](https://docs.didit.me/ar/standalone-apis/bank-data.md).

## مثال

```json theme={null}
{
  "event_id": "7c1e0a52-93d4-4a6b-8f21-0d5b9e3a64c7",
  "webhook_type": "bank.sync.completed",
  "timestamp": 1763804640,
  "created_at": 1763804640,
  "application_id": "b3e1f0a2-5d64-4c8e-9a17-2f6d0c8b7e41",
  "environment": "sandbox",
  "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6",
  "sync_id": "c2b8d4f6-9a13-4e07-85bc-3d6e1f0a7b92",
  "trigger": "scheduled",
  "outcome": "succeeded",
  "changed": true
}
```

## كيف تستخدمها

* **بيانات جديدة.** الحدث `bank.data.updated` إشارة فقط ولا يُرسل أي بيانات. استدعِ [خلاصة التغييرات](https://docs.didit.me/ar/standalone-apis/bank-transactions-sync.md) باستخدام المؤشر المحفوظ لديك. استخدم `bank.sync.completed` فقط إذا أردت رؤية كل مزامنة، بما فيها المزامنات التي لم تُغيّر شيئاً.
* **التسجيل.** انتظر `bank.connection.created` قبل قراءة الحسابات، وانتظر `bank.connection.history_complete` قبل الاعتماد على السجل الكامل.
* **الموافقة.** عند وصول `bank.connection.consent_expiring` اطلب من الشخص تجديد الموافقة. عند وصول `bank.connection.renewal_required` تظل البيانات قابلة للقراءة لكنها لم تعد تُزامَن.
* **الإيقاف.** عند وصول `bank.connection.revoked` أوقف الخلاصة الخاصة بك لهذا الاتصال، وقرّر ما إذا كنت ستقوم [بحذف](https://docs.didit.me/ar/standalone-apis/bank-connection-delete.md) البيانات المخزنة.
* **التكرار.** تعامل مع كل حدث وفق مبدأ idempotency: اعتمد على معرّف الحدث، وتوقع أن يصلك الحدث نفسه مرتين من حين لآخر.
* **لا تثق بالمتصفح أبداً.** أكّد الرابط باستخدام `bank.link.completed` أو `GET /v3/bank/links/{id}/`، لا بمعرّف رابط ترسله صفحة.

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

* [تغذية بيانات بنكية مستمرة للمحاسبة](https://docs.didit.me/ar/use-cases/bank-data-for-accounting.md)
* [البيئة التجريبية](https://docs.didit.me/ar/core-technology/bank-verification/sandbox.md): يُطلق Didit Test Bank هذه الأحداث.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.