Visão geral
Uma cobrança pode ficar pendente ou falhar por motivos do gateway (cartão recusado), por aguardar a confirmação do cliente (PIX/boleto) ou por um webhook que não chegou. A confirmação real de pagamento vem sempre pelo webhook do gateway, não pela tela de sucesso.
Pré-requisitos
- Gateway conectado (Asaas/Mercado Pago) com webhook configurado.
Passo a passo
- Abra a cobrança e confira o status atual.
- Cartão recusado: peça ao cliente para tentar outro cartão ou método.
- PIX/boleto pendente: aguarde a confirmação; reenvie o link/QR se necessário.
- Pago no gateway mas pendente aqui: verifique se o webhook chegou.
- Confirme o estado final consultando a cobrança no painel do gateway, se preciso.
Configurações & opções
- Webhook: a fonte de verdade do status. Deve estar ativo e validado.
- Métodos: PIX, boleto e cartão (checkout hospedado).
Casos de uso
- Recuperar uma venda com cartão recusado oferecendo outro método.
- Reenviar uma cobrança PIX que expirou.
Dicas, limites e boas práticas
- Nunca confie na tela de sucesso para marcar como pago — confie no webhook.
- Garanta idempotência no processamento de eventos do gateway.
Solução de problemas
- Status não atualiza: verifique a configuração e a assinatura do webhook.
- Cobrança duplicada: confira a idempotência por identificador.