Webhooks - Sacado



Para que os eventos ocorridos com o seu perfil (ex.: títulos que foram antecipados) sejam informados há você, existem Webhooks que são chamados no momento em que tais eventos ocorrem.

Quando um evento acontece, o sistema envia uma requisição HTTP POST para todos os webhooks configurados contendo as informações relativas ao evento e links HATEOAS que auxiliam na navegação da sua API pelos outros recursos que se relacionam com o tipo de evento.

Nossos webhooks contam com um mecanismo de retry, portanto retentamos durante duas horas ou até recebermos o HTTP status 200 OK

Você pode definifir um header, um tipo de token e o valor desse token para a autenticação. Ex:

Authorization: Bearer 6062949f-d17e-4e4d-b359-b3926544e2cc

Configuração de Webhook

Para receber estas requisições, você deve configurar um webhook, para isso consulte a documentação de api de sacado.

Eventos

Evento Tipo (Cadastro) Tipo (Busca) Descrição
Título negociado CUSTODY_RESPONSE_GROUPED CustodyResponseEvent Dispara uma requisição para /payables-response com dados dos títulos que foram comprados ou recusados pelo investidor.
Boleto Gerado BILL_GENERATED BillGeneratedEvent Dispara uma requisição para /bill com os dados do boleto (Linha Digitável e URL), esse evento não indica que o boleto já foi aceito.
Boleto Registrado BILL_REGISTERED BillRegisteredEvent Dispara uma requisição para /bill com os dados do boleto (Linha Digitável e URL), quando é registrado no DDA.