Saltar para o conteúdo principal
Didit envia webhooks bancários quando uma ligação termina, quando uma conexão é alterada, quando o consentimento está prestes a expirar ou quando uma sincronização guarda novos dados. Usam o mesmo envelope, assinatura e novas tentativas que todos os outros webhooks da Didit, e transportam apenas identificadores e estados: para ler o objeto, é preciso obtê-lo.
Os eventos de webhook bancários são enviados para aplicações em ambiente de produção e em sandbox. Escolha os eventos por destino com o filtro de eventos do destino, tal como para os outros eventos. Consulte Webhooks para o envelope, os cabeçalhos de assinatura e as novas tentativas.

Eventos

Todos os eventos incluem também os campos comuns event_id, webhook_type, timestamp, created_at, application_id e environment. Os eventos bank.link.* incluem os respetivos campos em data; os eventos de ligação, de dados e de sincronização incluem-nos no nível superior. ended_by assume um dos valores end_user, bank, customer ou unknown. O esquema exato de cada evento está na Referência da API.

Exemplo

Como utilizá-los

  • Novos dados. bank.data.updated é apenas um sinal: nada é enviado. Chame o fluxo de alterações com o seu cursor guardado. Use bank.sync.completed apenas se quiser ver todas as sincronizações, incluindo as que não alteraram nada.
  • Onboarding. Aguarde por bank.connection.created antes de ler as contas, e por bank.connection.history_complete antes de depender do histórico completo.
  • Consentimento. Com bank.connection.consent_expiring, peça à pessoa que renove o consentimento. Com bank.connection.renewal_required, os dados continuam legíveis, mas deixam de ser sincronizados.
  • Parar. Com bank.connection.revoked, pare o seu próprio fluxo para essa ligação e decida se quer eliminar os dados guardados.
  • Duplicados. Trate cada evento de forma idempotente: use o ID do evento como chave e esteja preparado para receber o mesmo evento duas vezes, de vez em quando.
  • Nunca confie no navegador. Confirme uma ligação com bank.link.completed ou GET /v3/bank/links/{id}/, e não com um ID de ligação enviado por uma página.

Próximos passos

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