O que é um webhook
Como um servidor recebe eventos e porque é necessário verificar as notificações.
Atualizado:
Um webhook é uma notificação que um serviço envia ao endereço de outra aplicação quando ocorre um evento. Por exemplo, o Cryptanio pode informar o servidor de uma loja de que o estado de um pagamento mudou. A aplicação não precisa de consultar continuamente o mesmo estado para conhecer essa alteração.
A integração exige um recetor HTTPS acessível no servidor. Difere dos avisos prontos para Telegram ou Discord: o seu servidor recebe dados e executa a sua própria lógica. Guarde o segredo de verificação no servidor, fora do código do navegador, mensagens e registos.
Antes de processar, verifique a assinatura sobre os bytes originais do pedido e a validade temporal da mensagem. Identifique o evento, encontre a fatura associada e confira o estado. Uma assinatura válida confirma a origem, mas não substitui verificações do montante, ativo e encomenda.
A entrega pode repetir-se. Guarde o identificador do evento e impeça a entrega duplicada do produto. Aplique mudanças de estado pela ordem permitida. Após uma indisponibilidade, reconcilie os dados atuais e preserve o histórico dos eventos aceites.
Use o contrato público API v1 fixado do Cryptanio. Receber um pedido HTTP não basta para entregar: deteção, confirmação e pagamento integral são condições distintas. Preveja reversões da transação e exceções de pagamento.