Un flux bancaire continu fournit à un produit de comptabilité ou de tenue de comptes les soldes et les transactions des comptes bancaires de chaque client, chaque jour, sans que le client ait besoin de se reconnecter.
Avec Didit, vous créez un lien à accès continu, recevez des webhooks à l’arrivée de nouvelles données, ne lisez que ce qui a changé grâce à un curseur, surveillez l’échéance du consentement, et arrêtez ou supprimez l’accès lorsque le client quitte la plateforme.
Ce guide vous accompagne de zéro jusqu’à un flux quotidien pour un client.
Le même code s’exécute pour chaque client : une connexion par client et par banque.
Ce dont vous avez besoin
- Une clé API avec l’autorisation d’accès aux données bancaires, pour votre application sandbox. Consultez le démarrage rapide.
- Une destination de webhook qui reçoit les événements
bank.*. Consultez Webhooks bancaires.
- Une table dans votre base de données pour l’identifiant de connexion de chaque client, le curseur du flux de modifications et la fin du consentement.
Étape 1 : créer un lien à accès continu
access: ongoing maintient l’accès ouvert jusqu’à la fin du consentement. consent_days est une demande : la banque détermine la date réelle, affichée sur la connexion.
history_from demande l’historique à partir d’une date, par exemple le début de l’année. Utilisez plutôt history_days (de 1 à 365) si vous le préférez, mais jamais les deux. La banque peut fournir moins : chaque compte indique son history_coverage.
ownership.compare: none ignore la comparaison du titulaire, donc aucune identité de référence n’est nécessaire. Utilisez business pour comparer le titulaire avec une entreprise vérifiée dans Didit.
end_user.reference est votre identifiant du client. Il est consultable et permet à Didit de reconnaître le même client lorsqu’il connecte à nouveau les mêmes comptes.
- Envoyez le client vers la page de vérification hébergée et renvoyez-le vers votre produit avec une URL de redirection.
Stockez l’id du lien avec le client.
Étape 2 : attendre la connexion
Lorsque le client a terminé, bank.link.completed arrive avec le connection_id.
Confirmez-le, car le navigateur n’est jamais considéré comme fiable :
Enregistrez le connection_id et attendez bank.connection.created : les comptes, les soldes et les transactions récentes sont alors consultables (sync.initial_status vaut succeeded ou partial).
bank.connection.history_complete arrive lorsque la reprise de l’historique se termine.
Pour chaque compte, history_coverage.oldest_booking_date indique jusqu’à quelle date la banque a réellement fourni l’historique.
Étape 3 : charger la première copie
Un curseur vide renvoie toutes les transactions actuelles comme added avec reset: true.
Parcourez-les page par page et ne stockez le curseur qu’à la fin :
- La première lecture est un véritable instantané : elle renvoie chaque transaction que la connexion contenait au début de la lecture, chacune une seule fois avec
added, dans son état actuel, même si une synchronisation s’exécute pendant que vous parcourez les pages.
- Les modifications effectuées pendant la pagination arrivent dans la lecture suivante, à partir de
next_cursor : une transaction déjà reçue revient avec modified, et une nouvelle avec added.
- Stockez
next_cursor uniquement après une réponse avec has_more: false.
- Si la pagination échoue en cours de route, reprenez à partir du curseur que vous avez stocké.
- Lisez les soldes avec
GET /v3/bank/accounts/{account_id}/balances/.
Étape 4 : rester à jour à chaque webhook
Didit synchronise automatiquement chaque connexion active avec accès continu, une à quatre fois par jour selon la banque (sync.frequency_per_day).
Lorsqu’une synchronisation enregistre des modifications, bank.data.updated arrive avec le connection_id, les account_ids et les décomptes.
Appelez le flux de modifications avec le curseur que vous avez stocké :
added : nouvelles transactions, y compris celles en attente.
modified : transactions modifiées, dans leur état actuel. Appliquez chacune comme un upsert par id : une transaction que vous possédez déjà est mise à jour, et une transaction que vous ne possédez pas encore est ajoutée.
- Les éléments
removed contiennent un reason. Ignorez un id que vous ne possédez pas. Lorsqu’une transaction en attente est comptabilisée, elle figure dans removed avec pending_booked, et la transaction comptabilisée arrive dans added.
Utilisez l’id de la transaction comme clé : il reste identique d’une lecture à l’autre, d’une synchronisation à l’autre et après les renouvellements.
Vérifiez identity_quality : avec derived, une correction bancaire peut apparaître sous la forme d’un removed et d’un added.
Les lectures ne sont jamais facturées, mais les données ne changent que lorsqu’une synchronisation s’exécute ; une seule lecture par webhook suffit donc.
Pour obtenir les données plus tôt, utilisez Sync Now : Actualiser les données bancaires à la demande.
Étape 5: gérer la réinitialisation
Un curseur plus ancien que la fenêtre de rejeu renvoie 410 cursor_expired avec bootstrap: true.
Le journal des modifications est rejouable pendant 90 jours ; cette situation est donc rare pour une tâche quotidienne.
Recommencez à partir d’un curseur vide, et remplacez votre copie par le résultat au lieu de l’ajouter à la copie existante.
Chaque lecture depuis un curseur vide porte reset: true, de sorte que le même chemin de code gère une nouvelle connexion et un curseur expiré.
Étape 6 : surveiller la fin du consentement
Le consentement a une date de fin : consent.expires_at.
Didit envoie bank.connection.consent_expiring 14, 7 et 1 jour avant cette date.
Appelez renew_connection lorsque vous souhaitez renouveler le consentement : l’appel renvoie 409 renewal_not_needed jusqu’à ce qu’il reste 30 jours.
La page sur laquelle le client finalise un renouvellement n’est pas encore disponible.
Si le client laisse le consentement expirer, la connexion passe en renewal_required : vous pouvez toujours lire les données synchronisées.
Les détails figurent dans Renouveler un consentement bancaire.
Étape 7 : arrêter l’accès et supprimer
- Le client quitte votre produit : appelez
revoke_connection pour arrêter la lecture immédiatement, ou delete_connection pour arrêter et supprimer les données stockées.
- Le client cesse de partager ses données auprès de la banque :
bank.connection.revoked est envoyé avec ended_by. Arrêtez votre flux pour cette connexion.
Prix
L’accès continu est facturé par connexion active et par mois.
Le prix comprend tous les comptes de la connexion, les soldes, les transactions, jusqu’à 365 jours d’historique lorsque la banque le fournit, les synchronisations automatiques, les synchronisations en direct dans les limites de la banque, les renouvellements, les webhooks et toutes les lectures.
Un lien que personne ne mène à terme est gratuit, de même que les connexions renewal_required, paused et revoked.
Voir tarifs.
Liste de contrôle
Dernière modification le 22 novembre 2026