Códigos promocionais: como criar, configurar e usar descontos
Introdução
Os Códigos promocionais são uma forma eficiente de oferecer descontos aos usuários, incentivar novas assinaturas ou recompensar clientes existentes. No eDirectory, os códigos promocionais podem ser configurados para oferecer um desconto percentual ou um desconto de valor fixo em planos.
Este artigo explica como os Códigos promocionais funcionam, como criá-los, como sua duração interage com o ciclo de cobrança do plano e como evitar erros comuns de configuração.
Etapa 1: Acessar os Códigos promocionais
1.1. Logue em sua área administrativa.
1.2. Navegue até Configurações > Produtos & Planos > Gerenciar Códigos Promocionais
É nesta área que você pode criar e gerenciar os Códigos promocionais disponíveis em seu site.
Etapa 2: Adicionar um Código promocional
2.1. Clique em Adicionar Código Promocional.
2.2. Uma janela será aberta com os campos que você precisa configurar.
As etapas a seguir explicam cada campo na mesma ordem em que ele aparece na janela do Código promocional.
Etapa 3: Configurar seu Código promocional
3.1. Insira o Código
No campo Código, insira o código que os usuários deverão digitar durante o checkout.
Você pode criar qualquer código exclusivo que seja fácil de lembrar para seus usuários.
Por exemplo:
- BEMVINDO20
- VERAO50
- ECONOMIZE20
Por exemplo, se você criar o código ECONOMIZE20, os usuários poderão inserir ECONOMIZE20 durante o checkout para receber o desconto configurado.
3.2. Escolha o Tipo de Desconto
Em Tipo, escolha como deseja oferecer o desconto.
Existem duas opções:
- Porcentagem – oferece ao usuário um desconto percentual sobre o preço do plano.
- Valor Fixo – desconta um valor específico do preço do plano.
Por exemplo:
Porcentagem: 20% de desconto em um plano de R$50 = R$40
Valor Fixo: R$10 de desconto em um plano de R$50 = R$40
3.3. Insira o Valor
No campo Valor, insira o valor do desconto.
O valor depende do tipo de desconto selecionado.
Se você selecionou Porcentagem, insira a porcentagem sem o símbolo % .
Por exemplo:
20 = 20% de desconto
Se você selecionou Valor Fixo, insira o valor que deseja descontar.
Por exemplo:
10 = R$10 de desconto
3.4. Escolha a Duração
O campo Duração determina por quanto tempo o usuário poderá receber o desconto depois de resgatar o código.
Existem duas opções:
- Uma vez
- Infinito
Uma vez
Escolha Uma vez se quiser que o usuário receba o desconto apenas uma vez.
Por exemplo, se você criar um desconto de 50% com Uma vez e o usuário tiver um plano mensal:
- Primeiro mês → 50% de desconto
- Segundo mês → preço normal
- Terceiro mês → preço normal
| Período de cobrança | Preço normal | Preço com desconto |
|---|---|---|
| Mês 1 | R$30 | 50% → R$15 |
| Mês 2 | R$30 | Nenhum → R$30 |
| Mês 3 | R$30 | Nenhum → R$30 |
O usuário não poderá usar o mesmo Código promocional novamente no mês seguinte.
Isso continua valendo mesmo que a data Resgatado até ainda esteja no futuro.
Infinito
Escolha Infinito se quiser que o Código promocional continue disponível para o usuário em compras posteriores enquanto o código permanecer válido.
Por exemplo, se você criar um desconto de 50% com Infinito e o usuário tiver um plano mensal, ele poderá continuar aplicando o desconto de 50% nas compras mensais seguintes manualmente.
- Primeiro mês → 50% de desconto
- Segundo mês → 50% de desconto
- Terceiro mês → 50% de desconto
- E assim por diante...
| Período de cobrança | Preço normal | Preço com desconto |
|---|---|---|
| Mês 1 | R$30 | 50% →R$15 |
| Mês 2 | R$30 | 50% → R$15 |
| Mês 3 | R$30 | 50% → R$15 |
| Mês 4 | R$30 | 50% → R$15 |
O desconto continuará sendo aplicado enquanto o Código promocional permanecer válido.
No entanto, há um detalhe importante relacionado à Cobrança Automática: a opção de duração infinita somente pode ser usada para compras subsequentes se a opção Cobrança Automática estiver desabilitada em Configurações > Produtos & Planos > Configurações Adicionais e Gateways de Pagamento.
Quando a Cobrança Automática estiver desativada, o usuário terá a oportunidade de realizar cada compra mensal manualmente. Assim, ele poderá aplicar o Código promocional novamente na próxima compra, desde que o código ainda seja válido.
Quando a Cobrança Automática estiver ativada, os pagamentos futuros do plano serão cobrados automaticamente. Como o usuário não retorna ao checkout para realizar uma nova compra e inserir novamente o Código promocional, o código será aplicado somente à primeira compra.
Importante: Infinito não significa que o desconto durará para sempre. O Código promocional deixará de ser válido quando a data Resgatado até for atingida e, para continuar recebendo o desconto nos meses seguintes, o usuário deverá aplicar o código novamente a cada mês.
3.5. Defina a Data Resgatado até
O campo Resgatado até determina a última data em que um usuário poderá resgatar o Código promocional.
Por exemplo, se você definir:
Resgatado até: 30/06/2027
Os usuários poderão resgatar o código até essa data.
Depois que essa data passar, o código não poderá mais ser resgatado.
A Data Resgatado até NÃO determina o período gratuito ou de desconto
Este é um dos pontos mais importantes para entender sobre os Códigos promocionais.
A data Resgatado até é simplesmente a data de expiração do Código promocional. Ela não determina por quanto tempo um usuário receberá o desconto.
Por exemplo, imagine que você crie um Código promocional hoje e defina:
- Duração: Infinito
- Resgatado até: seis meses a partir de hoje
Isso não significa que todos os usuários que receberem o código terão seis meses de desconto.
Um usuário que resgatar o código hoje poderá utilizá-lo durante o período disponível, enquanto outro usuário que receber e resgatar o mesmo código daqui a dois meses terá menos tempo antes que o código expire.
O Código promocional não calcula o período de validade com base na data em que cada usuário assinou. Ele utiliza uma única data Resgatado até, configurada para o código.
Por esse motivo, os Códigos promocionais não devem ser usados quando sua intenção for oferecer a todos os usuários uma quantidade específica de tempo gratuito ou com desconto, como:
- 3 meses grátis
- 6 meses grátis
- 10 meses grátis
- 1 ano grátis
Quando devo usar um período de teste gratuito?
Se sua intenção é oferecer a cada usuário um período de teste específico, recomendamos usar o recurso de Teste Gratuito disponível por meio da integração com o Stripe.
Por exemplo, se você configurar um período de teste gratuito de 6 meses, o eDirectory/Stripe usará a data em que cada usuário inicia seu plano para determinar quando o período de teste individual termina.
Isso significa:
- O usuário A assina hoje → o período de teste de 6 meses começa hoje.
- O usuário B assina dois meses depois → o período de teste de 6 meses começa dois meses depois.
- Cada usuário recebe o período completo de 6 meses.
- Quando o período de teste termina, o usuário é cobrado automaticamente de acordo com o plano.
Isso é diferente de um Código promocional, pois o Código promocional possui uma única data fixa de Resgatado até, em vez de calcular um período de teste separado para cada usuário com base na data em que ele assinou.
Recomendação: Use Códigos promocionais quando quiser oferecer um desconto que esteja disponível até uma data específica. Use o recurso de Teste Gratuito do Stripe quando quiser que todos os usuários recebam um período gratuito específico, como 3 meses, 6 meses, 10 meses ou 1 ano. Confira abaixo o artigo com as instruções passo a passo para configurar o período de teste gratuito do Stripe.
3.6. Aplique o Código a Planos Específicos
A opção Aplicar para planos específicos permite controlar quais planos podem utilizar o Código promocional.
Se essa opção estiver desativada, o Código promocional poderá ser utilizado com os planos disponíveis.
Se você ativá-la, poderá selecionar os planos específicos nos quais o Código promocional estará disponível.
Por exemplo, você pode criar um código que funcione apenas no plano Diamante e não no plano Bronze.
Etapa 4: Salvar o Código promocional
Depois de configurar todos os campos, clique em Salvar alterações.
Seu Código promocional estará configurado de acordo com as opções selecionadas.
Você poderá então fornecer o código aos seus usuários para que eles possam inseri-lo durante o checkout.
Etapa 5: Como o Código promocional funciona no checkout
Quando um usuário assina um plano elegível, ele poderá inserir o Código promocional durante o checkout.
O sistema verifica o Código promocional e aplica o desconto se ele for válido.
Para que o código funcione, as seguintes condições devem ser atendidas:
- O código deve estar Ativo.
- A data Resgatado até não pode ter passado.
- O plano selecionado deve ser elegível para o código.
- O usuário não pode já ter usado o código se a Duração estiver definida como Uma vez.
- O código deve ser inserido corretamente.
Saiba mais sobre as etapas necessárias para que o usuário chegue à página de checkout e aplique o Código promocional neste artigo: Como adicionar um anúncio como anunciante
Exemplos práticos
Veja alguns exemplos simples para entender como as configurações funcionam em conjunto.
Exemplo 1: 20% de desconto no primeiro mês
Você deseja oferecer aos novos usuários 20% de desconto no primeiro mês.
Configure o Código promocional da seguinte forma:
- Código: WELCOME20
- Tipo: Porcentagem
- Valor: 20
- Duração: Uma vez
- Resgatado até: 30/06/2027
- Status: Ativo
- Aplicar para planos específicos: Desativado
- Ciclo de cobrança: Mensal
O usuário resgata o código antes de 30 de junho de 2027.
Ele receberá:
Primeiro mês: 20% de desconto
Segundo mês: Preço normal
Terceiro mês: Preço normal
A data de 30 de junho de 2027 determina apenas até quando o código estará disponível para resgate.
Exemplo 2: Código promocional vs. período de teste gratuito
Suponha que você queira oferecer 6 meses grátis para todos os novos usuários.
Pode parecer lógico criar um Código promocional com:
- Tipo: Porcentagem
- Valor: 100%
- Duração: Infinito
- Resgatado até: seis meses a partir de hoje
No entanto, isso não produzirá o resultado esperado.
A data Resgatado até é a mesma para todos os usuários que utilizarem o código. Ela não é alterada com base na data em que cada usuário assina.
Por exemplo:
- O usuário A usa o código hoje → poderá utilizá-lo enquanto o código permanecer válido.
- O usuário B usa o código daqui a dois meses → terá apenas o tempo restante até a data Resgatado até.
- O usuário C usa o código daqui a cinco meses → terá ainda menos tempo antes que o código expire.
Portanto, o Código promocional não garante que todos os usuários receberão seis meses grátis.
A solução recomendada
Se o objetivo é oferecer 6 meses grátis para todos os novos usuários, use o recurso Período de Teste Gratuito do Stripe.
Ele calcula o período de teste com base na data em que cada usuário assina. Isso garante que cada usuário receba o período completo configurado antes que a cobrança automática comece.
O mesmo princípio se aplica se você quiser oferecer:
3 meses grátis, 6 meses grátis, 10 meses grátis, 1 ano grátis ou qualquer outro período de teste fixo.
Código promocional = desconto disponível até uma data específica.
Free Trial (Teste Gratuito) = período gratuito específico para cada usuário.
Para uma promoção na qual os usuários devem receber um período gratuito específico, como seis meses, recomendamos usar o recurso de Teste Gratuito disponível por meio da integração com o Stripe. Consulte o artigo da base de conhecimento abaixo:
Configurações do Código promocional em resumo
| Configuração | O que significa |
|---|---|
| Código | O código que os usuários inserem durante o checkout |
| Porcentagem | Oferece um desconto percentual |
| Valor Fixo | Desconta um valor específico |
| Valor | O valor do desconto |
| Uma vez | O desconto é aplicado somente à primeira compra do usuário |
| Infinito | O desconto pode continuar sendo aplicado a compras manuais posteriores enquanto o código permanecer válido |
| Resgatado até | A data após a qual o Código promocional não poderá mais ser resgatado |
| Aplicar para planos específicos | Limita o código aos planos selecionados |
| Cobrança Automática ativada | Os pagamentos futuros do plano são cobrados automaticamente, portanto o Código promocional não é inserido novamente |
| Cobrança Automática desativada | Os usuários podem fazer compras posteriores manualmente e aplicar novamente um Código promocional válido |
| Período de teste gratuito do Stripe | Oferece a cada usuário um período gratuito específico com base na data em que ele iniciou seu plano |
Solução de problemas
O usuário esperava receber um determinado número de meses grátis
Se o usuário esperava receber 3 meses, 6 meses, 10 meses ou 1 ano grátis, verifique se foi utilizado um Código promocional em vez de um Teste Gratuito do Stripe.
A data Resgatado até determina apenas por quanto tempo o Código promocional estará disponível para ser resgatado pelos usuários. Ela não determina por quanto tempo um usuário receberá o desconto.
Para oferecer um período gratuito fixo, recomendamos usar o recurso Teste Gratuito disponível por meio da integração com o Stripe. O período de teste é calculado a partir da data em que cada usuário assina, garantindo que cada usuário receba o período completo configurado.
Base de conhecimento: Como ativar o Stripe em meu eDirectory
O desconto foi aplicado somente à primeira compra
Primeiro, verifique a configuração de Duração.
Se estiver definida como Uma vez, é esperado que o desconto seja aplicado somente à primeira compra.
Se estiver definida como Infinito, verifique também se a Cobrança Automática está ativada.
Quando a Cobrança Automática está ativada, os pagamentos futuros do plano são cobrados automaticamente. Como o usuário não retorna ao checkout para inserir novamente o Código promocional, o código será aplicado somente à primeira compra.
Se a Cobrança Automática estiver desativada, os usuários poderão fazer compras posteriores manualmente e aplicar novamente o Código promocional, desde que o código ainda seja válido.
Você pode verificar essa configuração em:
Configurações > Produtos & Planos > Configurações Adicionais e Gateways de Pagamento
O usuário esperava que o desconto continuasse todos os meses
Verifique as seguintes configurações:
- Duração
- Resgatado até
- Cobrança Automática
Para que o desconto seja aplicado em compras manuais posteriores:
- A Duração deve estar definida como Infinito.
- O Código promocional ainda deve ser válido e estar dentro da data Resgatado até.
- A Cobrança Automática deve estar desativado, para que o usuário possa realizar a próxima compra manualmente e inserir o código novamente.
Se a Cobrança Automática estiver ativada, o plano será cobrado automaticamente e o usuário não terá a oportunidade de inserir novamente o Código promocional.
Importante: Infinito não significa automaticamente que o desconto será aplicado a todas as renovações automáticas do plano. Ele permite que o código continue sendo usado em compras posteriores enquanto permanecer válido.
O Código promocional não pode ser resgatado
Verifique o seguinte:
- O Código promocional está definido como Ativo.
- A data Resgatado até ainda não passou.
- O usuário inseriu o código corretamente.
- O plano selecionado é elegível para o Código promocional.
- O usuário não utilizou o código anteriormente se a Duração estiver definida como Uma vez.
- Se estiver usando Infinito, certifique-se de que o usuário esteja realizando uma nova compra na qual o código possa ser inserido novamente.
O código não funciona com um plano específico
Verifique a configuração Aplicar para planos específicos.
Se essa opção estiver ativada, o Código promocional estará disponível somente para os planos selecionados na configuração.
Se o plano do usuário não estiver incluído, o código não será aplicado a esse plano.
O usuário assinou depois que o Código promocional foi criado, mas não recebeu o período gratuito esperado
Lembre-se de que o Código promocional não calcula uma data de expiração diferente para cada usuário.
Por exemplo, se o código tiver uma data Resgatado até definida para seis meses a partir de hoje, um usuário que resgatar o código hoje e outro que o resgatar daqui a dois meses não necessariamente terão a mesma quantidade de tempo disponível para utilizar o código.
O Código promocional sempre utiliza a mesma data Resgatado até configurada pelo Administrador do site.
Se todos os usuários devem receber o mesmo período gratuito fixo a partir da data em que cada um inicia seu plano, use o recurso Teste Gratuito do Stripe.
Base de conhecimento: Como ativar o Stripe em meu eDirectory
Conclusão
Os Códigos promocionais foram desenvolvidos para oferecer descontos em compras de planos, enquanto o recurso de Teste Gratuito do Stripe foi desenvolvido para oferecer aos usuários um período gratuito específico com base na data individual em que cada um inicia seu plano.
Para evitar confusão, lembre-se:
Resgatado até = A última data em que o Código promocional pode ser resgatado.
Uma vez = O desconto é aplicado somente uma vez ao usuário.
Infinito = O desconto pode continuar sendo usado em compras manuais posteriores enquanto o código permanecer válido.
Auto Bill ativado = Os pagamentos futuros do plano são cobrados automaticamente, portanto o usuário não poderá inserir novamente o Código promocional nesses pagamentos.
Teste Gratuito = Um período gratuito específico calculado a partir da data em que cada usuário inicia seu plano.
Mais importante: não use a data Resgatado até para criar um período gratuito de 3 meses, 6 meses, 10 meses ou 1 ano. O Código promocional não calcula o período gratuito com base na data em que cada usuário inicia seu plano.
Se seu objetivo é oferecer a todos os novos usuários a mesma quantidade de tempo gratuita, como 6 meses grátis, recomendamos usar o recurso Teste Gratuito disponível por meio da integração com o Stripe. Esse recurso calcula o período de teste a partir da data em que cada usuário inicia seu plano e começa automaticamente a cobrança quando o período de teste termina.
Base de conhecimento: Como ativar o Stripe em meu eDirectory