Webhooks são uma forma simples para que duas aplicações troquem notificações quando algum evento ocorre. Também são recorrentemente chamados de API callback ou notificações. Na Grafeno, utilizamos Webhooks para enviar eventos tais quais atualizações de status de cobranças, boletos, pagamentos, protestos e transferências.

Para receber essas notificações de eventos, é necessário configurar as URLs para onde deveremos encaminhar os payloads a cada atualização. Após isso, o endereço que foi cadastrado deve ser configurado para receber e tratar os dados. Na seção de Webhooks da nossa referência de API, disponibilizamos exemplos dos payloads para cada evento enviado. Assim, é possível ver quais informações enviamos nos webhooks para que o ambiente seja preparado corretamente para o recebimento.

Configurando as URLs

Se você já possui conta e deseja configurar uma URL para recebimento de Webhooks, solicite o cadastro ou edição dos endereços pelo [email protected] informando o ambiente, número da conta e quais urls você deseja cadastrar para cada tipo de evento. Com essas informações, faremos o ajuste no nosso sistema para que os payloads comecem a ser enviados.