Checkout WooCommerce WP Rocket não funciona: corrigir

Tipo WooCommerce

Nome do erro Cache do WP Rocket quebra o checkout do WooCommerce EN: WP Rocket cache breaking WooCommerce checkout

Severidade Crítico

Descrição O checkout do WooCommerce com WP Rocket não funciona quando a página de finalizar compra é servida em cache ou tem o JavaScript do gateway adiado: o botão de finalizar pedido não responde, a página recarrega sem avançar ou retorna nonce expirado. A correção é garantir a exclusão de cache do checkout e liberar os scripts essenciais.

O que é o checkout do WooCommerce com WP Rocket que não funciona?

O checkout do WooCommerce com WP Rocket é a página de finalizar compra de uma loja que usa o plugin de cache WP Rocket. O WP Rocket exclui do cache as páginas Carrinho, Finalizar compra e Minha conta automaticamente, mas só as que estiverem atribuídas nas configurações do WooCommerce. Quando essa atribuição está errada, ou quando as otimizações de JavaScript adiam os scripts do checkout e do gateway de pagamento, a página é entregue estática para todos os visitantes: o nonce de segurança expira, o cálculo de frete e o formulário param de atualizar e o cliente não consegue concluir a compra. É um dos erros mais caros de uma loja, porque acontece no exato momento da conversão.

Como identificar

O botão ‘Finalizar compra’ / ‘Place order’ não responde ao clique e a página apenas recarrega, sem criar o pedido.
Mensagem ‘O link que você seguiu expirou’ ou erro de nonce ao tentar finalizar, sinal de página de checkout cacheada e servida estática.
O console do navegador (F12, aba Rede) mostra a chamada wc-ajax=checkout retornando 403 ou sem resposta enquanto o JavaScript do gateway não inicia.
Os campos de entrega, frete e o total do pedido não atualizam ao trocar o endereço, porque o fragmento AJAX foi cacheado junto com a página.
O problema some quando você limpa o cache do WP Rocket e volta minutos depois, quando a versão cacheada do checkout é regenerada.
Desativar o WP Rocket faz o checkout voltar a funcionar e reativar o plugin quebra de novo.

Antes de começar: Faça backup do banco e teste em ambiente de staging antes de mexer nas otimizações de uma loja no ar. As configurações do WP Rocket ficam na option wp_rocket_settings e o backup permite reverter caso uma exclusão piore o frontend. Nunca desative o nonce do checkout para forçar o AJAX a funcionar: isso abre brecha de CSRF.

Como prevenir

Mantenha as páginas de carrinho, checkout e minha conta sempre atribuídas em WooCommerce -> Configurações -> Avançado, que é a condição para o WP Rocket excluí-las do cache automaticamente
Sempre que trocar de gateway de pagamento ou atualizar o WooCommerce, exclua o novo script do Delay JavaScript Execution e da combinação de JavaScript antes de considerar o deploy concluído
Após qualquer mudança nas otimizações do WP Rocket, finalize um pedido de teste em janela anônima com o cache limpo antes de liberar a loja
Mantenha um único plugin de cache ativo e desligue o cache de página do host ou do Cloudflare nas rotas de checkout para não cachear o pedido por cima do WP Rocket

Causa

As páginas Carrinho, Finalizar compra e Minha conta não estão atribuídas em WooCommerce -> Configurações -> Avançado, então o WP Rocket não as reconhece e serve a página de checkout em cache para todos os visitantes.
A opção Delay JavaScript Execution (aba File Optimization) está segurando o script do gateway (Stripe, Mercado Pago, PagBank) e o wc-checkout.js, então o botão de finalizar pedido não dispara a requisição.
A opção Combine JavaScript files ou Minify JavaScript files quebra o script do checkout ou do gateway ao juntar os arquivos, deixando o formulário sem o handler de submit.
Uma URL do checkout foi adicionada manualmente em Advanced Rules -> Never Cache URL(s) com a barra final errada, ou outro plugin de cache (host, Cloudflare APO) está cacheando o checkout por cima do WP Rocket.
O Optimize CSS Delivery / Remove Unused CSS removeu o CSS do formulário de checkout e os campos ficam invisíveis ou desalinhados, impedindo o preenchimento.
O cart fragments AJAX (wc-ajax=get_refreshed_fragments) foi cacheado, então o mini carrinho e o total do checkout mostram um estado antigo e o pedido não fecha com o valor correto.

