Meu webhook não está recebendo as notificações
O webhook é o aviso automático que mandamos ao seu sistema quando um pagamento é confirmado. Quando ele para de chegar, é quase sempre um de...
O webhook é o aviso automático que mandamos ao seu sistema quando um pagamento é confirmado. Quando ele para de chegar, é quase sempre um destes casos.
1. Sua URL está recusando
Só consideramos a entrega bem-sucedida se o seu servidor responder HTTP 200. Qualquer outra coisa — 404, 500, tempo esgotado — conta como falha.
Confira em API Keys → Webhooks o status das últimas entregas. Se aparecerem falhas, o problema está do seu lado.
2. Seu endpoint desligou sozinho
Se a sua URL falha repetidamente, suspendemos as tentativas por 30 minutos e avisamos você. É proteção: sem isso, um endpoint quebrado geraria milhares de tentativas inúteis e atrasaria a fila de todo mundo.
Assim que a URL voltar a responder, as entregas são retomadas.
3. A validação da assinatura está errada
Todo webhook vai assinado no cabeçalho X-FlowinPay-Signature. Se o seu código valida a assinatura e a compara de forma incorreta, ele vai rejeitar avisos legítimos.
O guia de webhook na documentação mostra exatamente como calcular e comparar. Um detalhe comum: a assinatura é calculada sobre o corpo cru da requisição, não sobre o JSON já convertido.
Você não perde pagamento por causa disso
Mesmo que o webhook nunca chegue, o sistema confere sozinho, a cada 5 minutos, quais cobranças foram pagas na instituição financeira. O saldo entra do mesmo jeito. O webhook acelera o seu processo, mas não é o que garante o dinheiro.
Testando
Você pode disparar um evento de teste pelo painel, em API Keys → Webhooks. Ele chega com a mesma assinatura de uma entrega real, então serve para validar seu código antes de ir para produção.
Central de ajuda · FlowinPay
