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: ما تمت الموافقة عليه، وعدد مرات التجديد.
التجديد
يحتفظ التجديد بمعرّف الاتصال وبجميع معرّفات الحسابات، ويستمر السجل دون تكرار.- ترسل Didit الحدث
bank.connection.consent_expiringقبل 14 يومًا و7 أيام ويوم واحد من انتهاء الموافقة. - استدعِ
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: الوحدة والسعر والشهر الذي تمت تسويته بالفعل.