Como utilizar Webhooks no Stark Bank?

Após a criação de Webhooks no Stark Bank, você estará apto a receber eventos através das inscrições cadastradas. Os eventos representam a criação de um log e são enviados nos endpoints cadastrados. É essencial se atentar às boas práticas de gestão de eventos:

Comportamento de novas tentativas

Todas vez que um evento é enviado através de webhook, é esperado que você retorne um código de status 200 para nossa requisição HTTP ao seu servidor para confirmar o recebimento do evento. Caso não seja respondido, o serviço de webhook do Stark Bank irá realizar 3 novas tentativas de notificação, a primeira no intervalo de 5 minutos, a segunda no intervalo de 30 minutos e a última no intervalo de 120 minutos. Nós recomendamos que você crie uma rotina de consulta diária de eventos não entregues e altere seus status para "entregue"

Ordenamento de eventos

O Stark Bank de propõe a entregar os eventos de forma mais performática possível. Assim, não garantimos que os eventos entregues via Webhook irão chegar na mesma ordem que foram gerados.

Por exemplo, seria esperado que uma operação de invoice teria os eventos que acontecem nessa ordem:

invoice.created
invoice.paid
invoice.credited

Mas na entrega do Webhook, eles podem ser entregues nessa ordem:

invoice.created
invoice.credited
invoice.paid

Dessa forma, os eventos podem com frequência ser entregues em ordem aleatória. Caso precise, sempre é possível realizar consultas utilizando o identificador da operação (por exemplo, você pode consultar todos os logs relacionados à uma invoice através do seu identificador com os respectivos horários de criação).

Gestão de eventos duplicados

Ocasionalmente, os endpoints cadastrados podem receber o mesmo evento mais de uma vez. Proteja sua integração de processar eventos duplicados realizando o registros dos identificadores de evento como ferramenta de idempotência e não processando eventos previamente registrados.

Velocidade de resposta no recebimento de evento

Assim que receber nosso evento em seu endpoint, você deve salvar o evento e retornar código de status de sucesso (200) ao nossa requisição HTTP. Qualquer lógica de processamento desse evento deve ser feita após confirmar o recebimento do evento.