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

# Webhooks bancaires : événements link, connection et données

> Découvrez quand Didit envoie les webhooks bank.link, bank.connection, bank.data et bank.sync, leur contenu et leur usage pour la lecture quotidienne.

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.

> [!NOTE]
>
> 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](https://docs.didit.me/fr/integration/webhooks.md) pour l'enveloppe, les en-têtes de signature et les nouvelles tentatives.

## Événements

| Événement | Quand | Champs |
| - | - | - |
| `bank.link.completed` | Une personne a connecté une banque. | `data.link_id`, `data.status`, `data.connection_id`, `data.check_id`, `data.error_code` (toujours `null`) |
| `bank.link.cancelled` | La personne a annulé. | `data.link_id`, `data.status` |
| `bank.link.expired` | Le lien a expiré avant d'être finalisé. | `data.link_id`, `data.status` |
| `bank.link.failed` | Le lien s'est terminé par une erreur. | `data.link_id`, `data.status`, `data.error_code` |
| `bank.connection.created` | La première synchronisation est terminée et les comptes sont accessibles. | `connection_id`, `initial_status` |
| `bank.connection.history_complete` | La reprise de l'historique est terminée, quelle qu'en soit la raison. | `connection_id`, `status` |
| `bank.connection.updated` | Le statut, le consentement ou l'état de la synchronisation a changé. | `connection_id`, `status`, `revocation_status` |
| `bank.connection.consent_expiring` | 14, 7 et 1 jour avant la fin du consentement. | `connection_id`, `days_left`, `consent_expires_at`, `renew_by` |
| `bank.connection.renewal_required` | Le consentement a pris fin, ou la banque demande à la personne de se reconnecter. | `connection_id`, `status`, `reason`, `renew_by`, `renewable_until` |
| `bank.connection.renewed` | Un lien de renouvellement a été finalisé. | `connection_id`, `status`, `consent_version`, `link_id`, `consent_expires_at` |
| `bank.connection.revoked` | L'accès a pris fin. | `connection_id`, `status`, `ended_by`, `status_reason`, `ended_at`, `retain_until` |
| `bank.connection.deleted` | La connexion et ses données ont été supprimées. | `connection_id`, `status`, `erasure_status`, `reason`, `erased_at` |
| `bank.data.updated` | Une synchronisation a enregistré des modifications. | `connection_id`, `sync_id`, `trigger`, `accounts` (identifiants avec leurs nombres), `balances_changed` |
| `bank.sync.completed` | Toutes les synchronisations sont terminées. | `connection_id`, `sync_id`, `trigger`, `outcome`, `changed` |
| `bank.sync.failed` | Une synchronisation continue d'échouer. | `connection_id`, `sync_id`, `error_code`, `failing_since` |
| `bank.sync.recovered` | Une synchronisation qui échouait fonctionne à nouveau. | `connection_id`, `sync_id` |

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](https://docs.didit.me/fr/standalone-apis/bank-data.md).

## Exemple

```json theme={null}
{
  "event_id": "7c1e0a52-93d4-4a6b-8f21-0d5b9e3a64c7",
  "webhook_type": "bank.sync.completed",
  "timestamp": 1763804640,
  "created_at": 1763804640,
  "application_id": "b3e1f0a2-5d64-4c8e-9a17-2f6d0c8b7e41",
  "environment": "sandbox",
  "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6",
  "sync_id": "c2b8d4f6-9a13-4e07-85bc-3d6e1f0a7b92",
  "trigger": "scheduled",
  "outcome": "succeeded",
  "changed": true
}
```

## Comment les utiliser

* **Nouvelles données.** `bank.data.updated` est un simple signal : aucune donnée n'est transmise. Appelez le [flux de modifications](https://docs.didit.me/fr/standalone-apis/bank-transactions-sync.md) 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](https://docs.didit.me/fr/standalone-apis/bank-connection-delete.md) 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

* [Flux bancaire continu pour la comptabilité](https://docs.didit.me/fr/use-cases/bank-data-for-accounting.md)
* [Sandbox](https://docs.didit.me/fr/core-technology/bank-verification/sandbox.md) : la Didit Test Bank déclenche ces événements.


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