Cupons de desconto para comunidades pagas
Cupons percentuais ou de valor fixo com limites de uso, faixas de gasto, restrições por membro e por plano, e um cronograma. Os membros digitam o cupom no checkout.
Um cupom de desconto permite que um membro pague menos no checkout digitando um código como LAUNCH20. No Arcalotl você controla o valor do cupom, por quanto tempo ele se aplica, quem pode usar, em quais planos funciona e entre quais datas é válido.
Os cupons funcionam em planos recorrentes e em compras únicas. Doações não aceitam cupons de desconto.
Os descontos não mudam como o Arcalotl cobra você. A taxa é de 2% de cada pagamento aprovado, então um pagamento com desconto carrega uma taxa menor, e não há custo mensal de qualquer forma.
Percentual ou valor fixo
Um cupom desconta ou um percentual de 1 a 100 ou um valor fixo em uma moeda. Um cupom de valor fixo só se aplica a planos com preço nessa mesma moeda, então um cupom de 5,00 EUR não se aplica em silêncio a um plano com preço em dólares.
Duração em planos recorrentes
Em uma assinatura você escolhe por quanto tempo o desconto dura: só o primeiro pagamento, um número definido de meses ou para sempre. Um cupom de primeiro pagamento desconta a primeira fatura, um cupom repetido desconta os meses que você configurou, e um cupom para sempre se aplica a toda renovação. Compras únicas sempre aplicam o desconto uma vez.
Limites de uso que não podem ser vendidos a mais
Um limite de uso restringe o total de resgates entre todos os membros, e deixá-lo em branco significa usos ilimitados. Um checkout em andamento segura uma vaga até ser concluído ou expirar, então um cupom limitado a 50 usos nunca pode ser resgatado 51 vezes por checkouts em paralelo.
Gasto mínimo e máximo
As faixas de gasto decidem quais preços um cupom alcança, na moeda do plano. Um mínimo de 10,00 faz o cupom funcionar só em compras de 10,00 ou mais. Um máximo mantém o cupom nos seus itens mais baratos. Os dois são opcionais.
Restrito a membros específicos
Um cupom pode ser limitado a membros que você escolhe na lista de membros do seu servidor, o que o transforma em uma oferta privada para essas pessoas. Sem membros selecionados, qualquer pessoa que tenha o cupom pode usar.
Restrito a planos específicos
Um cupom pode ser limitado aos planos escolhidos. Sem nada selecionado, ele funciona em todos os planos do seu catálogo, então um cupom de lançamento amplo e um cupom de upgrade para um único plano são o mesmo recurso com uma restrição diferente.
Início e expiração agendados
Uma data de início decide quando um cupom fica ativo e uma data de expiração decide quando ele para de funcionar. Sem definir significa ativo imediatamente e sem expiração. É assim que um cupom sazonal entra no ar e termina sem ninguém precisar estar acordado.
Claro no checkout
A página de checkout mostra um link de cupom de desconto sempre que a sua comunidade tem pelo menos um cupom ativo. Um cupom válido atualiza o total na hora e mostra a linha de redução. Um cupom rejeitado explica o motivo, por exemplo que expirou, ainda não começou ou está abaixo do gasto mínimo, sem revelar nada sobre os seus outros cupons.
Edições se aplicam a checkouts futuros
Alterar um cupom nunca afeta um checkout que já está aberto, que mantém o desconto com o qual foi aberto. Arquivar um cupom interrompe novos resgates imediatamente e mantém o histórico de resgates, e checkouts já em andamento ainda são concluídos. Um cupom não pode ser renomeado depois de criado.
Uso que você consegue ler
A tabela de Descontos mostra os resgates de cada cupom em relação ao limite de uso, as restrições e o estado atual: ativo, agendado, expirado, esgotado ou desativado. Compras únicas registram o valor com desconto que o comprador realmente pagou, então as análises de receita continuam precisas.
Painel, API e MCP
Os cupons são criados e editados na página Descontos do painel. A API pública expõe GET /v1/discounts com restrições, cronograma e contagem de resgates sob o escopo discounts:read, e POST /v1/checkout-links aceita um discount_code para associar um cupom a um link que você gera. O servidor MCP expõe a mesma listagem como a ferramenta list_discounts, então um assistente pode relatar os cupons sem poder alterá-los.
O que você define em um cupom
| Configuração | O que faz | Se deixar em branco |
|---|---|---|
| Código | Até 64 letras, números, sublinhados ou hífens. Não diferencia maiúsculas e é único por comunidade | Obrigatório |
| Valor | Um percentual de 1 a 100, ou um valor fixo em uma moeda | Obrigatório |
| Duração | Só o primeiro pagamento, repetido por um número de meses, ou para sempre | Obrigatório em planos recorrentes |
| Limite de uso | Total de resgates entre todos os membros | Usos ilimitados |
| Gasto mínimo | O menor preço de plano ao qual o cupom se aplica | Sem limite inferior |
| Gasto máximo | O maior preço de plano ao qual o cupom se aplica | Sem limite superior |
| Membros | Limita o cupom a membros escolhidos da sua lista de membros | Todo mundo pode usar |
| Planos | Limita o cupom aos planos escolhidos | Funciona em todos os planos |
| Data de início | Quando o cupom fica ativo | Ativo imediatamente |
| Data de expiração | Quando o cupom para de funcionar | Nunca expira |
O que os cupons de desconto não fazem
Doações não aceitam cupons de desconto. Um bloco ou comando de doação recebe o valor que o membro escolhe, e um cupom digitado ali não faz nada.
Um cupom de valor fixo está atrelado à sua moeda. Ele se aplica só a planos com preço na mesma moeda, então uma comunidade que vende em várias moedas precisa de um cupom de valor fixo por moeda, ou de um cupom percentual no lugar.
Um cupom não pode ser renomeado depois que existe, porque o próprio código é o que os membros digitaram e contra o que o seu histórico de resgates é registrado. Para mudar o texto de uma oferta, crie um cupom novo e arquive o antigo.
A API e o servidor MCP são somente leitura para descontos. Criar, editar e arquivar acontecem no painel.
Perguntas
Leia a seguir
Lance o seu primeiro cupom
Os cupons de desconto fazem parte do Arcalotl sem custo extra. Crie um na página Descontos e compartilhe onde os seus membros estiverem.
Abrir o painel