> ## 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.

# बैंक कनेक्शन नवीनीकरण API: नवीनीकरण लिंक बनाएँ

> Didit का यह endpoint किसी कनेक्शन के लिए नवीनीकरण लिंक बनाता है, जो mode: renew वाले लिंक बनाने का शॉर्टकट है।

Didit का बैंक कनेक्शन नवीनीकरण endpoint एक कनेक्शन के लिए नवीनीकरण लिंक बनाता है। यह `mode: renew` वाला लिंक बनाने का एक छोटा तरीका है।
कनेक्शन ID और हर अकाउंट ID वही रहते हैं।
जब 30 से अधिक दिन शेष हों, यह `409 renewal_not_needed` उत्तर देता है।
देखें [बैंक सहमति का नवीनीकरण](https://docs.didit.me/hi/use-cases/renew-bank-consent.md)।


## OpenAPI

````yaml hi/openapi-25.json POST /v3/bank/connections/{id}/renew/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: पहचान सत्यापन API। x-api-key हेडर से प्रमाणित करें।
servers:
  - url: https://verification.didit.me
security: []
tags:
  - name: Bank Data
    description: >-
      Bank Link, कनेक्शन, खाते, बैलेंस, लेन-देन, संस्थान और कवरेज। बैंक डेटा
      सैंडबॉक्स एप्लिकेशन के लिए उपलब्ध है। किसी लाइव एप्लिकेशन की कॉल तब तक
      `404` लौटाती हैं जब तक लाइव पहुँच की घोषणा नहीं होती। सैंडबॉक्स में कोई
      शुल्क नहीं लिया जाता। API कुंजी से की गई कॉल के लिए ऐसी कुंजी चाहिए जिसमें
      बैंक डेटा अनुमति (`bank-data`) हो: पढ़ने के लिए read, और कुछ बदलने वाली
      संक्रियाओं के लिए write। खाता जाँच अपवाद है: इसके लिए सत्रों के लिए write
      पहुँच, या पूर्ण पहुँच चाहिए, बैंक डेटा अनुमति नहीं। बैंक डेटा पूर्ण पहुँच
      में शामिल नहीं है: पूर्ण पहुँच वाली कुंजी अस्वीकार की जाती है, और कॉल `403
      bank_data_access_denied` लौटाती है, जब तक आप ऐसी कुंजी नहीं बनाते जिसमें
      यह अनुमति हो। कच्चा बैंक डेटा (खाते, बैलेंस, लेन-देन और बदलाव फ़ीड) भी ऐसे
      अनुरोध को अस्वीकार करता है जिसमें API कुंजी न हो।


      `/v3/bank/` के अंतर्गत खाता जाँच के अलावा हर अस्वीकृति का एक ही JSON बॉडी
      होती है (`code`, `message`, `request_id`, `field`, `next_action`,
      `retry_after`)। ऐसा पथ जो कोई संक्रिया नहीं है, ऐसा ID जो UUID नहीं है, या
      कोई अज्ञात उप-संसाधन हर मेथड के लिए `404 not_found` लौटाता है, और कोई भी
      अनपेक्षित त्रुटि `request_id` के साथ `500 internal_error` लौटाती है। जहाँ
      बैंक डेटा उपलब्ध नहीं है, वहाँ हर संक्रिया प्लेटफ़ॉर्म का मानक `404`
      लौटाती है, ठीक वैसे ही जैसे कोई अज्ञात रूट लौटाता है।
paths:
  /v3/bank/connections/{id}/renew/:
    post:
      tags:
        - Bank Data
      summary: बैंक कनेक्शन का नवीनीकरण करें
      description: >-
        इस कनेक्शन के लिए नवीनीकरण लिंक बनाता है, जो `mode: renew` के साथ
        `create_link` का शॉर्टकट है। कनेक्शन id और हर खाता id वही रहते हैं।


        लौटाए गए लिंक को होस्टेड पेज पर खोलना अभी उपलब्ध नहीं है: वह पेज जिससे
        व्यक्ति नवीनीकरण कर सके, अभी बनना बाकी है।


        जब तक सहमति में 30 दिन या उससे कम शेष हों, यह `409 renewal_not_needed`
        उत्तर देता है; `consent.renewable_until` के बाद यह `409
        renewal_window_expired` उत्तर देता है और व्यक्ति फिर से कनेक्ट करता है।


        बैंक डेटा अनुमति (`bank-data`) वाली API कुंजी चाहिए: यह ऑपरेशन कुछ बदलता
        है, इसलिए write चाहिए। पूरी पहुँच वाली कुंजी में यह शामिल नहीं होती:
        कुंजी बनाते समय इसे स्पष्ट रूप से दें, नहीं तो कॉल `403
        bank_data_access_denied` उत्तर देती है।
      operationId: renewBankConnection
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: कनेक्शन आईडी।
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BankRenewLinkRequest'
            example:
              redirect_url: https://app.example.com/bank/return
              language: es
      responses:
        '201':
          description: नवीनीकरण लिंक।
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankLink'
              examples:
                Renew link:
                  summary: मौजूदा कनेक्शन के लिए एक नवीनीकरण लिंक
                  value:
                    id: 0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40
                    mode: renew
                    access: ongoing
                    status: created
                    url: https://verify.didit.me/bank/link/example-link-token
                    client_token: example-client-token
                    expires_at: '2026-11-21T13:00:00Z'
                    connection_id: 5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35
                    check_id: null
                    reused: false
                    error: null
                    quote:
                      id: 7a3e9c52-1d84-4b06-8f2a-c5e0b9d17a43
                      lines:
                        - meter: bank_data_connection_month
                          unit: connection_month
                          price_usd: '0.9000'
                      fallback_lines: null
                      total_usd: '0.9000'
                      valid_until: '2026-11-21T13:00:00Z'
                      scopes:
                        - accounts
                        - balances
                        - transactions
                    vendor_data: client-7731
        '400':
          description: अनुरोध अस्वीकार किया गया।
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Redirect URL not registered:
                  summary: रीडायरेक्ट URL पंजीकृत नहीं है
                  value:
                    code: redirect_url_not_registered
                    message: >-
                      This redirect_url is not one of the return addresses
                      registered for your application. Addresses are matched
                      exactly (scheme, host, port, path and query); in sandbox a
                      plain http localhost address needs no registration. Send a
                      registered address, or leave redirect_url out (automatic
                      return to your page is then not promised).
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: redirect_url
                    next_action: null
                    retry_after: null
                Invalid request:
                  summary: अमान्य अनुरोध
                  value:
                    code: invalid_request
                    message: The request is not valid.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: expires_in
                    next_action: null
                    retry_after: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          description: >-
            बैलेंस उद्धृत कीमत के लिए पर्याप्त नहीं है। टॉप अप करें, फिर पुनः
            प्रयास करें।
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Insufficient credits:
                  summary: अपर्याप्त क्रेडिट
                  value:
                    code: insufficient_credits
                    message: The balance cannot cover the quoted price.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: top_up_balance
                    retry_after: null
        '403':
          description: >-
            अस्वीकृत: कुंजी में Bank data अनुमति नहीं है
            (`bank_data_access_denied`), या आपके अनुबंध में कनेक्शन के देश के
            लिए दर नहीं है (`contract_rate_missing`)।
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                No contract rate:
                  summary: कोई अनुबंध दर नहीं
                  value:
                    code: contract_rate_missing
                    message: Your contract has no rate for bank data in this country.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: null
                    retry_after: null
                Bank data not allowed:
                  summary: बैंक डेटा की अनुमति नहीं है
                  value:
                    code: bank_data_access_denied
                    message: >-
                      Bank data calls need an API key that carries the Bank data
                      permission.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: enable_bank_data_access
                    retry_after: null
        '404':
          description: यह संसाधन इस एप्लिकेशन और एनवायरनमेंट में मौजूद नहीं है।
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not found:
                  summary: नहीं मिला
                  value:
                    code: not_found
                    message: The resource does not exist.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: null
                    retry_after: null
        '409':
          description: कनेक्शन अभी नवीनीकृत नहीं किया जा सकता।
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Renewal not needed:
                  summary: नवीनीकरण की आवश्यकता नहीं
                  value:
                    code: renewal_not_needed
                    message: >-
                      The consent has more than 30 days left. Try again closer
                      to its end.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: null
                    retry_after: null
                Renewal window expired:
                  summary: नवीनीकरण अवधि समाप्त हो गई
                  value:
                    code: renewal_window_expired
                    message: >-
                      The window to renew this connection has passed. Create a
                      new link.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: create_link
                    retry_after: null
                Not renewable:
                  summary: नवीनीकरण योग्य नहीं
                  value:
                    code: connection_not_active
                    message: This connection is not active.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: create_link
                    retry_after: null
        '429':
          $ref: '#/components/responses/RateLimitedWrite'
        '500':
          $ref: '#/components/responses/BankDataInternalError'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X POST
            'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/renew/'
            \
              -H 'x-api-key: YOUR_API_KEY' \
              -H 'Content-Type: application/json' \
              -d '{
                "redirect_url": "https://app.example.com/bank/return",
                "language": "es"
              }'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.bank.renew_connection(
                "11111111-2222-3333-4444-555555555555",
                redirect_url="https://app.example.com/bank/return",
                language="es",
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY.

            const didit = new Didit();


            const result = await
            didit.bank.renewConnection("11111111-2222-3333-4444-555555555555", {
              redirect_url: "https://app.example.com/bank/return",
              language: "es",
            });

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Bank.RenewConnection(ctx, \"11111111-2222-3333-4444-555555555555\", didit.BankRenewConnectionParams{\n\tBody: didit.BankRenewLinkRequest{\n\t\tRedirectURL: didit.String(\"https://app.example.com/bank/return\"),\n\t\tLanguage:    didit.String(\"es\"),\n\t},\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import me.didit.Didit;

            import me.didit.types.BankRenewLinkRequest;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.bank().renewConnection("11111111-2222-3333-4444-555555555555",
            BankRenewLinkRequest.builder()
                    .redirectUrl("https://app.example.com/bank/return")
                    .language("es")
                    .build());
            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->bank->renewConnection('11111111-2222-3333-4444-555555555555',
            [
                'redirect_url' => 'https://app.example.com/bank/return',
                'language' => 'es',
            ]);

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.bank.renew_connection(
              "11111111-2222-3333-4444-555555555555",
              redirect_url: "https://app.example.com/bank/return",
              language: "es"
            )
            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            var result = await
            client.Bank.RenewConnectionAsync("11111111-2222-3333-4444-555555555555",
            new BankRenewLinkRequest

            {
                RedirectUrl = "https://app.example.com/bank/return",
                Language = "es",
            });

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      description: >-
        एक ऑपरेशन के लिए आपके द्वारा चुनी गई वैकल्पिक पुनः प्रयास-सुरक्षा कुंजी,
        जो अधिकतम 255 अक्षरों की हो सकती है (UUID उपयोग की जा सकती है)। वही
        कुंजी, endpoint, क्वेरी और बॉडी के साथ दोहराया गया अनुरोध पहले वाले
        रिस्पॉन्स से ही उत्तर पाता है, वही स्टेटस और वही बॉडी, और दूसरी बार न
        कोई प्रक्रिया चलती है न कोई शुल्क लगता है। वही कुंजी किसी दूसरे
        endpoint, क्वेरी या बॉडी के साथ भेजने पर `409` `idempotency_key_reused`
        रिस्पॉन्स मिलता है, और जब पहला अनुरोध अभी भी चल रहा हो, तब `Retry-After`
        के साथ `409` `idempotency_key_in_progress` मिलता है। विफल अनुरोध (कोई भी
        `4xx` या `5xx`) सहेजा नहीं जाता, इसलिए आप उसी कुंजी के साथ उसे दोबारा
        भेज सकते हैं। कुंजियाँ आपके एप्लिकेशन की होती हैं, चाहे आप API कुंजी से
        कॉल करें या एक्सेस टोकन से। देखें [पुनः प्रयास और
        आइडेम्पोटेंसी](/hi/integration/api-errors#पुनः-प्रयास-और-आइडेम्पोटेंसी)।
      schema:
        type: string
        minLength: 1
        maxLength: 255
  schemas:
    BankRenewLinkRequest:
      type: object
      description: वैकल्पिक, नवीनीकरण लिंक की सेटिंग्स। बाकी कनेक्शन से आता है।
      properties:
        redirect_url:
          type: string
          format: uri
          description: >-
            अंत में ब्राउज़र कहाँ जाता है। सैंडबॉक्स एप्लिकेशन में `localhost`,
            `127.0.0.1` या `[::1]` का सादा `http` पता पंजीकरण की आवश्यकता नहीं
            रखता। कोई अन्य पता `400 redirect_url_not_registered` लौटाता है: अन्य
            पते पंजीकृत करने की सुविधा अभी उपलब्ध नहीं है।
          maxLength: 2048
        allowed_origins:
          type: array
          items:
            type: string
            format: uri
          description: >-
            स्वीकृत है, लेकिन अभी इसका उपयोग नहीं होता: यह Didit के एम्बेडेड
            Bank Link के लिए आरक्षित है, जो अभी जारी नहीं हुआ है। HTTPS ओरिजिन,
            अधिकतम 50।
          maxItems: 50
        language:
          type: string
          pattern: ^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$
          maxLength: 16
        expires_in:
          type: integer
          description: जीवनकाल सेकंड में, 300 से 86400 तक।
          minimum: 300
          maximum: 86400
          default: 3600
    BankLink:
      type: object
      description: >-
        एक व्यक्ति के लिए Bank Link का एक रन: बैंक कनेक्ट करना, या कनेक्शन
        नवीनीकृत करना। `get_link` से लिंक की पुष्टि स्वयं करें: ब्राउज़र से भेजे
        गए ID पर कभी भरोसा न करें।
      properties:
        id:
          type: string
          description: लिंक का पहचानकर्ता।
          format: uuid
        mode:
          type: string
          enum:
            - connect
            - renew
        access:
          type: string
          enum:
            - one_time
            - ongoing
        status:
          type: string
          enum:
            - created
            - opened
            - connecting
            - completed
            - cancelled
            - expired
            - failed
          description: >-
            लिंक की स्थिति। `completed`, `cancelled`, `expired` और `failed`
            अंतिम हैं।
        url:
          type: string
          description: >-
            वह होस्टेड पेज जिस पर व्यक्ति को भेजना है। यह केवल लिंक बनाते समय
            लौटाया जाता है; बाद की रीड में यह `null` होता है, क्योंकि टोकन
            संग्रहीत नहीं किया जाता।
          nullable: true
          format: uri
        client_token:
          type: string
          description: >-
            Didit के एम्बेडेड Bank Link का टोकन, जो अभी जारी नहीं हुआ है: आज
            `url` खोलें। यह केवल लिंक बनाते समय लौटाया जाता है; बाद की रीड पर
            `null`। इसका उद्देश्य एक है और यह कम समय के लिए वैध है। इसमें कोई
            व्यक्तिगत डेटा नहीं होता। इसे कभी लॉग न करें।
          nullable: true
        expires_at:
          type: string
          description: जो लिंक अभी तक उपयोग नहीं हुआ है, वह कब काम करना बंद कर देता है।
          format: date-time
        connection_id:
          type: string
          description: >-
            वह कनेक्शन जिसे इस लिंक ने बनाया या नवीनीकृत किया है, जब `status`
            `completed` हो जाए।
          format: uuid
          nullable: true
        check_id:
          type: string
          description: >-
            इस लिंक का स्वामित्व परिणाम, जब उसने `ownership.compare` के लिए
            `none` से भिन्न कोई मान माँगा हो।
          format: uuid
          nullable: true
        reused:
          type: boolean
          description: >-
            `true` तब होता है जब लिंक एक मौजूदा कनेक्शन के नवीनीकरण के रूप में
            पूरा हुआ, क्योंकि व्यक्ति पहले से ठीक ये ही खाते साझा करता है
            (`duplicates: reuse`)। कोई शुल्क दोबारा नहीं लगता।
        error:
          allOf:
            - $ref: '#/components/schemas/BankLinkError'
          nullable: true
          description: लिंक विफल होने का कारण, जब `status` `failed` हो। अन्यथा `null`।
        quote:
          $ref: '#/components/schemas/BankLinkQuote'
        vendor_data:
          type: string
          description: अनुरोध से आपका संदर्भ।
          nullable: true
      required:
        - id
        - mode
        - access
        - status
        - url
        - client_token
        - expires_at
        - connection_id
        - check_id
        - reused
        - error
        - quote
        - vendor_data
    BankDataError:
      type: object
      description: Bank data के हर ऑपरेशन का एरर बॉडी। हर फ़ील्ड हमेशा मौजूद रहता है।
      properties:
        code:
          type: string
          enum:
            - ongoing_access_not_available
            - segment_not_available
            - window_not_available
            - history_window_ambiguous
            - redirect_url_not_registered
            - link_origin_not_allowed
            - bank_data_access_denied
            - connection_not_active
            - consent_expired
            - renewal_not_needed
            - renewal_window_expired
            - access_removed
            - refresh_limit_reached
            - cursor_expired
            - page_expired
            - invalid_cursor
            - page_token_mismatch
            - contract_rate_missing
            - insufficient_credits
            - invalid_request
            - not_found
            - internal_error
          description: >-
            मशीन-पठनीय त्रुटि कोड। शर्त इसी के आधार पर लिखें, कभी `message` के
            आधार पर नहीं।
        message:
          type: string
          description: >-
            डेवलपर के लिए सरल भाषा में स्पष्टीकरण। शब्द बदल सकते हैं; इसे पार्स
            न करें।
        request_id:
          type: string
          description: इस अनुरोध का पहचानकर्ता। सहायता से संपर्क करते समय इसे उद्धृत करें।
        field:
          type: string
          description: >-
            वह अनुरोध फ़ील्ड जिसे सुधारना है, जब त्रुटि किसी एक फ़ील्ड के बारे
            में हो। अन्यथा `null`।
          nullable: true
        next_action:
          type: string
          enum:
            - retry_later
            - renew_connection
            - create_link
            - restart_from_cursor
            - restart_read
            - top_up_balance
            - enable_bank_data_access
            - contact_support
            - null
          description: >-
            आगे क्या करना है, ताकि क्लाइंट अनुमान लगाए बिना कार्रवाई कर सके। कोई
            मानक अगला चरण न होने पर `null`।
          nullable: true
        retry_after:
          type: integer
          description: >-
            पुनः प्रयास करने से पहले प्रतीक्षा के सेकंड। रेट लिमिट और अस्थायी
            त्रुटियों पर सेट होता है, अन्यथा `null`।
          nullable: true
      required:
        - code
        - message
        - request_id
        - field
        - next_action
        - retry_after
      example:
        code: ongoing_access_not_available
        message: >-
          This bank cannot keep access open. Use access one_time or choose
          another bank.
        request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
        field: institution_id
        next_action: create_link
        retry_after: null
    BankLinkError:
      type: object
      description: >-
        वह कारण जिससे लिंक `failed` पर समाप्त हुआ। कुछ भी प्रकाशित या चार्ज नहीं
        हुआ।
      properties:
        code:
          type: string
          enum:
            - duplicate_conflict
            - renewal_login_mismatch
            - reduced_grant
            - corporate_approval_not_supported
            - ongoing_access_not_available
            - bank_unavailable
            - bank_cancelled
            - consent_declined
            - read_limit
            - renewal_not_needed
            - renewal_window_expired
            - first_sync_failed
          description: >-
            लिंक विफल होने का कारण। विफल लिंक HTTP त्रुटि नहीं है: लिंक `status:
            failed` और यह ऑब्जेक्ट लौटाता है। यदि नवीनीकरण लिंक का कनेक्शन इस
            बीच बदल गया हो, तो वह `renewal_not_needed` या
            `renewal_window_expired` दिखाता है।
        message:
          type: string
          description: डेवलपर के लिए सरल भाषा में स्पष्टीकरण।
        conflicts_with:
          type: array
          nullable: true
          items:
            type: string
            format: uuid
          description: >-
            `duplicate_conflict` के साथ: ओवरलैप होने वाले सक्रिय कनेक्शनों के
            ID। उनमें से किसी एक को नवीनीकृत करें, या `duplicates: allow` के साथ
            लिंक फिर से बनाएँ।
      required:
        - code
        - message
        - conflicts_with
    BankLinkQuote:
      type: object
      description: >-
        लिंक की कीमत, जो उसके बनने के समय तय हो जाती है। चार्ज की गई कीमत कोट की
        होती है। रीड कभी बिल नहीं होते।
      properties:
        id:
          type: string
          description: कोट का पहचानकर्ता।
          format: uuid
        lines:
          type: array
          items:
            $ref: '#/components/schemas/BankLinkQuoteLine'
          description: >-
            ये वे लाइनें हैं जो इस लिंक के लिए शुल्क में जुड़ती हैं, उन स्कोप्स
            के लिए जो यह माँगता है।
        fallback_lines:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/BankLinkQuoteLine'
          description: >-
            एक बार का फ़ॉलबैक कितना चार्ज करेगा, केवल तब जब लिंक
            `allow_one_time_fallback` के साथ बनाया गया हो। यह लिंक बनाने के
            रिस्पॉन्स में दिखता है और अन्यथा `null` है। डेटा वाली एक बार की रीड
            पहले महीने की सतत एक्सेस से अधिक लागत ला सकती है।
        total_usd:
          type: string
          description: >-
            `lines` का कुल योग USD में। यह कुल केवल घट सकता है: कम अनुदान के
            साथ, या जब व्यक्ति कम कीमत वाला देश चुनता है।
          pattern: ^-?\d+(\.\d+)?$
        valid_until:
          type: string
          description: >-
            कोट लिंक से जुड़ा रहता है और लिंक के पूरे जीवनकाल तक वैध रहता है,
            इसलिए यह `expires_at` के बराबर है।
          format: date-time
        scopes:
          type: array
          items:
            type: string
            enum:
              - accounts
              - balances
              - transactions
          description: यह डेटा कोट की कीमतों का दायरा तय करता है।
      required:
        - id
        - lines
        - fallback_lines
        - total_usd
        - valid_until
        - scopes
    RateLimitBudgetError:
      type: object
      description: >-
        यह केवल रेट-लिमिट मिडलवेयर बजट अस्वीकृति के लिए लौटाया जाता है। अन्य 429
        त्रुटियाँ, जिनमें आइडेम्पोटेंसी टकराव और endpoint-विशिष्ट सीमाएँ शामिल
        हैं, इन मेटाडेटा फ़ील्ड्स की गारंटी नहीं देतीं।
      required:
        - detail
        - reference
        - limit
        - remaining
        - reset
        - window_seconds
      properties:
        detail:
          type: string
          description: मौजूदा मानव-पठनीय बजट अस्वीकृति संदेश।
        reference:
          type: string
          pattern: ^RL-[0-9a-f]{32}$
          description: >-
            अपारदर्शी सहायता संदर्भ: RL- के बाद 32 लोअरकेस UUID हेक्साडेसिमल
            अक्षर।
        limit:
          type: integer
          description: सीमा से अधिक हुए दायरे का बजट; यह X-RateLimit-Limit के बराबर है।
        remaining:
          type: integer
          minimum: 0
          description: शेष बजट, शून्य पर सीमित; X-RateLimit-Remaining के बराबर।
        reset:
          type: integer
          format: int64
          description: >-
            विंडो रीसेट का समय Unix सेकंड में; यह X-RateLimit-Reset के बराबर
            होता है।
        window_seconds:
          type: integer
          description: >-
            फ़िक्स्ड-विंडो की अवधि सेकंड में, शेष प्रतीक्षा समय नहीं। दोबारा
            प्रयास करने से पहले Retry-After का पालन करें।
      example:
        detail: >-
          Write request rate limit exceeded. You can make up to 300 requests per
          minute.
        reference: RL-00000000000040008000000000000001
        limit: 300
        remaining: 0
        reset: 1794358860
        window_seconds: 60
    BankLinkQuoteLine:
      type: object
      description: कोटेशन की एक मूल्य-निर्धारित पंक्ति।
      properties:
        meter:
          type: string
          description: >-
            शुल्क किस चीज़ का लिया जाता है, उदाहरण के लिए
            `bank_data_connection_month`, `bank_verification`।
          example: bank_data_connection_month
        unit:
          type: string
          description: >-
            एक इकाई क्या है, उदाहरण के लिए `connection_month` या
            `completed_sign_in`।
          example: connection_month
        price_usd:
          type: string
          description: >-
            USD में एक इकाई की कीमत, 4 दशमलव वाली दशमलव स्ट्रिंग। उदाहरण में दी
            गई राशियाँ केवल उदाहरण हैं; किसी देश की कीमत मूल्य निर्धारण पेज पर
            दिखाई गई है।
          pattern: ^-?\d+(\.\d+)?$
          example: '0.9000'
      required:
        - meter
        - unit
        - price_usd
  responses:
    Unauthorized:
      description: अनधिकृत
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: अमान्य API कुंजी
              value:
                detail: Invalid API Key.
    RateLimitedWrite:
      description: >-
        प्रति API कुंजी प्रति मिनट 300 अनुरोधों की साझा राइट सीमा पार हो गई।
        पुनः प्रयास से पहले `Retry-After` का पालन करें।
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitBudgetError'
          example:
            detail: >-
              Write request rate limit exceeded. You can make up to 300 requests
              per minute.
            reference: RL-00000000000040008000000000000001
            limit: 300
            remaining: 0
            reset: 1794358860
            window_seconds: 60
      headers:
        Retry-After:
          $ref: '#/components/headers/BudgetRetryAfter'
        X-RateLimit-Scope:
          $ref: '#/components/headers/BudgetXRateLimitScope'
        X-RateLimit-Limit:
          $ref: '#/components/headers/BudgetXRateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/BudgetXRateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/BudgetXRateLimitReset'
    BankDataInternalError:
      description: >-
        Didit की ओर से कुछ गड़बड़ हुई है। `/v3/bank/` के तहत कोई भी अप्रत्याशित
        त्रुटि बैंक त्रुटि संरचना में उत्तर देती है, कभी HTML पेज में नहीं:
        सहायता टीम को `request_id` बताएँ।
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Internal error:
              summary: एक अनपेक्षित त्रुटि
              value:
                code: internal_error
                message: >-
                  Something went wrong on our side. Quote the request_id to
                  support.
                request_id: 3f6a1c8e92b54d07a1e38c4b7f0d2e59
                field: null
                next_action: contact_support
                retry_after: null
  headers:
    BudgetRetryAfter:
      description: >-
        प्रतीक्षा के सेकंड, जिन्हें अगली विंडो तक ऊपर की ओर राउंड किया गया है।
        मिडलवेयर बजट अस्वीकृतियों पर मौजूद होता है।
      schema:
        type: integer
    BudgetXRateLimitScope:
      description: वह दायरा जिसका बजट पार हुआ। मिडलवेयर बजट अस्वीकृतियों पर मौजूद होता है।
      schema:
        type: string
    BudgetXRateLimitLimit:
      description: >-
        सीमा से अधिक हुए दायरे का बजट; यह बॉडी लिमिट के बराबर है। यह middleware
        बजट अस्वीकृतियों में मौजूद होता है।
      schema:
        type: integer
    BudgetXRateLimitRemaining:
      description: >-
        शेष बजट, शून्य पर सीमित; body remaining के बराबर। मिडलवेयर बजट
        अस्वीकृतियों पर मौजूद।
      schema:
        type: integer
    BudgetXRateLimitReset:
      description: >-
        रीसेट का समय Unix सेकंड में; यह बॉडी के reset के बराबर होता है। मिडलवेयर
        बजट अस्वीकृतियों पर मौजूद होता है।
      schema:
        type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        आपकी एप्लिकेशन की API कुंजी, जो Business Console में Developers -> API
        keys से मिलती है। प्राथमिक कुंजी के पास पूर्ण पहुँच होती है। नामित कुंजी
        को सीमित किया जा सकता है: प्रति संसाधन कोई नहीं, read या write, कुछ
        वर्कफ़्लो या केवल स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और
        समाप्ति तिथि के साथ। 401 का अर्थ है कि कुंजी गलत, रद्द या समय-सीमा
        समाप्त है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई, कुंजी को इस संसाधन
        या कार्रवाई तक पहुँच नहीं है, या अनुरोध उसकी IP सूची के बाहर के पते से
        आया; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों
        के बाहर है। मीडिया पहुँच के बिना कुंजी को image, video और PDF URL null
        मिलते हैं, और sessions write के बिना कुंजी को सत्र लिंक और token null
        मिलते हैं। देखें https://docs.didit.me/console/api-keys।

````

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