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

# Actualiser les données bancaires à la demande avec Sync Now

> Actualisez à tout moment les données bancaires d'une connexion avec Didit, en un appel. Limite quotidienne et réponse 429 expliquées.

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

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{ "wait": true }'
```

L'en-tête `Prefer: wait=25` produit le même effet.
L'appel attend jusqu'à 25 secondes :

| Réponse | Signification |
| - | - |
| `200` | La synchronisation est terminée. Le corps contient la synchronisation avec son `outcome`, le nombre de `added`, `modified` et `removed` par compte, ainsi que `balances_changed`. |
| `202` | La banque n'a pas répondu en 25 secondes, ou vous n'avez pas demandé d'attendre. Le corps contient le `sync_id` : lisez la synchronisation avec `get_sync_run`, ou abonnez-vous à `bank.sync.completed`. `bank.data.updated` n'est envoyé que si la synchronisation enregistre des modifications. |

```json theme={null}
{
  "id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
  "trigger": "requested",
  "status": "succeeded",
  "outcome": "succeeded",
  "balances_changed": true,
  "results": [{ "resource": "transactions", "outcome": "succeeded", "added": 3, "modified": 0, "removed": 1 }]
}
```

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`](https://docs.didit.me/fr/standalone-apis/bank-sync-run-get).

## Le prix

Les synchronisations automatiques et les synchronisations en direct sont incluses dans le prix mensuel de la connexion, voir [tarifs](https://docs.didit.me/fr/getting-started/bank-verification-pricing.md).
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

| Erreur | Signification | Que faire |
| - | - | - |
| `429 refresh_limit_reached` | Le budget de la banque est épuisé. | Attendez `Retry-After`, et comptez sur la synchronisation automatique. |
| `409 connection_not_active` | La connexion n'est pas `active`. | Vérifiez son statut. |
| `409 consent_expired` | Le consentement a expiré. | [Renouvelez-le](https://docs.didit.me/fr/use-cases/renew-bank-consent.md). |

## Liens connexes

* [Flux bancaire continu pour la comptabilité](https://docs.didit.me/fr/use-cases/bank-data-for-accounting.md)
* [Webhooks bancaires](https://docs.didit.me/fr/core-technology/bank-verification/webhooks.md)


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