Passer au contenu principal
Sync Now de Didit lit à tout moment les dernières données de la banque pour une connexion, en un seul appel. Les synchronisations en direct sont incluses dans le prix mensuel de la connexion : rien de supplémentaire n’est facturé. La seule limite est celle de la banque.

La synchronisation automatique

  • La première synchronisation s’exécute lorsque la personne se connecte.
  • Ensuite, chaque connexion active et persistante se synchronise automatiquement entre une et quatre fois par jour, selon la banque. sync.frequency_per_day sur la connexion indique le nombre de synchronisations, et sync.next_sync_at indique la date de la prochaine.
  • Lorsque la banque autorise davantage de lectures sans intervention de l’utilisateur dans la journée, au moins deux par jour restent toujours réservées aux synchronisations en direct.
  • Lorsqu’une synchronisation enregistre des modifications, bank.data.updated est envoyé et vous lisez le flux des modifications avec votre curseur.
  • Une synchronisation qui échoue est réessayée avec une temporisation progressive. Après 24 heures d’échecs, la connexion reste active avec sync.status: failing, et bank.sync.failed est envoyé. bank.sync.recovered est envoyé ensuite, lorsqu’elle fonctionne de nouveau.
  • Lorsque la banque demande à la personne de se reconnecter, la connexion passe à renewal_required.

Synchroniser maintenant, en un seul appel

Ajoutez "wait": true et une seule requête renvoie des données à jour :
L’en-tête Prefer: wait=25 produit le même effet. L’appel attend jusqu’à 25 secondes :
Si une synchronisation est déjà en cours, vous recevez ce même sync_id, et non une seconde tâche. Après un 200 ou un bank.data.updated, lisez le flux des modifications avec le curseur que vous avez enregistré. Pour consulter plus tard ce qu’a fait une synchronisation, utilisez get_sync_run.

Le prix

Les synchronisations automatiques et les synchronisations en direct sont incluses dans le prix mensuel de la connexion, voir tarifs. Une synchronisation en direct n’ajoute jamais de frais.

La limite quotidienne de la banque

La réglementation européenne autorise une banque à limiter l’accès aux données lorsque la personne n’est pas présente : quatre lectures par jour et par compte. Il s’agit d’un plafond, non d’une garantie : une banque peut en autoriser moins, ou accepter davantage.
  • Les synchronisations automatiques et en direct partagent un même budget, et la synchronisation automatique n’utilise jamais les deux dernières lectures de la journée.
  • sync.live_syncs_left_today sur la connexion indique combien de synchronisations en direct restent pour aujourd’hui, et sync.budgets[] présente chaque enveloppe : scope (connection ou account), resource, limit, remaining et resets_at.
  • Pendant que la personne est présente dans Bank Link, pour un renouvellement ou une reconnexion, les lectures ne sont pas limitées.
  • Lorsque le budget de la journée est épuisé, l’appel renvoie 429 refresh_limit_reached avec un en-tête Retry-After (le nombre de secondes avant la réinitialisation du budget) et un objet sync contenant live_syncs_left_today et budgets. Attendez ce délai et comptez sur la synchronisation automatique en attendant.
  • Vos limites d’API sont distinctes : 600 lectures et 300 écritures par minute et par application, avec les en-têtes X-RateLimit-*.

Fraîcheur des données

  • sync.last_synced_at sur la connexion et sur chaque compte correspond à la date de la dernière récupération des données auprès de la banque par Didit, et non à la date à laquelle vous les avez lues pour la dernière fois.
  • Les deux requêtes de lecture des transactions renvoient X-Bank-Last-Synced-At.

Erreurs à gérer

Liens connexes

Dernière modification le 22 novembre 2026