Onde verificar
| Verificação | Onde |
|---|---|
| O webhook está cadastrado com o endereço certo? | Painel do gateway |
| O gateway tentou enviar? Qual a resposta? | Histórico de envios de webhooks no painel do gateway |
| O sistema recebeu? | Logs do servidor e da aplicação |
| O processamento deu erro? | Logs da aplicação e falhas na fila |
| A validação de assinatura está rejeitando? | Segredo do webhook trocado ou ambiente errado (teste x produção) |
Causas comuns
- Endereço do webhook apontando para o ambiente de testes ou para um domínio antigo
- Firewall, proteção contra robôs ou login bloqueando o acesso do gateway
- Erro no código ao processar um tipo de evento novo
- Avisos fora de ordem: “pendente” chegando depois de “aprovado” e sobrescrevendo o status
- Fila parada, quando o processamento é feito em segundo plano
A correção completa
- Corrigir o recebimento e responder ao gateway rapidamente, processando em segundo plano
- Não deixar um status mais antigo sobrescrever um mais recente
- Processar cada evento uma única vez (webhooks duplicados)
- Criar uma conciliação periódica: consultar no gateway os pagamentos dos pedidos pendentes e atualizar o que faltou
- Reprocessar os pedidos afetados no período da falha
Leia também
Entenda o fluxo completo em como funciona a integração de pagamentos. Corrigimos integrações de pagamento no nosso serviço de manutenção de sistemas PHP e Laravel.