> ## 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 का बैंक डेटा मॉडल: स्थायी ID वाले खाते, टाइप किए गए बैलेंस, बुक और लंबित लेन-देन, और टिकाऊ कर्सर वाला परिवर्तन फ़ीड।

Didit की Bank data API हर कनेक्शन के खाते, बैलेंस और लेन-देन को स्टोर करती है और उन्हें डेटा पढ़ने वाले endpoint के ज़रिए पेजिनेशन के साथ उपलब्ध कराती है (सूचियों के लिए `cursor`, लेन-देन संबंधी डेटा पढ़ने के लिए `page_token`)।
राशियाँ अलग ISO 4217 `currency` के साथ दशमलव स्ट्रिंग के रूप में दी जाती हैं, तिथियाँ ISO 8601 में होती हैं, और देश ISO alpha-3 में होते हैं।
डेटा पढ़ने पर कभी बिलिंग नहीं होती।

## खाते

`GET /v3/bank/connections/{id}/accounts/` किसी कनेक्शन के सभी खाते सूचीबद्ध करता है, और `GET /v3/bank/accounts/{account_id}/` एक खाता लौटाता है।

| फ़ील्ड | अर्थ |
| - | - |
| `id` | यह कनेक्शन से जुड़ा होता है और जब तक कनेक्शन मौजूद है, तब तक नहीं बदलता, नवीनीकरण के बाद भी नहीं। |
| `account_ref` | यह एक ही एप्लिकेशन और एनवायरनमेंट के अलग-अलग कनेक्शनों में एक ही बैंक खाते की पहचान करता है। यह बैंक के अपने पहचानकर्ताओं का कुंजीबद्ध हैश है, और जब बैंक कोई भरोसेमंद पहचानकर्ता नहीं देता, तब `null` होता है। |
| `type`, `usage` | `current`, `savings`, `card`, `loan`, `investment` या `other`, और `personal`, `business` या `unknown`। |
| `identifiers` | IBAN, BIC और अन्य पहचानकर्ता। बैंक डेटा की अनुमति वाले सर्वर-साइड कॉलर इन्हें पूरी तरह प्राप्त करते हैं। |
| `holders[]` | हर धारक का `name` और `role`: `holder`, `joint_holder`, `representative` या `unknown`। |
| `sync.last_synced_at` | वह समय जब Didit ने आखिरी बार बैंक से डेटा लाया, न कि वह समय जब आपने उसे आखिरी बार पढ़ा। |
| `history_coverage` | बैंक ने आपके माँगे गए इतिहास का कितना हिस्सा दिया: `requested_from`, `oldest_booking_date`, `covered_ranges`, `missing_ranges`, और `status`, जिसके मान `complete`, `partial`, `empty`, `unavailable` या `unknown` हैं। |

जब कोई व्यक्ति वही बैंक खाता दोबारा जोड़ता है, तो उस खाते को पहचानने के लिए `account_ref` का उपयोग करें, और एक ही कनेक्शन के भीतर हर चीज़ के लिए `id` का उपयोग करें।

## बैलेंस

`GET /v3/bank/accounts/{account_id}/balances/` प्रकार-सहित बैलेंस उनकी संदर्भ तिथियों के साथ लौटाता है।

```json theme={null}
{
  "account_id": "a71f0c2e-...",
  "balances": [
    { "type": "booked", "amount": "18250.34", "currency": "EUR", "reference_date": "2026-11-20" },
    { "type": "available", "amount": "17990.34", "currency": "EUR", "reference_date": "2026-11-21" }
  ],
  "last_synced_at": "2026-11-21T12:04:40Z"
}
```

`type` का मान `booked`, `available` या `expected` होता है, और जहाँ बैंक ISO 20022 कोड देता है, वहाँ `iso_type` उसे दर्शाता है।

## लेन-देन

`GET /v3/bank/accounts/{account_id}/transactions/` एक तिथि सीमा पढ़ता है।
यह `date_from` और `date_to` लेता है (बैंक द्वारा दर्ज कैलेंडर तिथियाँ, दोनों शामिल), `status` (`booked` या `pending`, डिफ़ॉल्ट रूप से दोनों), `limit` (अधिकतम 500) और `page_token`।
यह `effective_date` के अनुसार घटते क्रम में, फिर `id` के अनुसार क्रमबद्ध करता है।

```json theme={null}
{
  "id": "8f2b...",
  "status": "booked",
  "booking_date": "2026-11-19",
  "value_date": "2026-11-20",
  "amount": "-1210.00",
  "currency": "EUR",
  "direction": "debit",
  "description": "RECIBO SEGURIDAD SOCIAL",
  "counterparty": { "name": "TESORERIA GENERAL SEG SOCIAL", "iban": "ES7620770024003102575766" },
  "remittance": { "unstructured": ["RECIBO SEGURIDAD SOCIAL 10/2026"], "reference": "0028123456789" },
  "bank_transaction_code": "PMNT-RDDT-ESDD",
  "bank_reference": "2026111900012345",
  "identity_quality": "bank_reference",
  "balance_after": "18250.34",
  "category": "taxes_and_social_security"
}
```

