# Cupons

Crie códigos de desconto para a loja da sua cidade, com limite de usos, validade, compra mínima e desconto só em algumas categorias ou produtos.

Source: https://fivedash.fivex.gg/docs/pt/store/coupons

Os **Cupons** são códigos de desconto que o jogador digita na hora da compra. Servem para lançamentos, eventos da cidade, parcerias com streamers e boas-vindas para quem nunca comprou. Cada cupom pode valer para a loja inteira ou só para algumas categorias ou produtos, ter limite de usos, data para começar e para acabar. Esta página é para quem cuida do catálogo e das promoções da loja.

[Vídeo: como fazer em menos de 20 segundos](https://fivedash.fivex.gg/docs/videos/store-coupons-pt.mp4)

## Antes de começar

* **Plano:** os cupons estão em todos os planos com a Loja (Plus, Pro e Ultra).
* **Loja aberta:** a loja precisa estar configurada. Veja [Visão geral da loja](https://fivedash.fivex.gg/docs/pt/store/overview).
* **Onde fica:** **Loja → Cupons**.

| Ação                             | Nível          |
| -------------------------------- | -------------- |
| Cupons e vendas com cupom        | **Ver**        |
| Criar, editar e desativar cupons | **Configurar** |

Quem só tem **Ver** enxerga a lista e os números, mas não vê os botões de criar, editar, ativar, desativar ou excluir. Veja [Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions).

> Estes são os cupons da **sua loja**, que os jogadores usam. Os cupons de desconto na assinatura do FiveDash são outra coisa e aparecem na hora de pagar o plano. Veja [Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing).

## Criar um cupom

### Abra os cupons

Na barra lateral, abra **Loja → Cupons** e clique em **Novo cupom**. Se a loja ainda não tem cupons, clique em **Criar cupom** ou escolha um modelo em **Comece por um modelo**.

### Escolha o código

Em **Código**, digite o código (ex.: `BEMVINDO10`) ou clique em **Gerar** para criar um código aleatório.

### Defina o desconto

Em **Tipo de desconto**, escolha **Porcentagem** ou **Valor fixo** e preencha **Porcentagem de desconto** ou **Valor do desconto**.

### Escolha onde vale

Em **Vale para**, escolha **Toda a loja**, **Categorias** ou **Produtos**. Com categorias ou produtos, marque os que entram no desconto.

### Ajuste condições e validade

Em **Condições e limites**, ligue o que precisar: **Compra mínima**, **Limite de usos**, **Por jogador** e **Só na primeira compra**. Em **Validade**, ligue **Agendar início** e **Data para acabar** se o cupom tiver datas.

### Salve

Confira o **Resumo** e clique em **Criar cupom**. O cupom começa a valer na hora (ou na data de início, se agendou).

### Modelos prontos

Quando a loja ainda não tem cupons, a página oferece três modelos. Eles só preenchem o formulário; você pode mudar tudo antes de salvar.

| Modelo          | Código sugerido | O que vem preenchido                                                      |
| --------------- | --------------- | ------------------------------------------------------------------------- |
| **Boas-vindas** | `BEMVINDO10`    | 10%, uma vez por jogador, **Só na primeira compra**, sem data para acabar |
| **Lançamento**  | `LANCAMENTO20`  | 20%, uma vez por jogador, **Limite de usos** de 100, acaba em 7 dias      |
| **Parceria**    | `PARCEIRO15`    | 15%, uma vez por jogador, sem data para acabar                            |

## Campos do cupom

| Campo                     | O que faz                                                                                                                                                                                      | Padrão                                      |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| **Código**                | O que o jogador digita. De 3 a 24 caracteres: letras, números, `-` e `_`. Sem diferença entre maiúsculas e minúsculas; espaços viram `-` e acentos saem. Não pode repetir outro cupom da loja. | Vazio                                       |
| **Gerar**                 | Cria um código aleatório de 6 caracteres, sem letras e números parecidos (0/O, 1/I/L).                                                                                                         | —                                           |
| **Tipo de desconto**      | **Porcentagem** (de 1% a 100%) ou **Valor fixo** (em reais, até R$ 50.000,00).                                                                                                                 | **Porcentagem**                             |
| **Vale para**             | **Toda a loja**, **Categorias** ou **Produtos**. Com categorias ou produtos, escolha pelo menos 1 e no máximo 50.                                                                              | **Toda a loja**                             |
| **Compra mínima**         | O carrinho precisa chegar nesse valor para o cupom valer. Num cupom de valor fixo, a compra mínima não pode ser menor que o desconto.                                                          | Desligado: vale em qualquer valor           |
| **Limite de usos**        | Total de usos para todo mundo. Quando chega no número, o cupom fica **Esgotado**. De 1 a 1.000.000.                                                                                            | Desligado: ilimitado                        |
| **Por jogador**           | Quantas vezes cada jogador pode usar. De 1 a 1.000.                                                                                                                                            | Desligado: cada um usa quantas vezes quiser |
| **Só na primeira compra** | Só vale para quem nunca teve um pedido pago na loja.                                                                                                                                           | Desligado                                   |
| **Agendar início**        | O cupom só funciona a partir da data e hora de **Início**.                                                                                                                                     | Desligado: vale assim que for salvo         |
| **Data para acabar**      | O cupom para de funcionar sozinho na data e hora de **Fim**. Atalhos: **Amanhã**, **7 dias**, **15 dias**, **30 dias**. O fim precisa ser depois do início.                                    | Desligado: vale até você desativar          |
| **Nota interna**          | Texto que só a equipe vê (ex.: "parceria com o streamer X"). Até 120 caracteres. Também entra na busca.                                                                                        | Vazio                                       |

> Num cupom por **Categorias** ou **Produtos**, o desconto é calculado só sobre os itens escolhidos que estão no carrinho. Se nenhum deles estiver no carrinho, o jogador vê que o cupom "não vale para esses produtos".

A loja pode ter até 300 cupons. Para criar mais, exclua os antigos.

## Status do cupom

O status é calculado na hora, nesta ordem:

| Status         | Quando aparece                                                       |
| -------------- | -------------------------------------------------------------------- |
| **Desativado** | Você desativou o cupom. Ele para de funcionar, mas o histórico fica. |
| **Agendado**   | A data de início ainda não chegou.                                   |
| **Expirado**   | A data para acabar já passou.                                        |
| **Esgotado**   | O cupom chegou no **Limite de usos**.                                |
| **Ativo**      | Está valendo agora.                                                  |

Na lista, o filtro tem **Todos**, **Ativos**, **Agendados**, **Encerrados** (expirados e esgotados) e **Desativados**. A busca procura pelo código e pela nota.

## Gerenciar cupons

Na lista, cada linha mostra **Cupom**, **Desconto**, **Usos**, **Validade** e **Status**, além de onde vale (ex.: **Toda a loja**, **3 categorias**) e as condições (ex.: **primeira compra**, **1 por jogador**). Clique no código para copiar. No menu de ações da linha:

| Ação                       | O que faz                                                                       |
| -------------------------- | ------------------------------------------------------------------------------- |
| **Copiar código**          | Copia o código para você divulgar.                                              |
| **Editar**                 | Abre o cupom para mudar qualquer campo.                                         |
| **Duplicar**               | Abre um cupom novo com as mesmas regras, sem código e sem datas.                |
| **Ativar** / **Desativar** | Liga ou pausa o cupom sem perder o histórico.                                   |
| **Excluir**                | Apaga o cupom. O código para de funcionar na hora e isso não pode ser desfeito. |

> Para pausar um cupom que já foi usado, prefira **Desativar**. **Excluir** some com o cupom da lista.

## Como o jogador usa o cupom

**No site da loja:** no checkout, o jogador digita o código no campo **Cupom ou código de criador** e clica em **Aplicar**. O resumo mostra a linha **Cupom \[código]** com o desconto. Para tirar, ele clica em **Tirar o cupom \[código]**. No site, o cupom e o código de criador podem ser usados juntos.

**No Discord:** se a loja vende pelo Discord, o carrinho tem o botão **Cupom**, com as mesmas regras do site. Em **Loja → Canais de venda**, a opção **Cupons** liga ou desliga esse botão, e **Cupom e código juntos** define se o cupom e o código de criador se somam (desligado, usar um tira o outro). Veja [Canais de venda](https://fivedash.fivex.gg/docs/pt/store/sales-channels).

A ordem dos descontos é: primeiro as [ofertas](https://fivedash.fivex.gg/docs/pt/store/offers) (combos e quantidade), depois o cupom, depois o código de criador. O crédito da carteira é usado por último, no que sobra.

### O que o jogador vê quando o cupom não vale

| Situação          | Mensagem                                                  |
| ----------------- | --------------------------------------------------------- |
| Ainda não começou | O cupom \[código] ainda não começou a valer.              |
| Passou da data    | O cupom \[código] expirou.                                |
| Chegou no limite  | O cupom \[código] já esgotou.                             |
| Desativado        | O cupom \[código] não está valendo.                       |
| Já comprou antes  | O cupom \[código] é só para a primeira compra na loja.    |
| Usou o máximo     | Você já usou o cupom \[código] o máximo de vezes.         |
| Código não existe | Não encontramos esse código. Confira se digitou certinho. |

Se o carrinho ainda não chega na **Compra mínima**, o cupom fica guardado e começa a valer quando o carrinho chegar no valor.

### Quando um uso conta

O uso só conta quando o pagamento é aprovado. Enquanto um pedido espera pagamento, ele já segura uma vaga do **Limite de usos** e do **Por jogador**: se o limite for atingido contando esses pedidos, o jogador vê "O limite desse cupom foi atingido, incluindo pedidos aguardando pagamento."

## Números dos cupons

No topo da página:

| Cartão                         | O que mostra                                                                                                                                                            |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Vendido com cupom · 7 dias** | Vendas com cupom nos últimos 7 dias, comparadas aos 7 dias anteriores, com **Desconto dado**, **Pedidos com cupom** e **Retorno** (quanto vendeu por R$ 1 de desconto). |
| **Usos · 7 dias**              | Usos por dia na semana.                                                                                                                                                 |
| **Ativos agora**               | Quantos cupons valem agora, de quantos no total, e quantos acabam em 7 dias.                                                                                            |

Em cada linha da lista também aparece quanto o cupom deu de desconto, em quantos pedidos, e quanto vendeu.

## Perguntas frequentes

**O jogador digitou em minúsculas. Funciona?**
Sim. O código não diferencia maiúsculas de minúsculas: `bemvindo10` e `BEMVINDO10` são o mesmo cupom.

**Dá para dar desconto só nos VIPs?**
Sim. Em **Vale para**, escolha **Categorias** e marque a categoria dos VIPs, ou escolha **Produtos** e marque os VIPs um por um.

**Mudei o cupom. Quem já comprou é afetado?**
Não. A mudança vale para as próximas compras. Pedidos já feitos guardam o desconto que tiveram.

**Qual a diferença entre cupom e código de criador?**
O cupom é um desconto da loja. O código de criador é do programa de afiliados: dá um desconto ao comprador e conta a venda para o criador. Veja [Afiliados](https://fivedash.fivex.gg/docs/pt/store/affiliates).

## Próximos passos

[Ofertas](https://fivedash.fivex.gg/docs/pt/store/offers)Combos, upgrades e desconto por quantidade.
[Afiliados](https://fivedash.fivex.gg/docs/pt/store/affiliates)Códigos de criador com comissão.
[Canais de venda](https://fivedash.fivex.gg/docs/pt/store/sales-channels)Cupons no carrinho do Discord.
[Clientes](https://fivedash.fivex.gg/docs/pt/store/customers)Veja quem já usou cupom.
