> ## 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 टेस्ट बैंक के खातों, बैलेंस और लेन-देन तक पहुँचें: API कुंजी और लिंक बनाएँ, कनेक्ट करें, पढ़ें, सिंक करें और हटाएँ।

बैंक डेटा सैंडबॉक्स एप्लिकेशन के लिए उपलब्ध है।
लाइव एप्लिकेशन के कॉल तब तक `404` लौटाते हैं जब तक लाइव एक्सेस की घोषणा नहीं होती, और सैंडबॉक्स में किसी भी शुल्क का भुगतान नहीं करना होता।
यह क्विकस्टार्ट कॉपी-पेस्ट किए जा सकने वाले अनुरोधों के माध्यम से आपको सैंडबॉक्स एप्लिकेशन से लेकर Didit Test Bank के खातों, शेष राशियों और लेन-देन तक ले जाता है।

> [!NOTE]
>
> नीचे दिया गया हर रिस्पॉन्स केवल उन फ़ील्ड तक सीमित किया गया है जो मायने रखते हैं।
> API कुंजी को अपने सर्वर पर ही रखें: यह कभी भी ब्राउज़र या एप्लिकेशन तक नहीं पहुँचती।

## चरण 1: Bank data की अनुमति के साथ API कुंजी बनाएँ

Bank data, पूर्ण एक्सेस का हिस्सा नहीं है।
पूर्ण एक्सेस वाली कुंजी, जिसमें एप्लिकेशन का प्राथमिक सीक्रेट भी शामिल है, Bank data के हर कॉल पर `403 bank_data_access_denied` के साथ अस्वीकार की जाती है।

