Como utilizar Webhooks no Stark Bank?
Entenda como utilizar webhooks para receber notificações das operações do Stark Bank.
Atualizado
Isto foi útil?
⌘Ctrlk
Entenda como utilizar webhooks para receber notificações das operações do Stark Bank.
Após a configuração das inscrições de Webhook no Stark Bank, sua aplicação estará pronta para receber notificações automáticas sobre eventos e logs gerados no sistema. Para garantir a resiliência e a segurança da sua integração, é fundamental seguir as boas práticas de gestão de eventos detalhadas abaixo:
Os eventos de Webhooks devem ser acompanhados via API, não há telas de acompanhamento pelo Internet Banking. Para mais informações de como ver esses eventos, leia a documentação de nossas APIs: https://starkbank.com/docs/api#webhook e https://starkbank.com/docs/api#event.
Sempre que um evento for enviado ao seu servidor, o Stark Bank espera um código de status HTTP 200 como confirmação de recebimento.
Falha na entrega: Caso o status 200 não seja retornado, o serviço realizará 3 tentativas automáticas nos seguintes intervalos: 5 minutos, 30 minutos e 120 minutos após a primeira tentativa.
Recomendamos a criação de uma rotina diária para consultar eventos que permaneçam com o status "não entregue" em seu controle, permitindo a regularização manual se necessário.
O Stark Bank prioriza a performance na entrega das notificações. Por esse motivo, não há garantia de que os eventos cheguem na ordem cronológica em 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).
Em cenários específicos de rede ou reprocessamento, seu endpoint pode receber o mesmo evento mais de uma vez.
Idempotência: Proteja sua integração registrando os IDs dos eventos já processados em seu banco de dados. Caso receba um ID já conhecido, ignore o processamento para evitar duplicidade de ações (como créditos ou baixas duplicadas).
Para garantir a estabilidade da comunicação, seu endpoint deve ser extremamente ágil.
Receba a requisição HTTP do Stark Bank.
Salve o evento em sua base de dados.
Retorne imediatamente o status 200.
Processamento: Qualquer lógica de negócio complexa ou processamento de dados deve ocorrer de forma assíncrona, após o envio da resposta de sucesso ao Stark Bank.
A utilização correta de Webhooks permite que sua operação ganhe escala e automação com a segurança tecnológica que o mercado financeiro exige. Caso tenha dúvidas, contate nosso time de suporte.
Atualizado
Isto foi útil?
Isto foi útil?