Passer au contenu principal
Didit envoie des webhooks bancaires lorsqu’un lien se termine, qu’une connexion change, que le consentement est sur le point de prendre fin ou qu’une synchronisation enregistre de nouvelles données. Ils utilisent la même enveloppe, les mêmes mécanismes de signature et les mêmes nouvelles tentatives que tous les autres webhooks Didit, et ne transmettent que des identifiants et des statuts : vous récupérez l’objet pour en lire le contenu.
Les événements webhook bancaires sont envoyés pour les applications en production et les applications sandbox. Choisissez les événements par destination avec le filtre d’événements de la destination, comme pour les autres événements. Consultez Webhooks pour l’enveloppe, les en-têtes de signature et les nouvelles tentatives.

Événements

Chaque événement contient aussi les champs communs event_id, webhook_type, timestamp, created_at, application_id et environment. Les champs des événements bank.link.* figurent sous data, ceux des événements de connexion, de données et de synchronisation figurent au niveau supérieur. ended_by vaut end_user, bank, customer ou unknown. Le schéma exact de chaque événement figure dans la Référence API.

Exemple

Comment les utiliser

  • Nouvelles données. bank.data.updated est un simple signal : aucune donnée n’est transmise. Appelez le flux de modifications avec votre curseur enregistré. N’utilisez bank.sync.completed que si vous souhaitez voir chaque synchronisation, y compris celles qui n’ont rien modifié.
  • Onboarding. Attendez bank.connection.created avant de lire les comptes, et bank.connection.history_complete avant de vous appuyer sur l’historique complet.
  • Consentement. À la réception de bank.connection.consent_expiring, demandez à la personne de renouveler son consentement. À la réception de bank.connection.renewal_required, les données restent lisibles mais ne sont plus synchronisées.
  • Arrêt. À la réception de bank.connection.revoked, arrêtez votre propre flux pour cette connexion et décidez s’il faut supprimer les données enregistrées.
  • Doublons. Traitez chaque événement de manière idempotente : utilisez l’identifiant de l’événement comme clé, et attendez-vous à recevoir parfois le même événement deux fois.
  • Ne faites jamais confiance au navigateur. Confirmez un lien avec bank.link.completed ou GET /v3/bank/links/{id}/, et non avec un identifiant de lien envoyé par une page.

Prochaines étapes

Dernière modification le 22 novembre 2026