1. [Business Console](https://business.didit.me) में अपना सैंडबॉक्स एप्लिकेशन खोलें और **API keys** पर जाएँ।
2. कस्टम एक्सेस के साथ एक कुंजी बनाएँ और **Bank data** जोड़ें: पढ़ने वाली कॉल के लिए **Read**, और कुछ बनाने, बदलने या हटाने वाली कॉल के लिए **Write** चुनें।
3. कुंजी कॉपी करें और उसे एक्सपोर्ट करें:

```bash theme={null}
export DIDIT_API_KEY="your-sandbox-key"
```

संसाधनों की पूरी सूची के लिए [API कुंजियाँ](https://docs.didit.me/hi/console/api-keys.md) देखें।

## Step 2: बैंक लिंक बनाएँ

लिंक उन स्क्रीन का एक बार चलने वाला क्रम है जिनमें कोई व्यक्ति अपना बैंक जोड़ता है।
Test Bank के लिए एक सतत लिंक बनाएँ:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "data": ["accounts", "balances", "transactions"],
    "history_days": 90,
    "vendor_data": "client-7731"
  }'
```

`country` उस व्यक्ति के बैंक के देश का तीन-अक्षरों वाला कोड है और यह वैकल्पिक है।
जब आपको यह पता हो, तो इसे भेजें, ताकि व्यक्ति को केवल उसी देश के बैंक दिखें; इसके बिना उसे उन सभी देशों के बैंक चुनने होंगे जहाँ आप सेवा दे सकते हैं।
एक बार की पहुँच के लिए `"access": "one_time"` भेजें (यही डिफ़ॉल्ट है)।

```json theme={null}
{
  "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40",
  "mode": "connect",
  "access": "ongoing",
  "status": "created",
  "url": "https://verify.didit.me/bank/link/...",
  "expires_at": "2026-11-22T13:00:00Z",
  "connection_id": null
}
```

लिंक का `id` अपने उपयोगकर्ता के साथ सहेज कर रखें।
`url` और `client_token` केवल एक बार लौटाए जाते हैं, जब लिंक बनाया जाता है।

## चरण 3: लिंक खोलें और Didit Test Bank से कनेक्ट करें

ब्राउज़र में `url` खोलें, या इसे ईमेल या चैट से व्यक्ति को भेजें।
व्यक्ति को सहमति स्क्रीन दिखेगी। वह **Didit Test Bank** चुनेगा, परीक्षण ग्राहकों में से किसी एक से साइन इन करेगा और साझा करने के लिए खाते चुनेगा।
[सैंडबॉक्स पेज](https://docs.didit.me/hi/core-technology/bank-verification/sandbox.md) में परीक्षण ग्राहकों की सूची है और बताया गया है कि हर ग्राहक से आपको क्या मिलता है।

बाद में व्यक्ति को अपनी साइट पर वापस भेजने के लिए [अपनी साइट पर वापस लौटें](https://docs.didit.me/hi/integration/bank-link/return-to-your-site.md) देखें।
`redirect_url` के बिना व्यक्ति Didit के परिणाम पेज पर ही अपनी प्रक्रिया समाप्त करता है, और आपको परिणाम webhook से या डेटा पढ़ने के अनुरोध से पता चलता है।

## चरण 4: webhooks प्राप्त करें और पुष्टि करें

कंसोल में `bank.*` इवेंट्स के लिए एक webhook गंतव्य सब्सक्राइब करें, जैसे किसी भी [webhook](https://docs.didit.me/hi/integration/webhooks.md) के लिए करते हैं।
जब व्यक्ति प्रक्रिया पूरी कर लेता है, तो `link_id` और `connection_id` के साथ `bank.link.completed` इवेंट आता है। इसके बाद, जब पहला सिंक खातों को संग्रहीत कर लेता है, तब `bank.connection.created` आता है।

किसी ब्राउज़र से मिली लिंक ID पर कभी भरोसा न करें।
लिंक की जानकारी स्वयं पढ़ें:

```bash theme={null}
curl https://verification.didit.me/v3/bank/links/$LINK_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

```json theme={null}
{ "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40", "status": "completed", "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6" }
```

`status` का मान `completed` होता है या कोई अंतिम स्थिति (`cancelled`, `expired`, `failed`)। `failed` लिंक में `error.code` होता है; `cancelled` लिंक में `error: null` दिखता है।

## चरण 5: खाते, बैलेंस और लेन-देन पढ़ें

```bash theme={null}
curl https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/accounts/ -H "x-api-key: $DIDIT_API_KEY"
curl https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/balances/ -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/transactions/?date_from=2026-01-01" -H "x-api-key: $DIDIT_API_KEY"
```

राशियाँ दशमलव स्ट्रिंग के रूप में होती हैं, और बाहर जाने वाले धन के लिए ऋणात्मक होती हैं।
लेन-देन के किसी पेज में `next_page_token` तब तक शामिल रहता है जब तक पढ़ने के लिए और डेटा बाकी हो।
देखें [खाते, बैलेंस और लेन-देन](https://docs.didit.me/hi/core-technology/bank-verification/accounts-balances-transactions.md)।

## चरण 6: परिवर्तन फ़ीड का अनुसरण करें

परिवर्तन फ़ीड केवल वही लौटाता है जो आपके पिछले रीड के बाद बदला है।
आपका पहला रीड, बिना कर्सर के, पूरा स्नैपशॉट होता है: कनेक्शन में मौजूद हर लेन-देन, प्रत्येक `added` के रूप में, `reset: true` के साथ।
पहले पेज में `has_more: true`, `next_page_token` हो सकता है और अभी `next_cursor` न हो।
जब तक `has_more` `true` है, `page_token` के साथ पढ़ना जारी रखें, और अंतिम पेज (जिसमें `has_more: false` हो) का `next_cursor` अगली बार के लिए सहेजें:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/" -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?page_token=$NEXT_PAGE_TOKEN" -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?cursor=$NEXT_CURSOR" -H "x-api-key: $DIDIT_API_KEY"
```

`reset: true` का अर्थ है कि रिस्पॉन्स एक पूरा स्नैपशॉट है: उसमें जोड़ने के बजाय अपनी प्रति को उससे बदल दें।
`bank.data.updated` बताता है कि सिंक ने कुछ नया सहेजा है।

## चरण 7: अभी सिंक करें

सतत कनेक्शन अपने आप सिंक होता है।
बैंक डेटा अभी पढ़ने के लिए सिंक का अनुरोध करें:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ -H "x-api-key: $DIDIT_API_KEY"
```

एक बैंक एक दिन में बिना उपयोगकर्ता के डेटा पढ़ने की सीमित संख्या की अनुमति देता है।
कनेक्शन पर `sync.live_syncs_left_today` और `sync.budgets` बताते हैं कि कितनी रीडिंग शेष हैं और सीमाएँ कब रीसेट होती हैं, और सीमा से अधिक कॉल `429 refresh_limit_reached` लौटाती है, साथ में रीसेट का समय।
देखें: [मांग पर बैंक डेटा रीफ़्रेश करें](https://docs.didit.me/hi/use-cases/refresh-bank-data-on-demand.md)।

## चरण 8: पहुँच रोकें और हटाएँ

पहुँच रोकना और हटाना दो अलग-अलग कॉल हैं।

```bash theme={null}
# Stop access at the bank. The connection keeps its data until you delete it.
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/revoke/ -H "x-api-key: $DIDIT_API_KEY"

# Delete the connection and its data. Irreversible.
curl -X DELETE https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

हटाए गए कनेक्शन के लिए रिस्पॉन्स में केवल उसका `id`, `status`, `status_reason`, `created_at` और `erasure` फ़ील्ड होते हैं।
देखें: [डेटा, सहमति और हटाना](https://docs.didit.me/hi/core-technology/bank-verification/data-consent-and-deletion.md).

## अगले चरण

* [कनेक्शन](https://docs.didit.me/hi/core-technology/bank-verification/connections.md): एक बार की और सतत पहुँच, सहमति और नवीनीकरण।
* [बैंक webhook](https://docs.didit.me/hi/core-technology/bank-verification/webhooks.md)
* [मूल्य निर्धारण](https://docs.didit.me/hi/getting-started/bank-verification-pricing.md)
* [API संदर्भ](https://docs.didit.me/hi/standalone-apis/bank-data.md)


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