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