* **`id`** Didit का है, और इसे पहली बार देखे जाने पर संग्रहीत किया जाता है। एक ही लेन-देन हर रीड, सिंक और नवीनीकरण में अपना id बनाए रखता है।
* **`identity_quality`** बताता है कि यह गारंटी कितनी मज़बूत है। `bank_reference` और `route_id` स्थिर हैं। `derived` का अर्थ है कि लेन-देन का मिलान उसकी सामग्री से किया गया था, इसलिए बैंक के सुधार में एक `removed` और एक `added` दिखाई दे सकता है।
* **`status`** `booked` या `pending` होता है। लंबित लेन-देन का अपना id होता है। जब बैंक उसे दर्ज करता है, तो दर्ज लेन-देन `added` के रूप में आता है और लंबित वाला `reason: pending_booked` के साथ `removed` के रूप में आता है। `pending_id` केवल तभी सेट होता है जब बैंक दोनों को जोड़ता है।
* **`amount`** signed होता है: ऋणात्मक का अर्थ है पैसा बाहर गया। `direction` वही चिह्न दोहराता है।
* **`bank_reference`** बैंक की प्रविष्टि का अपरिवर्तनीय संदर्भ है, और जहाँ बैंक इसे नहीं देता वहाँ `null` होता है। Didit इसे कभी स्वयं नहीं बनाता।
* **`category`** Didit का अपना वर्गीकरण है, जब कोई लागू होता हो।
* बैंक द्वारा दर्ज लेन-देन में किया गया सुधार `modified` होता है। उलटफेर एक नया लेन-देन होता है, और जब बैंक उसे जोड़ता है तो `reverses_id` के साथ।

### जो फ़ील्ड बैंक नहीं भेजता, वे null होते हैं

हर फ़ील्ड जिसे बैंक नहीं भेजता, वह `null` होता है।
संस्थान `transaction_fields` में वे फ़ील्ड सूचीबद्ध करता है जिन्हें भेजने के लिए वह जाना जाता है, साथ में `pending_transactions`, `pending_linkage`, `balance_types` और `history_days_max` भी, ताकि प्रोडक्शन में कोई भी कमी अचानक न पकड़े।
कम डेटा भेजने वाले बैंक के विरुद्ध अपना कोड परखने के लिए [सैंडबॉक्स](https://docs.didit.me/hi/core-technology/bank-verification/sandbox.md) में `sparse_fields` टेस्ट ग्राहक का उपयोग करें।

### तिथि सीमा की पेजिंग

`has_more` true होने तक `page_token` के साथ पढ़ना जारी रखें।
यह टोकन एक घंटे के लिए रीड का स्नैपशॉट स्थिर रखता है: पहले पेज के बाद जोड़ी गई पंक्तियाँ उसमें नहीं होतीं, हर पंक्ति अपनी वर्तमान स्थिति में दी जाती है, और पेजिंग के दौरान हटाई गई पंक्ति बाद के पेजों से बाहर हो जाती है और बदलाव फ़ीड में दिखती है।
समाप्त हो चुका टोकन `410 page_expired` लौटाता है: मूल क्वेरी से रीड दोबारा शुरू करें।

## परिवर्तन फ़ीड

`GET /v3/bank/connections/{id}/transactions/sync/` कनेक्शन के सभी खातों में, `cursor` के बाद से जो कुछ बदला है, वह लौटाता है।

```json theme={null}
{
  "added": [ { "id": "...", "status": "booked", "amount": "-35.00" } ],
  "modified": [],
  "removed": [ { "id": "...", "reason": "pending_booked" } ],
  "has_more": false,
  "next_cursor": "...",
  "reset": false
}
```

* खाली cursor सभी मौजूदा लेन-देन को `added` के रूप में `reset: true` के साथ लौटाता है। अपनी प्रति को इसके साथ बदल दें, उसमें जोड़ें नहीं।
* जब तक `has_more` true है, `page_token` के साथ पेजिंग जारी रखें। `next_cursor` को केवल `has_more: false` वाले रिस्पॉन्स के बाद ही सहेजें, और यदि बीच में पेजिंग विफल हो जाए, तो अपने सहेजे गए cursor से फिर से शुरू करें।
* cursor अपारदर्शी होता है और कनेक्शन तथा एनवायरनमेंट से बंधा होता है। परिवर्तन लॉग 90 दिनों तक पुनः चलाने योग्य रहता है। इससे पुराना cursor `bootstrap: true` के साथ `410 cursor_expired` लौटाता है: खाली cursor से फिर से शुरू करें और अपनी प्रति बदल दें।
* `removed[].reason` इनमें से कोई एक होता है: `pending_booked`, `pending_expired`, `bank_removed` या `access_removed`।

चरण-दर-चरण संस्करण [लेखांकन के लिए निरंतर बैंक फ़ीड](https://docs.didit.me/hi/use-cases/bank-data-for-accounting.md) में है।

## हेडर

दोनों ट्रांज़ैक्शन रीड `X-RateLimit-*` हेडर लौटाते हैं (प्रति एप्लिकेशन प्रति मिनट 600 रीड और 300 राइट), और इससे अधिक होने पर 429 के साथ `Retry-After` लौटता है। इसके अलावा `X-Bank-Last-Synced-At` भी लौटता है।
API की सीमाएँ और बैंक की अपनी डेटा फ़ेच करने की सीमाएँ अलग चीज़ें हैं: देखें [मांग पर बैंक डेटा रीफ़्रेश करें](https://docs.didit.me/hi/use-cases/refresh-bank-data-on-demand.md).


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