O Sync Now lê os dados mais recentes de uma conexão no banco a qualquer momento, com uma única chamada.
As sincronizações em tempo real estão incluídas no preço mensal da conexão: nenhum valor extra é cobrado.
O único limite é o do banco.
A sincronização automática
- A primeira sincronização é executada quando a pessoa se conecta.
- Depois disso, cada conexão ativa e contínua é sincronizada automaticamente entre uma e quatro vezes por dia, dependendo do banco.
sync.frequency_per_day na conexão indica quantas, e sync.next_sync_at indica quando a próxima está prevista.
- Quando o banco permite mais leituras sem intervenção por dia, sempre restam pelo menos duas por dia para sincronizações ao vivo.
- Quando uma sincronização armazena alterações,
bank.data.updated é enviado e você lê o feed de alterações usando seu cursor.
- Uma sincronização que falha é tentada novamente com backoff. Após 24 horas de falhas, a conexão permanece
active com sync.status: failing, e bank.sync.failed é enviado. bank.sync.recovered é enviado quando ela volta a funcionar.
- Quando o banco pede que a pessoa entre novamente, a conexão passa para
renewal_required.
Sincronizar agora, em uma chamada
Adicione "wait": true e uma única requisição retorna dados atualizados:
O cabeçalho Prefer: wait=25 faz o mesmo.
A chamada aguarda por até 25 segundos:
Se uma sincronização já estiver em andamento, você recebe o mesmo sync_id, e não uma segunda tarefa.
Depois de um 200 ou de um bank.data.updated, leia o feed de alterações com o cursor que você armazenou.
Leia depois o que uma sincronização fez com get_sync_run.
Preço
As sincronizações automáticas e as sincronizações ao vivo estão incluídas no preço mensal da conexão. Veja preços.
Uma sincronização ao vivo nunca gera cobrança extra.
O limite diário do banco
Um banco limita a frequência com que os dados podem ser buscados sem a presença da pessoa.
As regras europeias permitem que um banco limite o acesso sem supervisão a quatro leituras por dia por conta.
Esse é um teto, não uma promessa: um banco pode permitir menos ou aceitar mais.
- As sincronizações automáticas e ao vivo compartilham a mesma cota, e a programação automática nunca usa as últimas duas leituras do dia.
sync.live_syncs_left_today na conexão indica quantas sincronizações ao vivo restam hoje, e sync.budgets[] mostra cada cota: scope (connection ou account), resource, limit, remaining e resets_at.
- Enquanto a pessoa estiver presente no Bank Link, para uma renovação ou uma reconexão, as leituras não são limitadas.
- Quando a cota do dia se esgota, a chamada responde
429 refresh_limit_reached com um cabeçalho Retry-After (os segundos até a cota ser reiniciada) e um objeto sync com live_syncs_left_today e budgets. Aguarde esse tempo e, nesse meio-tempo, conte com a sincronização automática.
- Os limites da sua API são separados: 600 leituras e 300 gravações por minuto por aplicação, com cabeçalhos
X-RateLimit-*.
Saiba o quão atualizados estão os dados
sync.last_synced_at na conexão e em cada conta indica quando a Didit buscou dados pela última vez no banco, e não quando você os leu pela última vez.
- As duas leituras de transações retornam
X-Bank-Last-Synced-At.
Erros que você deve tratar
Relacionados
Última modificação em 22 de novembro de 2026