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

# Connexions bancaires : accès continu, consentement et renouvellement

> Une connexion est l'autorisation d'une personne de lire une banque avec Didit. Statuts, fin du consentement, renouvellement et révocation des accès.

Une connexion bancaire Didit est l'autorisation accordée par une personne ou une entreprise à votre application de lire les données d'une seule banque, avec ses dates de consentement, son état de synchronisation et ses comptes.
Un [Bank Link](https://docs.didit.me/fr/core-technology/bank-verification/bank-link.md) terminé la crée, et elle reste active aussi longtemps que la banque et la personne l'autorisent.

Les données bancaires sont disponibles pour les applications sandbox ; les appels d'une application en production renvoient `404` tant que l'accès en production n'a pas été annoncé.

## Accès ponctuel et accès continu

| | Ponctuel | Continu |
| - | - | - |
| `access` | `one_time` (par défaut) | `ongoing` |
| Déroulement | Les données sont lues une seule fois lorsque la personne se connecte, puis l'accès prend fin (`status_reason: collection_complete`). | L'accès reste ouvert jusqu'à la fin du consentement ou jusqu'à ce qu'il soit interrompu. |
| Données par la suite | Consultables via les mêmes endpoints. | Synchronisées automatiquement une à quatre fois par jour selon la banque, plus des synchronisations en direct à la demande. |
| Facturation | Par vérification, voir [tarifs](https://docs.didit.me/fr/getting-started/bank-verification-pricing.md) | Par connexion active et par mois, voir [tarifs](https://docs.didit.me/fr/getting-started/bank-verification-pricing.md) |

L'accès continu n'est disponible auprès d'une banque que si celle-ci l'autorise.
Interrogez le [endpoint des institutions](https://docs.didit.me/fr/standalone-apis/bank-institutions-list.md) ou consultez la [page de couverture](https://docs.didit.me/fr/core-technology/bank-verification/coverage.md).
Lorsqu'une banque ne peut pas maintenir l'accès ouvert, la personne est informée que cette banque n'autorise pas l'accès continu et doit choisir une autre banque.
Définissez `allow_one_time_fallback: true` pour permettre à la personne de poursuivre avec une lecture ponctuelle après avoir confirmé, sur son propre écran, l'accès réduit : la connexion est alors `one_time`.

## Statuts

| `status` | Signification | Données consultables | Synchronisations | Facturé |
| - | - | - | - | - |
| `pending` | La création du lien est terminée et la première synchronisation est en cours. | Pas encore | En cours | Non |
| `active` | Le consentement est valide et la synchronisation fonctionne normalement ou fait l’objet d’une nouvelle tentative. | Oui | Oui | Oui |
| `renewal_required` | Le consentement a pris fin, ou la banque demande à la personne de se reconnecter. `status_reason` indique la cause. | Telles que lors de la dernière synchronisation | Non | Non |
| `paused` | Le solde ne permet pas de couvrir le mois. | Telles que lors de la dernière synchronisation | Non | Non |
| `revoked` | L’accès a été interrompu par la personne, la banque ou vous. `consent.ended_by` indique qui. | Jusqu’à `consent.retain_until` | Non | Non |
| `deleted` | La connexion et ses données ont été supprimées. | Non | Non | Non |
| `failed` | La première synchronisation n’a jamais abouti. | Non | Non | Non |

`status_reason` prend l’une des valeurs suivantes : `collection_complete`, `consent_expired`, `consent_lapsed`, `bank_requires_sign_in`, `revoked_by_end_user`, `revoked_by_bank`, `revoked_by_customer`, `insufficient_balance`, `paused_by_customer` (réservée, aucun endpoint ne la définit actuellement) et `first_sync_failed`.

## Consentement

La banque fixe la fin du consentement, dans la limite du nombre de jours que vous avez demandé dans `consent_days`.
Chaque connexion affiche ses dates réelles dans `consent` :

* `expires_at` et `renew_by` : la fin du consentement. Renouvelez-le avant cette date pour éviter toute rupture.
* `renewable_until` : la dernière date à laquelle la même connexion peut être réactivée après la fin du consentement.
* `renewed_count`, `version`, `scopes_granted` et `accounts_granted` : ce qui a été accordé, et le nombre de fois où le consentement a été renouvelé.

Le consentement dure aussi longtemps que la banque l'autorise.
Consultez la valeur réelle sur chaque connexion, et la valeur propre à chaque banque sur l'établissement.

## Renouvellement

Un renouvellement conserve l'identifiant de la connexion et chaque identifiant de compte, et l'historique se poursuit sans doublons.

1. Didit envoie `bank.connection.consent_expiring` 14, 7 et 1 jour avant la fin.
2. Appelez [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/fr/standalone-apis/bank-connection-renew). Il répond `409 renewal_not_needed` tant qu'il reste plus de 30 jours, et `409 renewal_window_expired` après `consent.renewable_until`. Sinon, il répond `201` avec un lien de renouvellement.

La page sur laquelle la personne finalise un renouvellement n'est pas encore disponible. N'envoyez donc pas les personnes vers un lien de renouvellement pour le moment.

Si la personne laisse expirer son consentement, la connexion passe à `renewal_required` : les données restent consultables telles que synchronisées pour la dernière fois, et rien n'est facturé.
Après `consent.renewable_until`, elle passe à `revoked` avec `status_reason: consent_lapsed`, et la personne doit se reconnecter.

Pour le parcours complet, consultez [Renouveler un consentement bancaire](https://docs.didit.me/fr/use-cases/renew-bank-consent.md).

## Arrêter l'accès

| Qui | Comment | Ce qui se passe |
| - | - | - |
| La personne | **Arrêter le partage** auprès de sa banque | `bank.connection.revoked` avec `ended_by: end_user` ou `bank` |
| Vous | [`revoke_connection`](https://docs.didit.me/fr/standalone-apis/bank-connection-revoke) | La récupération des données par la banque s'arrête immédiatement. Le consentement passe à `revocation_pending`, puis à `revoked` lorsque la banque confirme. Les données déjà lues restent consultables jusqu'à ce que vous supprimiez la connexion ou jusqu'à l'expiration de `consent.retain_until`. |
| Vous | [`delete_connection`](https://docs.didit.me/fr/standalone-apis/bank-connection-delete) | Arrête l'accès et supprime la connexion ainsi que ses comptes, soldes et transactions. Action irréversible. |

Arrêter l'accès ne revient pas à supprimer.
Consultez [Données, consentement et suppression](https://docs.didit.me/fr/core-technology/bank-verification/data-consent-and-deletion.md) pour savoir exactement ce que la suppression efface.

## Connexion supprimée

Une connexion supprimée ne renvoie que `id`, `status` (`deleted`), `status_reason`, `created_at` et `erasure`.
`status_reason` vaut `deleted_by_customer`, `consent_lapsed`, `retention_elapsed` ou `application_deleted`.
Tous les autres champs sont absents.

## Doublons

Un nouveau lien qui correspond exactement aux comptes que vous partagez déjà avec le même `end_user.reference` auprès de la même banque est renouvelé (`reused: true`) et n'entraîne aucune double facturation.
Tout autre chevauchement fait passer le lien au statut `failed` avec `duplicate_conflict` et `conflicts_with`, avant que quoi que ce soit ne soit enregistré ou facturé.
Renouvelez la connexion existante, ou recréez le lien avec `"duplicates": "allow"` pour obtenir une seconde connexion indépendante.

## Gérer les connexions de vos clients

* Lister avec des filtres : [`GET /v3/bank/connections/`](https://docs.didit.me/fr/standalone-apis/bank-connections-list) accepte `status`, `access`, `institution_id`, `country`, `vendor_data`, `end_user_reference`, `consent_expires_before` et `created_after`.
* Consultez le coût d'une connexion grâce à son objet `billing` : l'unité, le prix et le mois déjà réglé.


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