Passer au contenu principal
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 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

L’accès continu n’est disponible auprès d’une banque que si celle-ci l’autorise. Interrogez le endpoint des institutions ou consultez la page de couverture. 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_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/. 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.

Arrêter l’accès

Arrêter l’accès ne revient pas à supprimer. Consultez Données, consentement et suppression 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/ 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é.
Dernière modification le 22 novembre 2026