> For the complete documentation index, see [llms.txt](https://ajuda.ensinio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.ensinio.com/vendas/checkout-externo/como-criar-um-cupom-de-desconto.md).

# Como criar um cupom de desconto

Cupons de desconto são uma forma eficiente de aumentar suas vendas e proporcionar uma experiência positiva para seus clientes. Este artigo explica como acessar a área de Cupons, criar um novo cupom e localizar cupons já existentes.

### Acessando a área de Cupons

Antes de criar um cupom, você precisa acessar a tela onde eles são gerenciados.

* Acesse **Vendas**, no menu lateral.
* Clique em **Cupons**.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FjHPPWuh2UgekfhdEdMG3%2Fimage.png?alt=media&amp;token=8edcc74a-6f36-4a5c-a45f-79822c369605" alt=""><figcaption></figcaption></figure>

Com a área localizada, o próximo passo é entender como criar um novo cupom.

Nessa tela são apresentados:

1. Gráficos que mostram um panorama geral do desempenho dos seus cupons:&#x20;
   1. Uso por dia
   2. Cupons mais utilizados
   3. Uso por item
2. Botão para Criar um novo cupom
3. Campos de pesquisa
4. Lista com todos os cupons criados com as seguinte informações:
   1. ID
   2. Tipo de desconto
   3. Desconto
   4. Quantidade
   5. Data de expiração
   6. Status

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FPt54l2X4HOFjl42p5tqm%2Fimage.png?alt=media&amp;token=e590655f-8e20-45a7-a975-2804c42a7a3f" alt=""><figcaption></figcaption></figure>

### Criando um novo cupom

Para começar, clique em **Novo Cupom**, no canto superior direito da tela. A criação é dividida em blocos de configuração, detalhados a seguir.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FfMSiKE3SpNjO7iQmXeGX%2Fimage.png?alt=media&amp;token=a131f149-3ec2-47cd-8ef7-7126c0f2d515" alt=""><figcaption></figcaption></figure>

Campos a serem preenchidos:

1. Nome
2. Personalização
3. Tipo de desconto
4. Desconto
5. Valor mínimo e máximo
6. Itens aceitos
7. Limite de usos de cupom
8. Permissão de uso
9. Status e validade

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FidJbr9RNMjM4l4Lag2xN%2Fimage.png?alt=media&amp;token=592c6794-c0b5-47b7-8315-1f395802d95b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FGRR28q3yHjctPuzR1leS%2Fimage.png?alt=media&amp;token=6fe73998-450b-4b7b-8717-6fac1661e08c" alt=""><figcaption></figcaption></figure>

#### **Informações básicas**

* Preencha o campo **Nome**, para identificar o cupom internamente.
* Defina o **Código**, que será o texto que o cliente vai inserir no checkout para aplicar o desconto.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FOCxpytAtxOzhFkciitUA%2Fimage.png?alt=media&amp;token=dd227f0c-7343-47c2-9660-19f5eda4d28d" alt=""><figcaption></figcaption></figure>

#### **Tipo e valor do desconto**

Com o cupom identificado, é hora de definir como o desconto será calculado.

* Escolha o **Tipo de desconto**: **Valor absoluto**, quando um valor fixo é subtraído do preço original, ou **Porcentagem**, quando um percentual é aplicado sobre o preço original.
* Informe o valor no campo **Desconto**.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2Flnbq3sY83X3Kn14rCLbg%2Fimage.png?alt=media&amp;token=73cbd1ae-da40-41e5-84ac-9f04e3cfb660" alt=""><figcaption></figcaption></figure>

#### **Valor mínimo e máximo**

Essa etapa é opcional, mas ajuda a controlar melhor o alcance do desconto.

* Ative o toggle **Limitar valores mínimo e máximo** caso queira restringir a aplicação do cupom com base em um valor mínimo de compra e um teto de desconto.
* Preencha o campo **Valor mínimo de compra**, se essa opção estiver ativada.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FR77FABqxBmnYGPfFZFMi%2Fimage.png?alt=media&amp;token=9be3befa-6132-40ff-b472-80c92de8a4b3" alt=""><figcaption></figcaption></figure>

#### **Itens aceitos**

Depois de definir o valor do desconto, você pode decidir em quais produtos ele será válido.

* Ative o toggle **Personalizar itens aceitos** caso o cupom deva valer apenas para determinados grupos.
* Selecione os grupos desejados no campo **Grupos Aceitos**. Esse campo é obrigatório quando a personalização está ativada.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FkjH0x8i3Wwq4GSsHQVDi%2Fimage.png?alt=media&amp;token=7e9940f1-f92a-44df-beb2-12c26dde3615" alt=""><figcaption></figcaption></figure>

#### **Limite de usos do cupom**

Com os itens definidos, você também pode controlar quantas vezes o cupom pode ser utilizado.

* Ative **Quantidade limite do cupom** para definir, no campo **Quantidade limite**, o número total de vezes que o cupom pode ser usado.
* Ative **Máximo de usos por cliente** para definir, no campo **Máximo de Usos**, quantas vezes um mesmo cliente pode utilizar o cupom.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FLKfLbPZV9vmecbl5l3C2%2Fimage.png?alt=media&amp;token=bd63eda3-eb05-45fb-8316-623d727ee80d" alt=""><figcaption></figcaption></figure>

#### **Permissão de uso**

Além de limitar a quantidade de usos, é possível restringir quem pode utilizar o cupom.&#x20;

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FwzgwlyeQ1sF19mlWZS4S%2Fimage.png?alt=media&amp;token=8a7c5b74-fc8a-4486-ab5a-d40fe1aae24c" alt=""><figcaption></figcaption></figure>

No campo **Permissão de Acesso**, escolha entre:

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FLA7gvUDDuK8iqgSwNCru%2Fimage.png?alt=media&amp;token=328d24b6-ebff-4327-9a87-65a1d12167b8" alt=""><figcaption></figcaption></figure>

* **Todos**, sem nenhuma restrição de usuário.

* **Usuários específicos**, exigindo que você selecione os usuários no campo **Pesquisar Usuários**.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2F5yk67G0TV6QVKj2uTONq%2Fimage.png?alt=media&amp;token=f057adb3-cdb1-45bb-9e6e-7727d137b63c" alt=""><figcaption></figcaption></figure>

* **Apenas usuários com acesso a determinado conteúdo**, exigindo que você selecione o grupo correspondente.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FkXpWsl7le1cimzWUxSmu%2Fimage.png?alt=media&amp;token=8b52b100-ec03-47a9-9901-2d8bfc7ccf1f" alt=""><figcaption></figcaption></figure>

* **Apenas usuários que já tiveram acesso a determinado conteúdo**, também exigindo a seleção de um grupo.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FBBUgm6TZqKL3OnM7cBSK%2Fimage.png?alt=media&amp;token=19a5b61e-fad1-4ccd-b0cc-c64a83c6cd2d" alt=""><figcaption></figcaption></figure>

#### **Status e validade**

Por fim, defina se o cupom já deve estar disponível para uso e até quando.

* Use o toggle **Status** para ativar ou inativar o cupom.
* Preencha o campo **Quando o cupom irá expirar?** com a data de validade desejada.

Com todos os blocos preenchidos, clique em **Confirmar** para salvar o cupom, ou em **Cancelar** caso queira desistir da criação.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2Ff1RkEzk6wMzk1h2KPSVT%2Fimage.png?alt=media&amp;token=87d368d4-00c9-4297-b961-513645b50975" alt=""><figcaption></figcaption></figure>

### Localizando cupons já criados

Depois de criar seus cupons, você vai precisar encontrá-los rapidamente. Para isso, a tela principal de Cupons oferece algumas formas de busca.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2Fnno4h7mUHO6bXFvNG3DP%2Fimage.png?alt=media&amp;token=3bad19d4-d778-4a27-8659-8e7502fcebf2" alt=""><figcaption></figcaption></figure>

* Use o campo **Pesquisar por código, nome ou ID** para localizar um cupom específico.
* Utilize o campo **Data de expiração** para filtrar cupons por período de validade.
* Clique no ícone de filtro, ao lado do campo de data, para refinar ainda mais a busca. Esse filtro avançado permite combinar:
  * **Tipo de desconto**: Valor absoluto ou Porcentagem.
  * **Permissão de uso**: Todos, Clientes específicos, Clientes com acesso a determinado grupo ou Clientes que já tiveram acesso a determinado grupo.
  * **Quantidade por página**, para ajustar quantos cupons são exibidos por vez na listagem.

<figure><img src="https://2259447927-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwebm0QbRMYk9AEqv2lsa%2Fuploads%2FEkY8WMmfNqZNSIJeV8l4%2Fimage.png?alt=media&amp;token=1164874b-8d49-4930-919f-9bdf41a4b516" alt=""><figcaption></figcaption></figure>

Com esses filtros combinados, fica mais fácil gerenciar seus cupons, mesmo quando a lista cresce com o tempo.

### Cupom aplicado via URL

Quem nunca recebeu um chamado de suporte de um aluno dizendo que não está conseguindo aplicar o cupom, e ao verificar percebeu que ele estava digitando o código errado? É raro, mas pode acontecer com uma certa frequência.

Se você não quer ter esse tipo de problema, o cupom aplicado via URL é perfeito para você. Essa funcionalidade permite aplicar automaticamente o desconto ao acessar o checkout por meio de uma URL que já contenha o código do cupom.

Você só precisa adicionar ao link direto do checkout o parâmetro:

```
coupon: Este parâmetro permite especificar o código do cupom que você deseja que seja aplicado. Ao incluir este parâmetro na URL do checkout, o desconto associado ao código do cupom será automaticamente aplicado.
```

O link direto para o checkout com o cupom ficaria nesse formato:

[www.seuDominio.com/g/payment/exemploCodigo?coupon=exemplo10](https://www.seuDominio.com/g/payment/exemploCodigo?coupon=exemplo10)

Você também pode combinar parâmetros de autopreenchimento com o cupom, e a URL ficaria assim:

[www.seuDominio.com/g/payment/exemploCodigo?coupon=matheus10\&name=seu-nome\&email=seuemail@email.com\&phone=40028922\&document=99900099900](https://www.seuDominio.com/g/payment/exemploCodigo?coupon=matheus10\&name=seu-nome\&email=seuemail@email.com\&phone=40028922\&document=99900099900)

Importante: o autopreenchimento só funciona em cupons que não possuem restrições de uso, seja por usuários específicos ou por acesso a determinados conteúdos.

Se restar alguma dúvida sobre como aplicar recorra ao suporte técnico, por favor.

### Perguntas frequentes

#### **Qual a diferença entre desconto em valor absoluto e em porcentagem?**

No valor absoluto, um valor fixo é subtraído do preço original do produto — por exemplo, R$ 10 de desconto. Já na porcentagem, um percentual é aplicado sobre o preço original, então o valor do desconto varia conforme o preço de cada produto.

#### **É obrigatório limitar o cupom a grupos específicos?**

Não. A opção **Personalizar itens aceitos** é opcional. Se você não ativar esse toggle, o cupom pode ser aplicado sem essa restrição de grupo. Caso ative, o campo **Grupos Aceitos** se torna obrigatório.

#### **Posso deixar um cupom sem data de expiração?**

O campo **Quando o cupom irá expirar?** define até quando o cupom fica válido. Se você não quer que ele expire em uma data específica, é importante conferir esse campo com atenção antes de confirmar, já que ele controla a validade do cupom.

#### **Qual a diferença entre "Quantidade limite do cupom" e "Máximo de usos por cliente"?**

A **Quantidade limite do cupom** controla o total de vezes que o cupom pode ser usado, somando todos os clientes. Já o **Máximo de usos por cliente** limita quantas vezes um mesmo cliente pode utilizar esse cupom individualmente. Os dois podem ser ativados juntos.

#### **Como faço para encontrar um cupom específico que já criei?**

Use o campo de pesquisa por código, nome ou ID, na tela principal de Cupons. Se precisar refinar ainda mais a busca, o ícone de filtro permite combinar tipo de desconto e permissão de uso, além de ajustar quantos cupons aparecem por página.

#### **É possível aplicar um cupom automaticamente, sem o aluno precisar digitar o código do cupom?**

Sim. Você pode aplicar o cupom diretamente via URL do checkout. Veja como configurar na seção [Cupom aplicado via URL](#cupom-aplicado-via-url).
