Cupom não funciona no WooCommerce: como corrigir o desconto

Tipo WooCommerce

Nome do erro Cupom de desconto que não funciona no WooCommerce EN: WooCommerce coupon not working

Severidade Atenção

Descrição 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.

O que é o cupom de desconto que não funciona no WooCommerce?

Cupom no WooCommerce é um código que aplica desconto por porcentagem, valor fixo ou frete grátis, com regras de uso como validade, valor mínimo, produtos elegíveis e limite de usos. Quando o cupom ‘não funciona’, o cliente recebe uma mensagem de inválido, o desconto não entra no total, ou o campo para digitar o código não existe na página. A causa costuma ser uma regra de restrição não atendida ou a opção de cupons desligada.

Como identificar

Ao aplicar o código aparece ‘Cupom inválido’ ou ‘O cupom não existe!’ mesmo digitando certo.
O cupom é aceito mas o desconto não muda o total do pedido.
O campo ‘Tem um cupom? Clique aqui para inserir seu código’ não aparece no carrinho nem no checkout.
Mensagem ‘O uso deste cupom está limitado a certos produtos’ ou ‘O valor mínimo do pedido para este cupom é R$ X’.

Como prevenir

Documente as restrições de cada cupom (valor mínimo, validade, produtos) e teste o código antes de divulgá-lo
Mantenha carrinho e checkout fora do cache para não esconder o campo de cupom nem mostrar total desatualizado
Revise plugins de carrinho/checkout customizados após atualizações para garantir que o formulário de cupom continua presente

Causa

Opção 'Habilitar o uso de códigos de cupom' desligada em WooCommerce > Configurações > Geral, ocultando o campo de cupom.
Restrições do cupom não atendidas: valor mínimo do pedido, produtos/categorias específicos, ou exclusão de itens em promoção.
Cupom expirado pela data de validade, ou com limite de usos (total ou por usuário) já esgotado.
Cache de página servindo o carrinho/checkout sem o campo de cupom ou com um total antigo antes do desconto.
Plugin de carrinho/checkout customizado ou tema que remove o formulário de cupom do template padrão.

Como resolver

Habilite cupons nas configurações: em WooCommerce > Configurações > Geral, marque 'Habilitar o uso de códigos de cupom'. Sem isso o campo de cupom nem aparece para o cliente.
Revise as restrições do cupom: em Marketing > Cupons, abra o cupom e cheque a aba Restrição de uso: valor mínimo, produtos e categorias permitidos, e 'Excluir itens em promoção'. Uma regra não atendida recusa o desconto.
Confira validade e limites de uso: na aba Geral do cupom, verifique a data de expiração; na aba Limites de uso, veja se o limite total ou por usuário já foi atingido. Cupom expirado ou esgotado é recusado.
Limpe o cache do carrinho e checkout: limpe o cache de página e marque carrinho e checkout como nunca cacheados. Um carrinho em cache pode esconder o campo de cupom ou mostrar o total sem o desconto aplicado.
Teste com tema padrão: se o campo de cupom não aparece, ative um tema padrão (Storefront). Se o campo voltar, o tema ou um plugin de checkout estava removendo o formulário de cupom do template.

PHP

// functions.php do tema filho — garante que o campo de cupom apareca
// no carrinho mesmo em temas que escondem o formulario padrao
add_action( 'woocommerce_before_cart', function () {
    if ( wc_coupons_enabled() ) {
        echo do_shortcode( '[woocommerce_cart]' ) ? '' : '';
    }
} );
add_filter( 'woocommerce_coupons_enabled', function ( $enabled ) {
    // forca o suporte a cupom caso uma config ou plugin tenha desligado por engano
    return true;
} );

Perguntas frequentes

O campo de cupom não aparece no carrinho. Como ativo?

Vá em WooCommerce > Configurações > Geral e marque 'Habilitar o uso de códigos de cupom'. Se mesmo assim não aparecer, teste com um tema padrão: um tema ou plugin de checkout pode estar removendo o formulário de cupom do template.

O cupom diz inválido mas eu digitei certo. Por quê?

Geralmente o cupom expirou, atingiu o limite de usos, ou o pedido não atende uma restrição como valor mínimo ou produtos elegíveis. Abra o cupom em Marketing > Cupons e revise as abas Geral, Restrição de uso e Limites de uso.

O cupom é aceito mas o desconto não aparece no total. O que houve?

Costuma ser cache mostrando um total antigo, ou o cupom só vale para itens que não estão no carrinho. Limpe o cache do carrinho e confirme, na restrição do cupom, quais produtos ou categorias recebem o desconto.

Posso impedir cupom em produtos já em promoção?

Sim. Na aba Restrição de uso do cupom existe a opção 'Excluir itens em promoção'. Se ela estiver marcada, o desconto não se aplica a produtos que já têm preço promocional, o que pode parecer que o cupom não funciona.

Por que o cupom funciona para um cliente e não para outro?

Pode haver limite de uso por usuário, ou restrição por e-mail permitido. Verifique na aba Limites de uso se há um limite por cliente atingido e na Restrição de uso se há e-mails específicos autorizados a usar o cupom.

Mudei o tema e o campo de cupom sumiu. Como recuperar?

O novo tema pode não incluir o formulário de cupom no template de carrinho. Confirme que os cupons estão habilitados nas configurações e, se necessário, force o suporte com um filtro woocommerce_coupons_enabled ou ajuste o template de carrinho do tema.

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.

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.

Atenção

Como corrigir o cálculo de frete errado no WooCommerce

O cálculo de frete errado no WooCommerce acontece quando o valor da entrega no checkout vem maior, menor ou diferente do esperado, ou simplesmente não aparece. Quase sempre vem de zonas de entrega mal configuradas, de produtos sem peso e dimensões, ou de classes de frete e regras de frete grátis conflitando entre si.

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

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.

Setores

Extensões

Integrações

Como corrigir o cupom de desconto que não funciona no WooCommerce

O que é o cupom de desconto que não funciona no WooCommerce?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

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

Como corrigir o checkout do WooCommerce lento

Como corrigir o cálculo de frete errado no WooCommerce

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

Como corrigir checkout do WooCommerce que não funciona

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

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