मुख्य सामग्री पर जाएं
एक 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: क्या स्वीकृत किया गया था, और सहमति कितनी बार नवीनीकृत हुई।
सहमति उतने समय तक रहती है जितने समय तक बैंक अनुमति देता है। हर कनेक्शन पर वास्तविक मान पढ़ें और संस्था पर प्रति-बैंक मान देखें।

नवीनीकरण

नवीनीकरण के दौरान कनेक्शन ID और हर खाता ID वही रहते हैं, और इतिहास बिना डुप्लीकेट के जारी रहता है।
  1. Didit समाप्त होने से 14, 7 और 1 दिन पहले bank.connection.consent_expiring भेजता है।
  2. POST /v3/bank/connections/{id}/renew/ को कॉल करें। जब 30 दिन से अधिक शेष हों, तब यह 409 renewal_not_needed लौटाता है, और consent.renewable_until के बाद 409 renewal_window_expired लौटाता है। अन्यथा यह नवीनीकरण लिंक के साथ 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) के रूप में पूरा होता है और दोबारा कोई शुल्क नहीं लिया जाता। कोई भी अन्य ओवरलैप लिंक को duplicate_conflict और conflicts_with के साथ failed स्थिति में समाप्त कर देता है, और यह कुछ भी संग्रहीत किए जाने या कोई शुल्क लिए जाने से पहले होता है। मौजूदा कनेक्शन का नवीनीकरण करें, या स्वतंत्र दूसरे कनेक्शन के लिए "duplicates": "allow" के साथ लिंक दोबारा बनाएँ।

आपके ग्राहकों के कनेक्शन प्रबंधित करें

  • फ़िल्टर के साथ सूची: GET /v3/bank/connections/ में status, access, institution_id, country, vendor_data, end_user_reference, consent_expires_before और created_after फ़िल्टर स्वीकार होते हैं।
  • billing ऑब्जेक्ट से देखें कि कोई कनेक्शन कितने में पड़ता है: इकाई, कीमत और वह महीना जिसका भुगतान पहले ही हो चुका है।
अंतिम संशोधन 22 नवंबर 2026