Cupons
Crie códigos de desconto e habilite seu uso no checkout.
Um cupom aplica um desconto quando o comprador informa um código. Uma promoção automática avalia suas condições sem exigir um código. Configure a compatibilidade antes de oferecer os dois benefícios juntos.
Criar um cupom
Você precisa de acesso para gerenciar cupons na conta e no ambiente ativos.
- Abra Cobranças → Cupons e selecione Criar cupom.
- Informe um código único, como
BOASVINDAS10, e uma descrição opcional. Os códigos são salvos em maiúsculas, sem espaços no início ou no fim. - Escolha um desconto percentual ou fixo e informe o valor.
- Para um valor fixo ou compra mínima, escolha a moeda. A compra deve usar essa moeda; não há conversão automática. Um cupom percentual sem condições monetárias não fica limitado a uma moeda.
- Se necessário, selecione produtos participantes, compra mínima, usos máximos e datas de início e fim.
- Mantenha o cupom ativo quando ele deve estar disponível e salve.
O cupom aparece na lista com sua configuração e uso. Sem produtos selecionados, não há restrição de produto. Com uma seleção, o carrinho deve conter um produto participante. Essa condição não garante que o desconto seja calculado apenas sobre suas linhas: confira o total final ao combinar itens.
A data final inclui o dia de calendário escolhido. Os usos máximos limitam as aplicações disponíveis; compras pendentes podem reservar disponibilidade, portanto o limite não equivale simplesmente a pagamentos confirmados.
Habilitar e testar
- Crie ou edite o link de pagamento.
- Ative Permitir cupons na seção de promoções e salve.
- Inicie uma nova tentativa no Sandbox, informe o código e confira o desconto e total final.
- Teste um carrinho ou moeda não participante e uma oferta com outros descontos antes de compartilhar o código.
Para carrinhos criados por API, use a configuração admitida pela referência de Checkout Sessions. Criar um cupom não habilita automaticamente o campo em todos os checkouts.
Editar ou interromper um código
Use as ações do cupom para editar ou excluir. Desative-o para interromper sua elegibilidade sem removê-lo da lista. Confira datas e limites antes de reativar. Editar um cupom não modifica descontos registrados em faturas anteriores.
Problemas frequentes
- Código já existe: edite o cupom existente ou escolha outro código no ambiente atual.
- Campo não aparece: confira se a oferta permite cupons e inicie uma nova sessão após alterar o link.
- Código é rejeitado: confira ativação, datas, usos disponíveis, moeda, compra mínima e produtos participantes.
- Outro benefício impede o cupom: confira a acumulação com cupons da promoção e Como combinar descontos.
- Desconto diferente do esperado: confira a base do cálculo final; um cupom nunca reduz o valor a pagar abaixo de zero.