Sync Now de Didit consulta al banco los datos más recientes de una conexión en cualquier momento, con una sola llamada.
Las sincronizaciones en vivo están incluidas en el precio mensual de la conexión: no se cobra nada adicional.
El único límite es el del banco.
Sincronización automática
- La primera sincronización se ejecuta cuando la persona se conecta.
- Después, cada conexión activa continua se sincroniza automáticamente entre una y cuatro veces al día, según el banco.
sync.frequency_per_day en la conexión indica cuántas, y sync.next_sync_at indica cuándo está prevista la siguiente.
- Cuando el banco permite más lecturas automáticas al día, siempre quedan al menos dos disponibles para las sincronizaciones en vivo.
- Cuando una sincronización almacena cambios, llega
bank.data.updated y puedes leer el feed de cambios con tu cursor.
- Una sincronización fallida se reintenta con espera progresiva. Tras 24 horas de fallos, la conexión sigue
active con sync.status: failing y se envía bank.sync.failed. Cuando vuelve a funcionar, se envía bank.sync.recovered.
- Cuando el banco pide a la persona que vuelva a iniciar sesión, la conexión pasa a
renewal_required.
Sincroniza ahora, en una sola llamada
Añade "wait": true y una solicitud devuelve datos actualizados:
El encabezado Prefer: wait=25 hace lo mismo. La llamada espera hasta 25 segundos:
Si ya hay una sincronización en curso, recibes ese mismo sync_id, no un segundo trabajo.
Tras un 200 o un bank.data.updated, lee el feed de cambios con tu cursor guardado.
Consulta después lo que hizo una sincronización con get_sync_run.
El precio
Las sincronizaciones automáticas y las sincronizaciones en vivo están incluidas en el precio mensual de la conexión, consulta precios.
Una sincronización en vivo nunca añade ningún cargo.
El límite diario del banco
Un banco limita con qué frecuencia se pueden obtener datos sin la presencia de la persona. Las normas europeas permiten a un banco limitar a cuatro lecturas al día por cuenta el acceso sin que la persona esté presente. Es un techo, no una garantía: un banco puede permitir menos o aceptar más.
- Las sincronizaciones automáticas y en tiempo real comparten un mismo presupuesto, y la programación automática nunca usa las dos últimas lecturas del día.
sync.live_syncs_left_today en la conexión indica cuántas sincronizaciones en tiempo real quedan hoy, y sync.budgets[] muestra cada bloque: scope (connection o account), resource, limit, remaining y resets_at.
- Mientras la persona está presente en Bank Link, para una renovación o una reconexión, las lecturas no tienen límite.
- Cuando se agota el presupuesto del día, la llamada responde
429 refresh_limit_reached con un encabezado Retry-After (los segundos que faltan hasta que el presupuesto se restablezca) y un objeto sync con live_syncs_left_today y budgets. Espera ese tiempo y confía en la sincronización automática mientras tanto.
- Tus límites de API son independientes: 600 lecturas y 300 escrituras por minuto por aplicación, con encabezados
X-RateLimit-*.
Qué tan actualizados están los datos
sync.last_synced_at en la conexión y en cada cuenta indica cuándo Didit consultó por última vez al banco, no cuándo leíste los datos por última vez.
- Ambas lecturas de transacciones devuelven
X-Bank-Last-Synced-At.
Errores que debes manejar
Relacionados
Última modificación el 22 de noviembre de 2026