Pagamento do WooCommerce com erro: como corrigir

Tipo WooCommerce

Nome do erro Pagamento do WooCommerce com erro EN: WooCommerce payment failing

Severidade Crítico

Descrição O pagamento do WooCommerce com erro acontece quando o cliente tenta pagar mas a transação falha, é recusada ou o pedido não é confirmado mesmo após o pagamento. Quase sempre vem de chaves de API erradas (modo teste x produção), de webhook do gateway não chegando ao site ou de SSL/HTTPS mal configurado no checkout.

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’.

Antes de começar: Nunca exponha a chave secreta (secret key) do gateway em código público, no front-end ou em logs versionados. Faça backup e teste em staging com chaves de Sandbox antes de mexer no gateway de produção.

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.

PHP

// 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ê?

Porque a confirmação (webhook/IPN) do gateway não chegou ao site. O dinheiro foi cobrado no provedor, mas o WooCommerce não recebeu o aviso para mudar o status. Verifique a URL de webhook no painel do gateway e se o WAF não está bloqueando essa rota.

Onde vejo o motivo do erro de pagamento?

Em WooCommerce > Status > Logs, selecione o log do seu gateway. Mensagens como 'invalid API key', 'signature mismatch' ou 'webhook 401/404' indicam exatamente se o problema é chave, assinatura ou webhook.

Por que o gateway não aparece no checkout?

Geralmente faltam credenciais, o método está desativado, ou o gateway exige SSL e o checkout não está em HTTPS válido. Revise as configurações do método em WooCommerce > Pagamentos e confirme o cadeado na página.

Estou em modo de teste sem querer. Como saber?

No painel do gateway, procure a opção Modo Teste/Sandbox: se estiver marcada em produção, nenhuma cobrança real é processada. Desative o modo teste e troque para as chaves de produção do provedor.

SSL é obrigatório para receber pagamento no WooCommerce?

Sim, na prática. A maioria dos gateways recusa processar pagamento em páginas sem HTTPS válido, e os navegadores alertam o cliente. Instale um certificado SSL e force o checkout seguro nas configurações do WooCommerce.

Atualizei o WooCommerce e os pagamentos pararam. O que fazer?

O plugin do gateway pode estar incompatível com a nova versão. Atualize o plugin do gateway, cheque os logs por erros de compatibilidade e, se preciso, faça um pedido de teste em staging antes de confirmar na loja ao vivo.

Grave

Como corrigir REST API do WooCommerce com erro 401

O erro 401 na REST API do WooCommerce acontece quando a requisição é rejeitada por falha de autenticação, mesmo com a chave informada. Quase sempre vem do header Authorization removido pelo servidor, de Consumer Key e Secret erradas ou sem permissão, ou da chamada em HTTP sem SSL válido.

Atenção

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.

Grave

Como corrigir o botão Adicionar ao carrinho que não funciona no WooCommerce

O botão add to cart do WooCommerce não funcionar significa que o cliente clica em comprar mas o produto não entra no carrinho: o botão fica girando, recarrega a página sem somar, ou nada acontece. Quase sempre vem de requisições AJAX bloqueadas, conflito de JavaScript de plugin ou tema, ou do produto sem estoque ou sem preço.

Crítico

Como corrigir o carrinho do WooCommerce que não funciona com o Elementor Pro

O cart do WooCommerce não funcionar com o Elementor Pro significa que o widget Menu Cart ou Cart mostra o contador parado em zero, não abre o painel lateral ou não soma o produto após o clique. Quase sempre vem dos fragments AJAX bloqueados por cache, do script wc-cart-fragments minificado, ou do tema sem suporte ao WooCommerce.

Crítico

Como corrigir checkout do WooCommerce que não funciona

O checkout do WooCommerce não funcionar significa que o cliente chega à página de finalizar compra mas não consegue concluir: o botão de finalizar pedido não responde, a página recarrega sem avançar ou retorna erro. Quase sempre vem de conflito de plugin/tema, de requisições AJAX bloqueadas ou da página de checkout configurada errada.

Grave

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.

Setores

Extensões

Integrações

Como corrigir pagamento do WooCommerce com erro

O que é o pagamento do WooCommerce com erro?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir REST API do WooCommerce com erro 401

Como corrigir webhook do WooCommerce que não dispara

Como corrigir o botão Adicionar ao carrinho que não funciona no WooCommerce

Como corrigir o carrinho do WooCommerce que não funciona com o Elementor Pro

Como corrigir checkout do WooCommerce que não funciona

Como corrigir o produto do WooCommerce com página em branco

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos