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

# Cupons

> Crie códigos de desconto para oferecer aos seus clientes

Cupons permitem que você ofereça descontos em planos do seu hub. Cada cupom é sincronizado com o Stripe e pode ser aplicado pelos clientes no checkout.

## Criando um cupom

Na aba **Cupons**, clique em **Criar Cupom** e configure:

| Campo                 | Descrição                                              |
| --------------------- | ------------------------------------------------------ |
| **Código**            | O código que o cliente vai digitar (ex: `BLACKFRIDAY`) |
| **Nome**              | Nome interno para identificar o cupom                  |
| **Tipo de desconto**  | Porcentagem ou valor fixo                              |
| **Valor do desconto** | Quanto desconta (ex: 20% ou R\$ 50,00)                 |
| **Duração**           | Once, Repeating ou Forever                             |
| **Escopo**            | Em quais planos o cupom pode ser usado                 |
| **Máximo de usos**    | Limite total de utilizações (opcional)                 |
| **Válido de / até**   | Datas de vigência do cupom                             |
| **Moeda**             | Moeda do desconto (para descontos em valor fixo)       |

## Tipos de duração

* **Once** — Aplica o desconto apenas na primeira cobrança
* **Repeating** — Aplica por X meses consecutivos
* **Forever** — Aplica em todas as cobranças enquanto a assinatura estiver ativa

## Validação no checkout

Quando o cliente digita um cupom, o Gennia valida:

* O código existe
* É aplicável ao plano escolhido
* Está dentro do período de validade
* O limite de usos não foi esgotado

Se tudo passar, o desconto é aplicado e o cliente vê o novo valor antes de confirmar.

## Acompanhamento

Cada cupom mostra:

* Quantas vezes foi usado
* Se está expirado
* Se o limite de usos foi esgotado
* Status ativo ou inativo

<Tip>
  Use cupons estratégicos para campanhas sazonais (Black Friday, aniversário), recuperação de clientes que abandonaram o checkout, ou programas de indicação.
</Tip>