> ## 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/hi/core-technology/bank-verification/bank-link.md) यह कनेक्शन बनाता है, और यह तब तक बना रहता है जब तक बैंक और व्यक्ति इसकी अनुमति देते हैं।

बैंक डेटा सैंडबॉक्स एप्लिकेशन के लिए उपलब्ध है; लाइव एप्लिकेशन की कॉल तब तक `404` का उत्तर देती हैं जब तक लाइव एक्सेस की घोषणा नहीं हो जाती।

## एक बार की और सतत पहुँच

| | एक बार | सतत |
| - | - | - |
| `access` | `one_time` (डिफ़ॉल्ट) | `ongoing` |
| क्या होता है | व्यक्ति के कनेक्ट होने पर डेटा एक बार पढ़ा जाता है, उसके बाद पहुँच समाप्त हो जाती है (`status_reason: collection_complete`)। | सहमति समाप्त होने या किसी के रोकने तक पहुँच खुली रहती है। |
| बाद में डेटा | उन्हीं endpoints के माध्यम से पढ़ा जा सकता है। | बैंक के आधार पर दिन में एक से चार बार स्वतः सिंक होता है, साथ ही माँग पर लाइव सिंक भी होता है। |
| बिलिंग | प्रति जाँच, देखें [मूल्य निर्धारण](https://docs.didit.me/hi/getting-started/bank-verification-pricing.md) | प्रति सक्रिय कनेक्शन प्रति माह, देखें [मूल्य निर्धारण](https://docs.didit.me/hi/getting-started/bank-verification-pricing.md) |

सतत पहुँच केवल उन्हीं बैंकों में काम करती है जो इसकी अनुमति देते हैं।
[संस्थानों के endpoint](https://docs.didit.me/hi/standalone-apis/bank-institutions-list.md) से पूछें या [कवरेज पेज](https://docs.didit.me/hi/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`: क्या स्वीकृत किया गया था, और सहमति कितनी बार नवीनीकृत हुई।

सहमति उतने समय तक रहती है जितने समय तक बैंक अनुमति देता है।
हर कनेक्शन पर वास्तविक मान पढ़ें और संस्था पर प्रति-बैंक मान देखें।

## नवीनीकरण

नवीनीकरण के दौरान कनेक्शन ID और हर खाता ID वही रहते हैं, और इतिहास बिना डुप्लीकेट के जारी रहता है।

1. Didit समाप्त होने से 14, 7 और 1 दिन पहले `bank.connection.consent_expiring` भेजता है।
2. [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/hi/standalone-apis/bank-connection-renew) को कॉल करें। जब 30 दिन से अधिक शेष हों, तब यह `409 renewal_not_needed` लौटाता है, और `consent.renewable_until` के बाद `409 renewal_window_expired` लौटाता है। अन्यथा यह नवीनीकरण लिंक के साथ `201` लौटाता है।

जिस पेज पर व्यक्ति नवीनीकरण पूरा करता है, वह अभी उपलब्ध नहीं है, इसलिए आज किसी को नवीनीकरण लिंक पर न भेजें।

यदि व्यक्ति सहमति को समाप्त होने देता है, तो कनेक्शन `renewal_required` हो जाता है: डेटा अंतिम बार सिंक की गई स्थिति में पढ़ने योग्य रहता है और कोई शुल्क नहीं लिया जाता।
`consent.renewable_until` के बाद यह `revoked` हो जाता है, `status_reason: consent_lapsed` के साथ, और व्यक्ति को फिर से कनेक्ट करना होता है।

पूरा प्रवाह देखने के लिए [बैंक सहमति का नवीनीकरण करें](https://docs.didit.me/hi/use-cases/renew-bank-consent.md) पढ़ें।

## पहुँच रोकें

| कौन | कैसे | क्या होता है |
| - | - | - |
| व्यक्ति | अपने बैंक में **Stop sharing** करें | `bank.connection.revoked` के साथ `ended_by: end_user` या `bank` |
| आप | [`revoke_connection`](https://docs.didit.me/hi/standalone-apis/bank-connection-revoke) | बैंक तुरंत पहुँच रोकने की जानकारी प्राप्त करता है। सहमति की स्थिति पहले `revocation_pending` दिखाती है, और बैंक की पुष्टि होने पर `revoked` हो जाती है। जो डेटा पहले ही पढ़ा जा चुका है, वह तब तक पढ़ने योग्य रहता है जब तक आप कनेक्शन हटाते नहीं या `consent.retain_until` की तारीख नहीं निकल जाती। |
| आप | [`delete_connection`](https://docs.didit.me/hi/standalone-apis/bank-connection-delete) | पहुँच रोकता है और कनेक्शन तथा उसके खाते, बैलेंस और लेन-देन हटा देता है। यह अपरिवर्तनीय है। |

पहुँच रोकना हटाने के बराबर नहीं है।
ठीक-ठीक जानने के लिए कि हटाने से क्या-क्या हटता है, [डेटा, सहमति और हटाना](https://docs.didit.me/hi/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`) के रूप में पूरा होता है और दोबारा कोई शुल्क नहीं लिया जाता।
कोई भी अन्य ओवरलैप लिंक को `duplicate_conflict` और `conflicts_with` के साथ `failed` स्थिति में समाप्त कर देता है, और यह कुछ भी संग्रहीत किए जाने या कोई शुल्क लिए जाने से पहले होता है।
मौजूदा कनेक्शन का नवीनीकरण करें, या स्वतंत्र दूसरे कनेक्शन के लिए `"duplicates": "allow"` के साथ लिंक दोबारा बनाएँ।

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

* फ़िल्टर के साथ सूची: [`GET /v3/bank/connections/`](https://docs.didit.me/hi/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.