Cupons
Crie códigos de desconto com validade, limite de usos, pedido mínimo e restrição por produto ou cliente.
Cupons são códigos que o cliente digita no carrinho ou no checkout para ganhar desconto. Eles ficam em Catálogo › Cupons.
Criar um cupom
Código e desconto
| Campo | Regra |
|---|---|
| Código | De 2 a 64 caracteres: letras, números, hífen ou sublinhado, sem espaços. Letras viram maiúsculas, então natal10 e NATAL10 são o mesmo cupom. |
| Tipo de desconto | Percentual (de 1% a 100%) ou valor fixo em reais. |
| Desconto máximo | Só no percentual. Teto em reais para pedidos grandes. Opcional. |
| Descrição interna | Opcional, até 500 caracteres. Só a equipe vê. |
Regras e limites
| Campo | Regra |
|---|---|
| Pedido mínimo | Subtotal mínimo dos itens, já com as ofertas, para o cupom valer. Opcional. |
| Limite total de usos | Vazio para ilimitado. |
| Limite por cliente | Vazio para ilimitado. Não pode passar do limite total. |
| Válido a partir de | Horário de Brasília. Vazio vale a partir de agora. |
| Válido até | Vazio para não expirar. |
Produtos
Em O cupom vale para, escolha:
- Todos os produtos;
- Só os produtos escolhidos; ou
- Todos, exceto os escolhidos.
Você pode escolher produtos inteiros ou preços (variantes) específicos, até 200.
Clientes (opcional)
Restrinja o cupom a clientes específicos (até 500) ou bloqueie alguns (até 500). Um cliente não pode estar liberado e bloqueado ao mesmo tempo.
Como o desconto é calculado
- As ofertas são aplicadas primeiro.
- O cupom incide sobre o subtotal dos itens elegíveis, já com as ofertas.
- No percentual, o desconto respeita o Desconto máximo, se houver.
- O desconto é dividido entre os itens elegíveis, proporcionalmente ao valor de cada um.
Produtos do tipo Doação e preços "pague quanto quiser" nunca recebem desconto de cupom. Só um cupom vale por pedido.
Exemplo
Carrinho com VIP a R$ 50,00 e Kit a R$ 30,00. Cupom DEZ10 de 10%, só para o VIP, com desconto máximo de R$ 4,00:
| Item | Subtotal | Desconto do cupom | Total |
|---|---|---|---|
| VIP | R$ 50,00 | R$ 4,00 (10% daria R$ 5,00, limitado a R$ 4,00) | R$ 46,00 |
| Kit | R$ 30,00 | R$ 0,00 (fora do cupom) | R$ 30,00 |
| Pedido | R$ 80,00 | R$ 4,00 | R$ 76,00 |
Quando um uso é contado
- No checkout, o uso do cupom fica reservado para o pedido. Dois checkouts simultâneos nunca passam do limite total nem do limite por cliente.
- Quando o pagamento é confirmado, o uso vira definitivo.
- Se o pedido expirar ou for cancelado antes do pagamento, a reserva é devolvida e o uso volta a ficar disponível.
Situação do cupom
| Situação | O que quer dizer |
|---|---|
| Ativo | Pode ser usado agora. |
| Agendado | Ativo, mas a data de início ainda não chegou. |
| Expirado | A validade terminou. |
| Esgotado | O limite total de usos foi atingido. |
| Desativado | O código deixa de funcionar no checkout na hora. O histórico de usos continua nos pedidos. |
Mensagens para o cliente
| Situação | Mensagem |
|---|---|
| Código inexistente, expirado, esgotado ou desativado | Cupom inválido, expirado ou esgotado. |
| Nenhum item do carrinho é elegível | Este cupom não vale para os itens do carrinho. |
| Limite por cliente atingido | Você já usou este cupom o número máximo de vezes. |
Se o cupom deixar de valer depois de aplicado (por exemplo, o subtotal ficou abaixo do pedido mínimo), o checkout pede para remover o cupom antes de continuar.
Pela API
- Validar cupom confere um código sem alterar o carrinho.
- Aplicar cupom (
PUT /api/v1/carts/{cartId}/coupon, com{ "code": "DEZ10" }) aplica o código ao carrinho. Envie o cabeçalhoX-Cart-Token. - Remover cupom tira o código do carrinho.
O carrinho devolve o resultado em coupon (code, applied, discount e message) e o desconto de cada item em couponDiscount.