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. Usebank.sync.completedapenas se quiser ver todas as sincronizações, incluindo as que não alteraram nada. - Onboarding. Aguarde por
bank.connection.createdantes de ler as contas, e porbank.connection.history_completeantes de depender do histórico completo. - Consentimento. Com
bank.connection.consent_expiring, peça à pessoa que renove o consentimento. Combank.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.completedouGET /v3/bank/links/{id}/, e não com um ID de ligação enviado por uma página.
Próximos passos
- Feed bancário contínuo para contabilidade
- Sandbox: o Didit Test Bank dispara estes eventos.