Como resolver

Confirme que a causa é o WP Rocket: no painel, abra WP Rocket -> Dashboard e clique em Limpar e pré-carregar cache. Se o checkout voltar a funcionar e quebrar de novo em poucos minutos, o conflito está no cache ou nas otimizações de JavaScript do WP Rocket, não no WooCommerce.
Verifique a atribuição das páginas do WooCommerce: garanta que as páginas estão corretamente atribuídas, porque o WP Rocket só exclui do cache as páginas que o WooCommerce informa. Confira em WooCommerce -> Configurações -> Avançado os três campos abaixo e que cada página contém o bloco ou o shortcode correspondente.
```
Página do carrinho -> [woocommerce_cart]
Página de finalização da compra -> [woocommerce_checkout]
Página da conta -> [woocommerce_my_account]
```
Exclua os scripts essenciais do Delay JavaScript Execution: abra WP Rocket -> File Optimization, role até Delay JavaScript Execution e adicione na lista de exclusão o script do checkout e o do seu gateway de pagamento, para que o botão de finalizar pedido volte a responder ao clique.
```
/woocommerce/assets/js/frontend/checkout
wc-checkout
js.stripe.com
mercadopago
jquery.min.js
```
Tire o checkout da combinação e minificação de JavaScript: ainda em File Optimization, na seção Minify JavaScript files, adicione os mesmos scripts do checkout e do gateway ao campo de JavaScript excluído, e desative Combine JavaScript files se o seu gateway carregar de um domínio externo.
```
/woocommerce/assets/js/frontend/checkout.min.js
/plugins/woocommerce-gateway-stripe/
/plugins/woo-mercado-pago-module/
```
Reforce a exclusão de cache e do CSS: em WP Rocket -> Advanced Rules, confirme que as páginas de carrinho, checkout e conta não estão sendo cacheadas e, se usar Remove Unused CSS, adicione o seletor do checkout ao CSS Safelist. Adicione o caminho do checkout em Never Cache URL(s) usando o padrão com curinga.
```
/finalizar-compra(.*)
.woocommerce-checkout
#order_review
```
Limpe o cache e teste em janela anônima: volte ao WP Rocket -> Dashboard, clique em Limpar e pré-carregar cache, limpe também o cache da CDN ou do Cloudflare e finalize um pedido de teste em uma janela anônima para confirmar que o botão de finalizar compra cria o pedido.

PHP

// functions.php do tema filho — garante que checkout, carrinho e minha conta
// nunca sejam servidos em cache, mesmo se a atribuicao do WooCommerce falhar.
add_action( 'template_redirect', function () {
    if ( function_exists( 'is_checkout' ) && ( is_checkout() || is_cart() || is_account_page() ) ) {
        if ( ! defined( 'DONOTCACHEPAGE' ) ) {
            define( 'DONOTCACHEPAGE', true );
        }
        nocache_headers();
    }
}, 0 );

Perguntas frequentes

Por que o botão de finalizar compra não responde depois que ativei o WP Rocket?

Quase sempre é o Delay JavaScript Execution segurando o script do checkout ou do gateway até a primeira interação. Como o botão de finalizar pedido depende desse JavaScript, ele não dispara. Exclua o wc-checkout e o script do seu gateway da lista de Delay JavaScript para resolver.

O checkout do WooCommerce não pode ser cacheado pelo WP Rocket?

Não. O WP Rocket exclui automaticamente as páginas de carrinho, checkout e minha conta do cache, mas só as que estão atribuídas nas configurações do WooCommerce. Se a atribuição estiver errada, a página de checkout é cacheada e servida estática, o nonce expira e o pedido não fecha.

Apareceu 'O link que você seguiu expirou' no checkout, o que é?

