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 वही रहते हैं, और इतिहास बिना डुप्लीकेट के जारी रहता है।- Didit समाप्त होने से 14, 7 और 1 दिन पहले
bank.connection.consent_expiringभेजता है। 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ऑब्जेक्ट से देखें कि कोई कनेक्शन कितने में पड़ता है: इकाई, कीमत और वह महीना जिसका भुगतान पहले ही हो चुका है।