Skip to main content
Cupons são um recurso disponível nos planos Pro e Premium.
Cupons permitem que o cliente digite um código no checkout para obter um desconto.

Tipos de desconto

Desconto calculado como uma porcentagem do valor da compra (ex.: 25% off).

Aplicação do cupom

Um cupom pode ser restrito a:
  • Produtos específicos
  • Categorias inteiras
E pode ter regras adicionais:

Limite de uso

Quantidade máxima de vezes que o cupom pode ser resgatado (redeem_limit).

Vigência

Data de início e de expiração.

Valor mínimo do carrinho

Valor mínimo de compra para o cupom ser válido (minimum_basket_val).

Acumulativo ou não

Define se o cupom pode ser combinado com um produto que já está em promoção, ou se as duas coisas são mutuamente exclusivas.

Criando um cupom

Em Loja → Cupons → Novo cupom, preencha nome, código, tipo de desconto (percentual ou valor fixo) e o valor. Opcionalmente, restrinja a produtos ou categorias específicas, defina um limite de resgates, um valor mínimo de carrinho e uma vigência (início e expiração).

Validando um cupom no checkout

A validação acontece automaticamente quando o comprador digita o código no checkout — a mesma lógica é usada tanto no checkout padrão da loja.gg quanto na API de storefront headless, para quem monta a própria vitrine.
Um cupom inválido (inexistente, expirado ou fora de regra) sempre retorna uma mensagem genérica de “cupom inválido” — o sistema não informa qual dos três motivos ocorreu, para dificultar tentativas de descobrir códigos por força bruta.