Como corrigir pagamento do WooCommerce com erro
O que é o pagamento do WooCommerce com erro?
No WooCommerce, o pagamento é processado por um gateway (Mercado Pago, PagSeguro, Stripe, PayPal, etc.) que troca dados com a loja por API e confirma a transação via webhook. O ‘pagamento com erro’ é qualquer falha nesse fluxo: a cobrança não inicia, é recusada por configuração, ou o dinheiro é debitado mas o pedido fica preso em ‘Aguardando pagamento’ porque a confirmação não voltou ao site.
Como identificar
- Mensagem no checkout do tipo ‘Erro ao processar o pagamento’ ou ‘Desculpe, houve um erro no processamento do seu pedido’.
- O cliente paga, mas o pedido fica preso no status ‘Aguardando pagamento’ (on-hold/pending) e nunca muda para ‘Processando’.
- O gateway aparece como indisponível ou não lista a forma de pagamento na finalização.
- Nos logs (WooCommerce > Status > Logs) há entradas do gateway com ‘invalid API key’, ‘signature mismatch’ ou ‘webhook 401/404’.
Como prevenir
- Use chaves de Sandbox em staging e só troque para produção depois de validar um pedido de teste real
- Documente a URL de webhook de cada gateway e confirme que o WAF/host não bloqueia essas rotas
- Mantenha SSL válido, WooCommerce e plugins de gateway sempre atualizados e monitore os logs do gateway
Causa
- Chaves de API do gateway erradas ou em modo Sandbox/Teste enquanto a loja está em produção (ou o inverso).
- Webhook/IPN do gateway não configurado ou com URL inacessível, deixando o pedido sem confirmação automática.
- Certificado SSL ausente ou HTTPS inconsistente: o gateway recusa processar pagamento em página sem cadeado válido.
- Conflito de plugin ou cache no checkout impedindo o JavaScript do gateway (campos de cartão/redirecionamento) de carregar.
- Versão do plugin do gateway desatualizada e incompatível com a versão atual do WooCommerce ou do PHP.
Como resolver
- Confirme as chaves de API e o modo: no painel do gateway em WooCommerce > Configurações > Pagamentos, revise as chaves (public/secret) e garanta que o modo Teste/Sandbox está DESLIGADO em produção, usando as chaves de produção.
- Cheque os logs do gateway: em WooCommerce > Status > Logs, selecione o log do gateway. Mensagens como 'invalid API key' ou 'signature mismatch' apontam direto para chave errada ou webhook mal configurado.
- Configure o webhook corretamente: copie a URL de webhook/IPN exata que o plugin informa e cole no painel do provedor de pagamento. Sem isso, pedidos pagos ficam presos em 'Aguardando pagamento'.
- Garanta SSL válido no checkout: confirme HTTPS com cadeado válido na página de checkout. Em WooCommerce > Configurações > Avançado, ative 'Forçar checkout seguro' se o gateway exigir SSL.
- Atualize o plugin do gateway e teste: atualize o plugin do gateway, limpe o cache do checkout e faça um pedido de teste real (valor baixo) para validar todo o fluxo de ponta a ponta.
// functions.php — registra no log do WooCommerce quando o webhook do gateway chega
// (ajuda a diagnosticar pedido preso em 'Aguardando pagamento')
add_action( 'woocommerce_api_request', function ( $api_request ) {
$logger = wc_get_logger();
$logger->info(
'Webhook recebido para gateway: ' . sanitize_text_field( $api_request ),
array( 'source' => 'gateway-webhook-debug' )
);
}, 10, 1 );
// Veja em WooCommerce > Status > Logs (source: gateway-webhook-debug).
// Se NADA for registrado quando o cliente paga, o webhook nao esta chegando ao site.Perguntas frequentes
O cliente pagou mas o pedido ficou em 'Aguardando pagamento'. Por quê?
Onde vejo o motivo do erro de pagamento?
Por que o gateway não aparece no checkout?
Estou em modo de teste sem querer. Como saber?
SSL é obrigatório para receber pagamento no WooCommerce?
Atualizei o WooCommerce e os pagamentos pararam. O que fazer?
Como corrigir email de pedido do WooCommerce não enviado
Quando o WooCommerce não envia o email de pedido, o cliente não recebe a confirmação e a loja não é avisada da venda. A causa quase sempre é a função mail() do PHP sendo bloqueada pela hospedagem ou marcada como spam; configurar um SMTP autenticado resolve a maioria dos casos.
Como corrigir o filtro de produtos do WooCommerce no JetSmartFilters
O Product Filter do WooCommerce no JetSmartFilters não filtra produtos quando o provedor escolhido em 'This filter for' ou o Query ID do widget de filtro não apontam para a mesma query que monta a grade da loja. Sem esse pareamento, o filtro envia a busca para um lugar diferente do que exibe os produtos, e a vitrine continua igual.
Como corrigir o cupom de desconto que não funciona no WooCommerce
O cupom que não funciona no WooCommerce acontece quando o cliente digita o código de desconto e ele é recusado, não aplica o valor, ou o campo de cupom nem aparece no carrinho. Quase sempre vem dos cupons desativados nas configurações, de restrições de uso (valor mínimo, produtos, validade) ou de cache servindo um carrinho antigo.
Como corrigir a variação de produto que não aparece no WooCommerce
A variação de produto que não aparece no WooCommerce acontece quando o produto é variável mas as opções de tamanho, cor ou modelo não surgem para o cliente escolher. Quase sempre vem de um atributo não marcado como 'Usado para variações', de variações sem preço ou estoque, ou de cache servindo uma versão antiga da página.
Como corrigir o produto do WooCommerce com página em branco
O produto do WooCommerce com página em branco acontece quando a página de um produto abre totalmente vazia, sem texto, imagem ou botão de comprar. A causa quase sempre é um erro fatal de PHP silenciado, um template de produto ausente no tema, ou o limite de memória do PHP estourado ao renderizar a página.
Como corrigir webhook do WooCommerce que não dispara
O webhook do WooCommerce não dispara quando um evento da loja, como um novo pedido, deveria notificar um sistema externo, mas a chamada nunca sai ou nunca chega. Quase sempre vem do webhook ficar com status Desativado após falhas, da URL de destino inacessível ou com SSL inválido, ou do WP-Cron travado.
