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.updatedest un simple signal : aucune donnée n’est transmise. Appelez le flux de modifications avec votre curseur enregistré. N’utilisezbank.sync.completedque si vous souhaitez voir chaque synchronisation, y compris celles qui n’ont rien modifié. - Onboarding. Attendez
bank.connection.createdavant de lire les comptes, etbank.connection.history_completeavant 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 debank.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.completedouGET /v3/bank/links/{id}/, et non avec un identifiant de lien envoyé par une page.
Prochaines étapes
- Flux bancaire continu pour la comptabilité
- Sandbox : la Didit Test Bank déclenche ces événements.