> ## 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 के bank.link, bank.connection, bank.data और bank.sync वेबहुक इवेंट: कब भेजे जाते हैं, क्या डेटा होता है, और उपयोग कैसे करें।

जब कोई लिंक समाप्त होता है, कनेक्शन बदलता है, सहमति समाप्त होने वाली होती है, या सिंक नया डेटा संग्रहीत करता है, तब Didit बैंक webhook भेजता है। ये बाकी हर Didit webhook की तरह वही एनवेलप, साइनिंग और पुनः प्रयास इस्तेमाल करते हैं, और इनमें केवल ID और स्थितियाँ होती हैं: उसे पढ़ने के लिए आप ऑब्जेक्ट फ़ेच करते हैं।

> [!NOTE]
>
> बैंक webhook इवेंट लाइव और सैंडबॉक्स एप्लिकेशन के लिए भेजे जाते हैं।
> हर गंतव्य के लिए इवेंट चुनें, गंतव्य के इवेंट फ़िल्टर से, जैसे अन्य इवेंट के लिए करते हैं।
> एनवेलप, हस्ताक्षर हेडर और पुनः प्रयास के बारे में जानने के लिए [Webhooks](https://docs.didit.me/hi/integration/webhooks.md) देखें।

## इवेंट

| इवेंट | कब | फ़ील्ड |
| - | - | - |
| `bank.link.completed` | एक व्यक्ति ने बैंक कनेक्ट किया। | `data.link_id`, `data.status`, `data.connection_id`, `data.check_id`, `data.error_code` (हमेशा `null`) |
| `bank.link.cancelled` | व्यक्ति ने लिंक रद्द किया। | `data.link_id`, `data.status` |
| `bank.link.expired` | पूरा होने से पहले लिंक की समय-सीमा समाप्त हो गई। | `data.link_id`, `data.status` |
| `bank.link.failed` | लिंक त्रुटि के साथ समाप्त हुआ। | `data.link_id`, `data.status`, `data.error_code` |
| `bank.connection.created` | पहला सिंक पूरा हुआ और खातों की जानकारी पढ़ी जा सकती है। | `connection_id`, `initial_status` |
| `bank.connection.history_complete` | इतिहास बैकफ़िल किसी भी कारण से समाप्त हुआ। | `connection_id`, `status` |
| `bank.connection.updated` | स्थिति, सहमति या सिंक की स्थिति बदली। | `connection_id`, `status`, `revocation_status` |
| `bank.connection.consent_expiring` | सहमति समाप्त होने से 14, 7 और 1 दिन पहले। | `connection_id`, `days_left`, `consent_expires_at`, `renew_by` |
| `bank.connection.renewal_required` | सहमति समाप्त हो गई, या बैंक व्यक्ति से फिर से साइन इन करने को कहता है। | `connection_id`, `status`, `reason`, `renew_by`, `renewable_until` |
| `bank.connection.renewed` | नवीनीकरण लिंक पूरा हुआ। | `connection_id`, `status`, `consent_version`, `link_id`, `consent_expires_at` |
| `bank.connection.revoked` | पहुँच समाप्त हो गई। | `connection_id`, `status`, `ended_by`, `status_reason`, `ended_at`, `retain_until` |
| `bank.connection.deleted` | कनेक्शन और उसका डेटा हटा दिया गया। | `connection_id`, `status`, `erasure_status`, `reason`, `erased_at` |
| `bank.data.updated` | सिंक ने बदलाव सहेजे। | `connection_id`, `sync_id`, `trigger`, `accounts` (गिनती के साथ आईडी), `balances_changed` |
| `bank.sync.completed` | हर सिंक पूरा हुआ। | `connection_id`, `sync_id`, `trigger`, `outcome`, `changed` |
| `bank.sync.failed` | सिंक लगातार विफल हो रहा है। | `connection_id`, `sync_id`, `error_code`, `failing_since` |
| `bank.sync.recovered` | विफल हो रहा सिंक फिर से काम करने लगा। | `connection_id`, `sync_id` |

हर इवेंट में ये सामान्य फ़ील्ड भी होते हैं: `event_id`, `webhook_type`, `timestamp`, `created_at`, `application_id` और `environment`।
`bank.link.*` इवेंट अपने फ़ील्ड `data` के अंतर्गत भेजते हैं; कनेक्शन, डेटा और सिंक इवेंट अपने फ़ील्ड सबसे ऊपरी स्तर पर भेजते हैं।
`ended_by` का मान `end_user`, `bank`, `customer` या `unknown` होता है।
इवेंट का सटीक स्कीमा हर इवेंट के लिए [API संदर्भ](https://docs.didit.me/hi/standalone-apis/bank-data.md) में दिया गया है।

## उदाहरण

```json theme={null}
{
  "event_id": "7c1e0a52-93d4-4a6b-8f21-0d5b9e3a64c7",
  "webhook_type": "bank.sync.completed",
  "timestamp": 1763804640,
  "created_at": 1763804640,
  "application_id": "b3e1f0a2-5d64-4c8e-9a17-2f6d0c8b7e41",
  "environment": "sandbox",
  "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6",
  "sync_id": "c2b8d4f6-9a13-4e07-85bc-3d6e1f0a7b92",
  "trigger": "scheduled",
  "outcome": "succeeded",
  "changed": true
}
```

## इन्हें कैसे उपयोग करें

* **नया डेटा.** `bank.data.updated` केवल एक संकेत है: कोई डेटा भेजा नहीं जाता। [चेंज फ़ीड](https://docs.didit.me/hi/standalone-apis/bank-transactions-sync.md) को अपने सहेजे गए कर्सर के साथ कॉल करें। `bank.sync.completed` का उपयोग केवल तभी करें जब आप हर सिंक देखना चाहते हों, जिसमें वे सिंक भी शामिल हैं जिनमें कोई बदलाव नहीं हुआ।
* **ऑनबोर्डिंग.** खाते पढ़ने से पहले `bank.connection.created` की प्रतीक्षा करें, और पूरे इतिहास पर भरोसा करने से पहले `bank.connection.history_complete` की प्रतीक्षा करें।
* **सहमति.** `bank.connection.consent_expiring` पर व्यक्ति से नवीनीकरण का अनुरोध करें। `bank.connection.renewal_required` पर डेटा अब भी पढ़ा जा सकता है, लेकिन उसका सिंक अब नहीं होता।
* **रोकें.** `bank.connection.revoked` पर उस कनेक्शन के लिए अपना फ़ीड रोकें और तय करें कि संग्रहीत डेटा [हटाना](https://docs.didit.me/hi/standalone-apis/bank-connection-delete.md) है या नहीं।
* **डुप्लिकेट.** हर इवेंट को इडेम्पोटेंटली संभालें: इवेंट ID को कुंजी बनाएँ, और कभी-कभी एक ही इवेंट दो बार मिल सकता है, इसके लिए तैयार रहें।
* **कभी ब्राउज़र पर भरोसा न करें।** लिंक की पुष्टि `bank.link.completed` या `GET /v3/bank/links/{id}/` से करें, न कि किसी पेज द्वारा भेजे गए लिंक ID से।

## अगले चरण

* [अकाउंटिंग के लिए निरंतर बैंक फ़ीड](https://docs.didit.me/hi/use-cases/bank-data-for-accounting.md)
* [सैंडबॉक्स](https://docs.didit.me/hi/core-technology/bank-verification/sandbox.md): Didit Test Bank इन इवेंट्स को ट्रिगर करता है।


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.