الانتقال إلى المحتوى الرئيسي
يمثّل اتصال البنك في Didit إذن الشخص أو الشركة لتطبيقك بقراءة بنك واحد، ويتضمن تواريخ الموافقة وحالة المزامنة والحسابات المرتبطة به. ينشئ Bank Link المكتمل هذا الاتصال، ويبقى ساريًا طالما يسمح بذلك البنك والشخص. تتوفر بيانات البنك لتطبيقات البيئة التجريبية، وتُرجع استدعاءات التطبيق في بيئة الإنتاج الرمز 404 إلى أن يُعلن عن إتاحة الوصول إلى بيئة الإنتاج.

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

يعمل الوصول المستمر في البنك فقط إذا كان ذلك البنك يسمح به. استدعِ endpoint المؤسسات أو اقرأ صفحة التغطية. وإذا تعذّر على البنك إبقاء الوصول مفتوحاً، يُبلَّغ الشخص بأن البنك لا يسمح بالوصول المستمر، وعليه اختيار بنك آخر. اضبط allow_one_time_fallback: true للسماح للشخص بالمتابعة بقراءة لمرة واحدة، بعد تأكيد الوصول المخفّض على شاشته الخاصة، وعندها يصبح الاتصال one_time.

الحالات

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/. يُعيد الطلب 409 renewal_not_needed ما دام يتبقى أكثر من 30 يومًا، و409 renewal_window_expired بعد consent.renewable_until. وفي الحالات الأخرى يُعيد 201 مع رابط تجديد.
صفحة إتمام التجديد من قِبل الشخص غير متاحة بعد، لذا لا ترسل الأشخاص إلى رابط التجديد حاليًا. إذا ترك الشخص الموافقة تنتهي دون تجديد، تصبح حالة الاتصال renewal_required: تبقى البيانات قابلة للقراءة كما كانت عند آخر مزامنة، ولا يُفرض أي رسوم. بعد consent.renewable_until تصبح الحالة revoked مع status_reason: consent_lapsed، ويعيد الشخص الاتصال من جديد. للاطلاع على المسار الكامل، راجع تجديد الموافقة البنكية.

إيقاف الوصول

إيقاف الوصول ليس حذفًا. اقرأ البيانات والموافقة والحذف لمعرفة ما يزيله الحذف بالضبط.

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

يُرجِع الاتصال المحذوف الحقول 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/ المعاملات status وaccess وinstitution_id وcountry وvendor_data وend_user_reference وconsent_expires_before وcreated_after.
  • اطّلع على تكلفة كل اتصال من خلال الكائن billing: الوحدة والسعر والشهر الذي تمت تسويته بالفعل.
آخر تعديل في ٢٢ نوفمبر ٢٠٢٦