É o nonce de segurança expirado, sinal de que o checkout foi cacheado e entregue estático para todos. Confirme a atribuição das páginas no WooCommerce, limpe o cache do WP Rocket e garanta que nenhuma outra camada de cache, como host ou Cloudflare, está cacheando a rota do checkout.

Preciso desativar todo o WP Rocket para o checkout voltar?

Não. Na maioria dos casos basta corrigir a atribuição das páginas do WooCommerce e excluir o script do checkout e do gateway do Delay JavaScript Execution e da combinação de JavaScript. Assim você mantém o ganho de velocidade no resto da loja sem quebrar a conversão.

O cálculo de frete e o total não atualizam no checkout, qual a causa?

Costuma ser o cart fragments AJAX (get_refreshed_fragments) cacheado junto com a página, servindo um estado antigo do carrinho. Garanta que o checkout está fora do cache e verifique no console (F12, aba Rede) se a chamada wc-ajax retorna resposta válida ao trocar o endereço.

Como sei se o problema é o WP Rocket ou outro plugin?

Em WP Rocket -> Dashboard clique em Limpar e pré-carregar cache. Se o checkout funciona logo após limpar e quebra minutos depois, é o cache ou a otimização de JavaScript do WP Rocket. Se nem com cache limpo funciona, teste com tema padrão e demais plugins desativados para isolar a causa.

Excluí os scripts e o checkout continua quebrado, e agora?

Limpe o cache com Limpar e pré-carregar cache para regenerar a página e desative Combine JavaScript files e Remove Unused CSS um de cada vez, recarregando o checkout em janela anônima a cada teste, até identificar qual otimização remove o script ou o CSS do formulário.

O checkout funciona no meu computador mas não no do cliente, por quê?

Geralmente é a CDN ou o cache do navegador do cliente servindo uma versão antiga e estática do checkout. Limpe o cache da CDN ou do Cloudflare, confirme que a rota de checkout está fora dessas camadas e peça ao cliente para testar em uma aba anônima.

Crítico

Como corrigir erro de pagamento do Tutor LMS com WooCommerce

O erro de pagamento do Tutor LMS com WooCommerce ocorre quando o aluno compra um curso, o pedido entra no WooCommerce, mas a matricula não acontece e ele fica sem acesso. A causa quase sempre e o pedido não atingir o status Concluido, o produto do curso não ser virtual, ou a engine de monetizacao errada nas Configurações.

Grave

Como corrigir o estoque do WooCommerce mostrando errado

O estoque errado no WooCommerce acontece quando a quantidade exibida não bate com o real: produto disponível aparece esgotado, a contagem não baixa após a venda, ou somem unidades sem pedido. Quase sempre vem de cache antigo, de pedidos presos reduzindo estoque, ou de sincronização externa fora de hora.

Crítico

Como corrigir o formulário de pagamento Stripe que não processa no WPForms

O pagamento Stripe não processa no WPForms quando o formulário é enviado mas a cobrança no cartão não é criada, o envio trava no botão ou o pedido fica sem confirmação. As causas reais mais comuns são AJAX desativado no formulário, o addon Stripe Pro inativo, o modo Teste ligado em produção e SSL ou webhook mal configurados.

Grave

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.

Grave

Como corrigir o checkout do WooCommerce lento

O checkout lento no WooCommerce acontece quando a página de finalizar compra demora para carregar ou para responder ao clique, fazendo o cliente desistir. Quase sempre vem do cart fragments via AJAX em cada página, de plugins pesados rodando no checkout, ou de consultas lentas no banco com a tabela wp_options inchada.

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.

Setores

Extensões

Integrações

Como corrigir o erro de checkout do WooCommerce causado pelo cache do WP Rocket

O que é o checkout do WooCommerce com WP Rocket que não funciona?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir erro de pagamento do Tutor LMS com WooCommerce

Como corrigir o estoque do WooCommerce mostrando errado

Como corrigir o formulário de pagamento Stripe que não processa no WPForms

Como corrigir email de pedido do WooCommerce não enviado

Como corrigir o checkout do WooCommerce lento

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

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