> ## 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.

# ربط الحساب البنكي: الوصول المستمر والموافقة والتجديد

> الاتصال هو إذن الشخص بقراءة بنك واحد. اطلع على حالاته، وكيفية انتهاء الموافقة، وطريقة تجديدها، وكيفية إيقاف الوصول أو حذف البيانات مع Didit.

يمثّل اتصال البنك في Didit إذن الشخص أو الشركة لتطبيقك بقراءة بنك واحد، ويتضمن تواريخ الموافقة وحالة المزامنة والحسابات المرتبطة به.
ينشئ [Bank Link](https://docs.didit.me/ar/core-technology/bank-verification/bank-link.md) المكتمل هذا الاتصال، ويبقى ساريًا طالما يسمح بذلك البنك والشخص.

تتوفر بيانات البنك لتطبيقات البيئة التجريبية، وتُرجع استدعاءات التطبيق في بيئة الإنتاج الرمز `404` إلى أن يُعلن عن إتاحة الوصول إلى بيئة الإنتاج.

## الوصول لمرة واحدة والوصول المستمر

| | لمرة واحدة | مستمر |
| - | - | - |
| `access` | `one_time` (الافتراضي) | `ongoing` |
| ما الذي يحدث | تُقرأ البيانات مرة واحدة عند اتصال الشخص، ثم ينتهي الوصول (`status_reason: collection_complete`). | يبقى الوصول مفتوحاً حتى تنتهي الموافقة أو يوقفه أحد. |
| البيانات لاحقاً | يمكن قراءتها عبر نفس endpoints. | تتم مزامنتها تلقائياً بين مرة واحدة وأربع مرات يومياً حسب البنك، بالإضافة إلى المزامنات الفورية عند الطلب. |
| الفوترة | لكل عملية تحقق، راجع [الأسعار](https://docs.didit.me/ar/getting-started/bank-verification-pricing.md) | لكل اتصال نشط شهرياً، راجع [الأسعار](https://docs.didit.me/ar/getting-started/bank-verification-pricing.md) |

يعمل الوصول المستمر في البنك فقط إذا كان ذلك البنك يسمح به.
استدعِ [endpoint المؤسسات](https://docs.didit.me/ar/standalone-apis/bank-institutions-list.md) أو اقرأ [صفحة التغطية](https://docs.didit.me/ar/core-technology/bank-verification/coverage.md).
وإذا تعذّر على البنك إبقاء الوصول مفتوحاً، يُبلَّغ الشخص بأن البنك لا يسمح بالوصول المستمر، وعليه اختيار بنك آخر.
اضبط `allow_one_time_fallback: true` للسماح للشخص بالمتابعة بقراءة لمرة واحدة، بعد تأكيد الوصول المخفّض على شاشته الخاصة، وعندها يصبح الاتصال `one_time`.

## الحالات

| `status` | المعنى | البيانات قابلة للقراءة | المزامنة | الفوترة |
| - | - | - | - | - |
| `pending` | اكتمل الربط، وتعمل المزامنة الأولى الآن. | ليست بعد | قيد التشغيل | لا |
| `active` | الموافقة سارية، والمزامنة سليمة أو تعيد المحاولة. | نعم | نعم | نعم |
| `renewal_required` | انتهت الموافقة، أو يطلب البنك من الشخص تسجيل الدخول مرة أخرى. يوضح `status_reason` السبب. | كما في آخر مزامنة | لا | لا |
| `paused` | الرصيد لا يكفي للشهر. | كما في آخر مزامنة | لا | لا |
| `revoked` | أوقف الشخص أو البنك أو أنت الوصول. يحدد `consent.ended_by` الجهة. | حتى `consent.retain_until` | لا | لا |
| `deleted` | حُذف الاتصال وبياناته. | لا | لا | لا |
| `failed` | لم تنجح المزامنة الأولى قط. | لا | لا | لا |

`status_reason` هو واحد من القيم التالية: `collection_complete`، `consent_expired`، `consent_lapsed`، `bank_requires_sign_in`، `revoked_by_end_user`، `revoked_by_bank`، `revoked_by_customer`، `insufficient_balance`، `paused_by_customer` (محجوزة، ولا يضبطها أي endpoint حاليًا)، و`first_sync_failed`.

## الموافقة

يحدد البنك نهاية الموافقة بحد أقصى يساوي قيمة `consent_days` التي طلبتها.
تعرض كل عملية اتصال تواريخها الفعلية ضمن `consent`:

* `expires_at` و`renew_by`: موعد انتهاء الموافقة. جدّدها قبل هذا الموعد لتجنب أي انقطاع.
* `renewable_until`: آخر لحظة يمكن فيها إعادة تفعيل الاتصال نفسه بعد انتهاء الموافقة.
* `renewed_count` و`version` و`scopes_granted` و`accounts_granted`: ما تمت الموافقة عليه، وعدد مرات التجديد.

تستمر الموافقة طالما يسمح بها البنك.
اقرأ القيمة الفعلية في كل اتصال، والقيمة الخاصة بكل بنك في المؤسسة.

## التجديد

يحتفظ التجديد بمعرّف الاتصال وبجميع معرّفات الحسابات، ويستمر السجل دون تكرار.

1. ترسل Didit الحدث `bank.connection.consent_expiring` قبل 14 يومًا و7 أيام ويوم واحد من انتهاء الموافقة.
2. استدعِ [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/ar/standalone-apis/bank-connection-renew). يُعيد الطلب `409 renewal_not_needed` ما دام يتبقى أكثر من 30 يومًا، و`409 renewal_window_expired` بعد `consent.renewable_until`. وفي الحالات الأخرى يُعيد `201` مع رابط تجديد.

صفحة إتمام التجديد من قِبل الشخص غير متاحة بعد، لذا لا ترسل الأشخاص إلى رابط التجديد حاليًا.

إذا ترك الشخص الموافقة تنتهي دون تجديد، تصبح حالة الاتصال `renewal_required`: تبقى البيانات قابلة للقراءة كما كانت عند آخر مزامنة، ولا يُفرض أي رسوم. بعد `consent.renewable_until` تصبح الحالة `revoked` مع `status_reason: consent_lapsed`، ويعيد الشخص الاتصال من جديد.

للاطلاع على المسار الكامل، راجع [تجديد الموافقة البنكية](https://docs.didit.me/ar/use-cases/renew-bank-consent.md).

## إيقاف الوصول

| من | الطريقة | ما يحدث |
| - | - | - |
| الشخص | **إيقاف المشاركة** لدى بنكه | `bank.connection.revoked` مع `ended_by: end_user` أو `bank` |
| أنت | [`revoke_connection`](https://docs.didit.me/ar/standalone-apis/bank-connection-revoke) | تتوقف عمليات الجلب من البنك فورًا. تكون حالة الموافقة `revocation_pending`، ثم تصبح `revoked` عندما يؤكد البنك ذلك. تبقى البيانات التي قُرئت بالفعل قابلة للقراءة حتى تحذف الربط أو تنقضي قيمة `consent.retain_until`. |
| أنت | [`delete_connection`](https://docs.didit.me/ar/standalone-apis/bank-connection-delete) | يوقف الوصول ويحذف الربط وحساباته وأرصدته ومعاملاته. هذا الإجراء لا يمكن التراجع عنه. |

إيقاف الوصول ليس حذفًا.
اقرأ [البيانات والموافقة والحذف](https://docs.didit.me/ar/core-technology/bank-verification/data-consent-and-deletion.md) لمعرفة ما يزيله الحذف بالضبط.

## الاتصال المحذوف

يُرجِع الاتصال المحذوف الحقول `id` و`status` (`deleted`) و`status_reason` و`created_at` و`erasure` فقط.
قيمة `status_reason` هي `deleted_by_customer` أو `consent_lapsed` أو `retention_elapsed` أو `application_deleted`.
كل حقل آخر غائب.

## التكرارات

رابط جديد يؤدي إلى الحسابات نفسها تمامًا التي تشاركها بالفعل مع `end_user.reference` نفسه لدى البنك نفسه يكتمل بوصفه تجديداً لذلك الاتصال (`reused: true`)، ولا تُحتسب عليه الرسوم مرتين.
أي تداخل آخر ينتهي الرابط بالحالة `failed` مع `duplicate_conflict` و`conflicts_with`، قبل تخزين أي شيء أو احتساب أي رسوم.
جدّد الاتصال الحالي، أو أنشئ الرابط من جديد مع `"duplicates": "allow"` للحصول على اتصال ثانٍ مستقل.

## إدارة اتصالات عملائك

* السرد باستخدام عوامل التصفية: يقبل [`GET /v3/bank/connections/`](https://docs.didit.me/ar/standalone-apis/bank-connections-list) المعاملات `status` و`access` و`institution_id` و`country` و`vendor_data` و`end_user_reference` و`consent_expires_before` و`created_after`.
* اطّلع على تكلفة كل اتصال من خلال الكائن `billing`: الوحدة والسعر والشهر الذي تمت تسويته بالفعل.


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