> ## 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 de renouvellement de connexion bancaire : créer un lien de renouvellement

> Le endpoint Renew a Bank Connection de Didit crée un lien de renouvellement pour une connexion, un raccourci pour créer un lien avec mode: renew.

L'endpoint Renew a Bank Connection crée un lien de renouvellement pour une connexion, un raccourci pour créer un lien avec `mode: renew`.
L'identifiant de la connexion et l'identifiant de chaque compte restent inchangés.
Il renvoie `409 renewal_not_needed` tant qu'il reste plus de 30 jours.
Voir [Renouveler un consentement bancaire](https://docs.didit.me/fr/use-cases/renew-bank-consent.md).


## OpenAPI

````yaml fr/openapi-25.json POST /v3/bank/connections/{id}/renew/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags:
  - name: Bank Data
    description: >-
      Bank Link, connexions, comptes, soldes, transactions, établissements et
      couverture. Les données bancaires sont disponibles pour les applications
      en sandbox. Les appels d'une application en production renvoient `404`
      tant que l'accès en production n'est pas annoncé. Rien n'est facturé en
      sandbox. Un appel effectué avec une clé API doit utiliser une clé qui
      porte l'autorisation Données bancaires (`bank-data`) : lecture pour les
      lectures, écriture pour les opérations qui modifient quelque chose. La
      vérification de compte fait exception : elle nécessite un accès en
      écriture aux sessions, ou un accès complet, et non l'autorisation Données
      bancaires. Les données bancaires ne font pas partie de l'accès complet :
      une clé à accès complet est refusée, et l'appel renvoie `403
      bank_data_access_denied` tant que vous n'avez pas créé une clé portant
      cette autorisation. Une requête qui ne porte aucune clé API est également
      refusée pour les données bancaires brutes (comptes, soldes, transactions
      et flux des modifications).


      Chaque refus sous `/v3/bank/`, sauf celui de la vérification de compte, a
      le même corps JSON (`code`, `message`, `request_id`, `field`,
      `next_action`, `retry_after`). Un chemin qui n'est pas une opération, un
      identifiant qui n'est pas un UUID ou une sous-ressource inconnue renvoie
      `404 not_found` quelle que soit la méthode, et toute erreur inattendue
      renvoie `500 internal_error` avec un `request_id`. Lorsque les données
      bancaires ne sont pas disponibles, chaque opération renvoie le `404`
      standard de la plateforme, exactement comme une route inconnue.
paths:
  /v3/bank/connections/{id}/renew/:
    post:
      tags:
        - Bank Data
      summary: Renouveler une connexion bancaire
      description: >-
        Crée un lien de renouvellement pour cette connexion, un raccourci pour
        `create_link` avec `mode: renew`. L'identifiant de connexion et chaque
        identifiant de compte restent identiques.


        Ouvrir le lien renvoyé sur la page hébergée n'est pas encore disponible
        : la page qui permet à la personne de renouveler sa connexion n'est pas
        encore créée.


        Tant que le consentement n'a pas 30 jours restants ou moins, la requête
        répond `409 renewal_not_needed` ; après `consent.renewable_until`, elle
        répond `409 renewal_window_expired` et la personne se reconnecte.


        Nécessite une clé API avec l'autorisation Données bancaires
        (`bank-data`) : écriture pour cette opération, qui modifie quelque
        chose. Une clé à accès complet ne l'inclut pas : accordez-la
        explicitement à la création de la clé, sinon l'appel répond `403
        bank_data_access_denied`.
      operationId: renewBankConnection
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: L'identifiant de la connexion.
        - $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: Le lien de renouvellement.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankLink'
              examples:
                Renew link:
                  summary: Un lien de renouvellement pour une connexion existante
                  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: La requête a été refusée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Redirect URL not registered:
                  summary: URL de redirection non enregistrée
                  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: Requête invalide
                  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: Le solde ne couvre pas le prix indiqué. Rechargez, puis réessayez.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Insufficient credits:
                  summary: Crédits insuffisants
                  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: "Refusé\_: la clé ne dispose pas de l'autorisation « Bank data » (`bank_data_access_denied`), ou votre contrat ne prévoit pas de tarif pour le pays de la connexion (`contract_rate_missing`)."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                No contract rate:
                  summary: Aucun tarif contractuel
                  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: Données bancaires non autorisées
                  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: >-
            La ressource n'existe pas dans cette application et cet
            environnement.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not found:
                  summary: Introuvable
                  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: La connexion ne peut pas être renouvelée pour le moment.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Renewal not needed:
                  summary: Renouvellement non nécessaire
                  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: Fenêtre de renouvellement expirée
                  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: Non renouvelable
                  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: >-
        Clé facultative de sécurisation des nouvelles tentatives, que vous
        choisissez pour une opération, d'au plus 255 caractères (un UUID
        convient). Une requête répétée avec la même clé, le même endpoint, les
        mêmes paramètres de requête et le même corps reçoit la première réponse,
        avec le même statut et le même corps, et n'est ni exécutée ni facturée
        une seconde fois. La même clé avec un autre endpoint, d'autres
        paramètres de requête ou un autre corps renvoie `409`
        `idempotency_key_reused`. Tant que la première requête est encore en
        cours, elle renvoie `409` `idempotency_key_in_progress` avec
        `Retry-After`. Une requête échouée (tout `4xx` ou `5xx`) n'est pas
        enregistrée, vous pouvez donc la renvoyer avec la même clé. Les clés
        sont propres à votre application, que vous appeliez avec une clé API ou
        un jeton d'accès. Voir [Nouvelles tentatives et
        idempotence](/fr/integration/api-errors#nouvelles-tentatives-et-idempotence).
      schema:
        type: string
        minLength: 1
        maxLength: 255
  schemas:
    BankRenewLinkRequest:
      type: object
      description: >-
        Paramètres facultatifs d'un lien de renouvellement. Le reste provient de
        la connexion.
      properties:
        redirect_url:
          type: string
          format: uri
          description: >-
            Où le navigateur est redirigé à la fin. Dans une application
            sandbox, une adresse `http` simple vers `localhost`, `127.0.0.1` ou
            `[::1]` ne nécessite aucun enregistrement. Toute autre adresse
            renvoie `400 redirect_url_not_registered` : l'enregistrement
            d'autres adresses n'est pas encore disponible.
          maxLength: 2048
        allowed_origins:
          type: array
          items:
            type: string
            format: uri
          description: >-
            Acceptées mais non utilisées aujourd'hui : réservées au Bank Link
            intégré de Didit, qui n'est pas encore disponible. Origines HTTPS,
            jusqu'à 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: Durée de vie en secondes, de 300 à 86400.
          minimum: 300
          maximum: 86400
          default: 3600
    BankLink:
      type: object
      description: "Une exécution de Bank Link pour une personne\_: connecter une banque ou renouveler une connexion. Confirmez vous-même un lien avec `get_link`\_: ne faites jamais confiance à un identifiant envoyé par le navigateur."
      properties:
        id:
          type: string
          description: Identifiant du lien.
          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: >-
            Statut du lien. `completed`, `cancelled`, `expired` et `failed` sont
            des statuts définitifs.
        url:
          type: string
          description: >-
            La page hébergée vers laquelle orienter la personne. Renvoyée
            uniquement à la création du lien ; `null` lors des lectures
            ultérieures, car le token n'est pas stocké.
          nullable: true
          format: uri
        client_token:
          type: string
          description: "Le jeton du Bank Link intégré de Didit, qui n'est pas encore disponible\_: ouvrez `url` dès aujourd'hui. Renvoyé uniquement à la création du lien\_; `null` lors des lectures suivantes. Usage unique et de courte durée. Il ne contient aucune donnée personnelle. Ne le journalisez jamais."
          nullable: true
        expires_at:
          type: string
          description: Quand un lien non utilisé cesse de fonctionner.
          format: date-time
        connection_id:
          type: string
          description: >-
            La connexion créée ou renouvelée par ce lien, une fois que `status`
            vaut `completed`.
          format: uuid
          nullable: true
        check_id:
          type: string
          description: >-
            Le résultat de la comparaison de l'actionnariat de ce lien, lorsque
            `ownership.compare` a été demandé avec une valeur autre que `none`.
          format: uuid
          nullable: true
        reused:
          type: boolean
          description: >-
            `true` lorsque le lien a été finalisé comme un renouvellement d'une
            connexion existante, car la personne partage déjà exactement ces
            comptes (`duplicates: reuse`). Aucun montant n'est facturé deux
            fois.
        error:
          allOf:
            - $ref: '#/components/schemas/BankLinkError'
          nullable: true
          description: >-
            Pourquoi le lien a échoué, lorsque `status` vaut `failed`. Sinon
            `null`.
        quote:
          $ref: '#/components/schemas/BankLinkQuote'
        vendor_data:
          type: string
          description: Votre référence issue de la requête.
          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: >-
        Corps d'erreur de toutes les opérations sur les données bancaires.
        Chaque champ est toujours présent.
      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: >-
            Code d'erreur lisible par machine. Fondez votre logique sur ce code,
            jamais sur `message`.
        message:
          type: string
          description: "Explication en langage clair pour un développeur. Le libellé peut changer\_; ne l'analysez pas."
        request_id:
          type: string
          description: >-
            Identifiant de cette requête. Indiquez-le lorsque vous contactez le
            support.
        field:
          type: string
          description: >-
            Le champ de la requête à corriger, lorsque l'erreur concerne un seul
            champ. Sinon `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: >-
            La prochaine étape à suivre, pour qu'un client puisse agir sans
            deviner. `null` lorsqu'il n'existe pas d'étape suivante standard.
          nullable: true
        retry_after:
          type: integer
          description: >-
            Secondes à attendre avant de réessayer. Défini pour les erreurs de
            limite de débit et les erreurs temporaires, sinon `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: >-
        La raison pour laquelle un lien s'est terminé en `failed`. Rien n'a été
        publié ni facturé.
      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: >-
            Pourquoi le lien a échoué. Un lien en échec n'est pas une erreur
            HTTP : le lien est renvoyé avec `status: failed` et cet objet. Un
            lien de renouvellement dont la connexion a entre-temps changé
            renvoie `renewal_not_needed` ou `renewal_window_expired`.
        message:
          type: string
          description: Explication en langage clair pour un développeur.
        conflicts_with:
          type: array
          nullable: true
          items:
            type: string
            format: uuid
          description: >-
            Avec `duplicate_conflict` : les identifiants des connexions actives
            qui se chevauchent. Renouvelez l'une d'elles, ou créez à nouveau le
            lien avec `duplicates: allow`.
      required:
        - code
        - message
        - conflicts_with
    BankLinkQuote:
      type: object
      description: >-
        Le prix d'un lien, figé à sa création. Le montant facturé est celui du
        devis. Les lectures ne sont jamais facturées.
      properties:
        id:
          type: string
          description: Identifiant du devis.
          format: uuid
        lines:
          type: array
          items:
            $ref: '#/components/schemas/BankLinkQuoteLine'
          description: Les lignes facturées par ce lien, pour les périmètres demandés.
        fallback_lines:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/BankLinkQuoteLine'
          description: >-
            Coût d'un repli ponctuel, uniquement lorsque le lien a été créé avec
            `allow_one_time_fallback`. Il figure dans la réponse de création,
            sinon il vaut `null`. Une lecture ponctuelle avec données peut
            coûter plus cher qu'un premier mois d'accès continu.
        total_usd:
          type: string
          description: "Total des `lines` en USD. Le total ne peut que baisser\_: avec une autorisation réduite, ou lorsque la personne choisit un pays au tarif plus bas."
          pattern: ^-?\d+(\.\d+)?$
        valid_until:
          type: string
          description: >-
            Le devis est rattaché au lien, reste valide pendant toute sa durée
            de vie et est donc égal à `expires_at`.
          format: date-time
        scopes:
          type: array
          items:
            type: string
            enum:
              - accounts
              - balances
              - transactions
          description: >-
            Les données délimitent le périmètre sur lequel portent les prix du
            devis.
      required:
        - id
        - lines
        - fallback_lines
        - total_usd
        - valid_until
        - scopes
    RateLimitBudgetError:
      type: object
      description: >-
        Renvoyé uniquement pour un refus de quota du middleware lié à la limite
        de débit. Les autres erreurs 429, y compris les conflits d'idempotence
        et les plafonds propres à chaque endpoint, ne garantissent pas ces
        champs de métadonnées.
      required:
        - detail
        - reference
        - limit
        - remaining
        - reset
        - window_seconds
      properties:
        detail:
          type: string
          description: Message lisible de refus de budget existant.
        reference:
          type: string
          pattern: ^RL-[0-9a-f]{32}$
          description: "Référence de support opaque\_: RL- suivi de 32 caractères hexadécimaux minuscules d'un UUID."
        limit:
          type: integer
          description: Budget du périmètre dépassé ; égal à X-RateLimit-Limit.
        remaining:
          type: integer
          minimum: 0
          description: Budget restant, ramené à zéro ; égal à X-RateLimit-Remaining.
        reset:
          type: integer
          format: int64
          description: >-
            Heure de réinitialisation de la fenêtre en secondes Unix ; égale à
            X-RateLimit-Reset.
        window_seconds:
          type: integer
          description: >-
            Durée de la fenêtre fixe en secondes, et non le temps d'attente
            restant. Respectez Retry-After avant de réessayer.
      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: Une ligne chiffrée d'un devis.
      properties:
        meter:
          type: string
          description: >-
            Ce qui est facturé, par exemple `bank_data_connection_month`,
            `bank_verification`.
          example: bank_data_connection_month
        unit:
          type: string
          description: >-
            Ce que représente une unité, par exemple `connection_month` ou
            `completed_sign_in`.
          example: connection_month
        price_usd:
          type: string
          description: "Prix d'une unité en USD, sous forme de chaîne décimale à 4 décimales. Les montants des exemples sont indicatifs\_; le prix applicable à un pays figure sur la page Tarifs."
          pattern: ^-?\d+(\.\d+)?$
          example: '0.9000'
      required:
        - meter
        - unit
        - price_usd
  responses:
    Unauthorized:
      description: Non autorisé
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: Clé API invalide
              value:
                detail: Invalid API Key.
    RateLimitedWrite:
      description: >-
        La limite partagée d'écriture de 300 requêtes par minute et par clé API
        a été dépassée. Respectez `Retry-After` avant de réessayer.
      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: >-
        Un problème s’est produit côté Didit. Toute erreur inattendue sous
        `/v3/bank/` répond dans le format d’erreur Bank, jamais par une page
        HTML : indiquez `request_id` au support.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Internal error:
              summary: Une erreur inattendue
              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: >-
        Nombre de secondes à attendre, arrondi à la fenêtre suivante. Présent
        sur les refus liés au quota du middleware.
      schema:
        type: integer
    BudgetXRateLimitScope:
      description: >-
        Le périmètre dont le quota a été dépassé. Présent sur les refus liés au
        quota du middleware.
      schema:
        type: string
    BudgetXRateLimitLimit:
      description: >-
        Budget du périmètre dépassé ; égal à la limite du corps. Présent sur les
        refus de budget du middleware.
      schema:
        type: integer
    BudgetXRateLimitRemaining:
      description: >-
        Budget restant, ramené à zéro ; égal à remaining du corps. Présent lors
        des refus liés au budget du middleware.
      schema:
        type: integer
    BudgetXRateLimitReset:
      description: >-
        Heure de réinitialisation en secondes Unix ; égale à reset dans le
        corps. Présent sur les refus liés au quota du middleware.
      schema:
        type: integer
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: "La clé API de votre application, disponible dans Developers -> API keys de la Business Console. La clé principale a un accès complet. Une clé nommée peut être limitée :\_aucun accès, lecture ou écriture par ressource, restreinte à certains workflows ou à certaines sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée\_; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou à cette action, ou que la requête provient d'une adresse hors de sa liste d'adresses IP\_; 404 sur une route de session signifie que la session se trouve hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL des images, vidéos et PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys."

````

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