> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loja.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Cupons

> Crie cupons de desconto por percentual ou valor fixo, aplicáveis a produtos ou categorias.

<Info>
  Cupons são um recurso disponível nos planos **Pro** e **Premium**.
</Info>

Cupons permitem que o cliente digite um código no checkout para obter um desconto.

## Tipos de desconto

<Tabs>
  <Tab title="Percentual">
    Desconto calculado como uma porcentagem do valor da compra (ex.: 25% off).
  </Tab>

  <Tab title="Valor fixo">
    Desconto de um valor fixo em reais, independente do total da compra.
  </Tab>
</Tabs>

## Aplicação do cupom

Um cupom pode ser restrito a:

* **Produtos específicos**
* **Categorias inteiras**

E pode ter regras adicionais:

<CardGroup cols={2}>
  <Card title="Limite de uso" icon="hash">
    Quantidade máxima de vezes que o cupom pode ser resgatado (`redeem_limit`).
  </Card>

  <Card title="Vigência" icon="calendar">
    Data de início e de expiração.
  </Card>

  <Card title="Valor mínimo do carrinho" icon="shopping-cart">
    Valor mínimo de compra para o cupom ser válido (`minimum_basket_val`).
  </Card>

  <Card title="Acumulativo ou não" icon="layers">
    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.
  </Card>
</CardGroup>

## 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](/api-reference/storefront-headless#cupom), para quem monta a própria vitrine.

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