Pular para o conteúdo principal
Didit envia webhooks bancários quando um link é encerrado, uma conexão muda, o consentimento está prestes a expirar ou uma sincronização armazena novos dados. Eles usam o mesmo envelope, a mesma assinatura e as mesmas tentativas de reenvio de todos os outros webhooks da Didit, e trazem apenas IDs e status: para ler o objeto, você precisa buscá-lo.
Os eventos de webhook bancário são enviados para aplicações de produção e sandbox. Escolha os eventos por destino, com o filtro de eventos do destino, como para os demais eventos. Consulte Webhooks para o envelope, os cabeçalhos de assinatura e as tentativas de reenvio.

Eventos

Todos os eventos também trazem os campos comuns event_id, webhook_type, timestamp, created_at, application_id e environment. Os eventos bank.link.* trazem seus campos dentro de data; os eventos de conexão, dados e sincronização trazem os seus no nível superior. ended_by pode ser end_user, bank, customer ou unknown. O esquema exato de cada evento está na Referência da API.

Exemplo

Como usar os eventos

  • Dados novos. bank.data.updated é apenas um sinal: nada é enviado. Chame o feed de alterações com o cursor armazenado. Use bank.sync.completed apenas se quiser ver todas as sincronizações, inclusive as que não alteraram nada.
  • Onboarding. Aguarde bank.connection.created antes de ler as contas, e bank.connection.history_complete antes de depender do histórico completo.
  • Consentimento. Ao receber bank.connection.consent_expiring, peça à pessoa que renove o consentimento. Ao receber bank.connection.renewal_required, os dados ainda podem ser lidos, mas não são mais sincronizados.
  • Encerramento. Ao receber bank.connection.revoked, interrompa o seu próprio feed para essa conexão e decida se deseja excluir os dados armazenados.
  • Duplicatas. Trate todo evento de forma idempotente: use o id do evento como chave e esteja preparado para receber o mesmo evento duas vezes de tempos em tempos.
  • Nunca confie no navegador. Confirme um link com bank.link.completed ou GET /v3/bank/links/{id}/, e não com um id de link enviado por uma página.

Próximos passos

Última modificação em 22 de novembro de 2026