Como corrigir o cupom de desconto que não funciona no WooCommerce
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.














