Source: https://cryptanio.com/pt/wiki/o-que-e-um-webhook/
Language: pt

# O que é um webhook

Como um servidor recebe eventos e porque é necessário verificar as notificações\.

Atualizado: 2026-11-14

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](<https://cryptanio.com/pt/wiki/o-que-e-uma-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\.

Etiquetas: [Webhooks](https://cryptanio.com/pt/wiki/tag/webhooks/)

## Artigos relacionados

- [O que é uma fatura de pagamento](https://cryptanio.com/pt/wiki/o-que-e-uma-fatura/)
- [Como confirmar automaticamente o pagamento de um pedido por webhook](https://cryptanio.com/pt/wiki/confirmar-pagamento-de-pedido-por-webhook/)
- [Como receber pagamentos em criptomoedas em um bot do Telegram](https://cryptanio.com/pt/wiki/receber-pagamentos-cripto-bot-telegram/)
