Pré-requisitos para configuração

Antes de realizar a configuração dos webhooks, é necessário que o parceiro crie pelo menos um endpoint para receber os eventos do Hiperbanco.

A URI desse endpoint deverá ser informada no momento do registro do webhook. O parceiro poderá criar apenas um endpoint para receber todos os eventos Hiperbanco ou optar por desenvolver um endpoint para cada tipo de evento. Nesse último caso, a cada novo registro de webhook, o parceiro informará uma URI diferente, correspondente ao endpoint que receberá o evento.

As mensagens que enviamos utilizam o método HTTP POST, portanto, não use outro método no endpoint de sua API.

Para sinalizar ao Hiperbanco que a mensagem foi recebida com sucesso pelo parceiro, seu endpoint deve responder com um status code entre 200 a 299. Respostas diferentes serão interpretadas como recebimento sem sucesso.

Em caso de insucesso, o sistema fará três novas tentativas de envio, num intervalo de dois, quatro e oito segundos entre cada tentativa.

Depois disso, cessaremos o envio de requisições, e o parceiro poderá utilizar nosso endpoint para nova tentativa.