Pular para o conteúdo principal
Capa da visão geral dos códigos de desconto
Os códigos de desconto permitem que você execute promoções e incentivos direcionados. Crie descontos percentuais ou de valor fixo, defina limites e datas de expiração, restrinja a produtos e aplique-os de forma integrada no checkout.

Sessões de Checkout

Aplique códigos durante o checkout hospedado com discount_code e controles de UI.

Validar Desconto

Verifique se um desconto é válido pelo seu ID.

Obter Desconto pelo Código

Procure e valide um desconto usando seu código (por exemplo, “SAVE20”).

Criar Desconto (API)

Crie códigos de desconto novos programaticamente.

Listar & Atualizar Descontos

Navegue e gerencie descontos existentes; atualize ou exclua conforme necessário.

​
O que são Códigos de Desconto?

Códigos de desconto são tokens promocionais que reduzem os totais de pedidos no checkout. Eles são ideais para:
  • Campanhas sazonais: Black Friday, lançamentos de produtos ou aniversários
  • Ofertas de aquisição: Incentivos para primeira compra ou recompensas de indicação
  • Retenção: Recompensas de recuperação ou fidelidade para clientes existentes
  • Negócios B2B: Preços contratados ou negociados via códigos privados

​
Principais Benefícios

  • Descontos flexíveis: Percentual ou valor fixo de desconto
  • Controle direcionado: Restringir por produto e ciclos de assinatura
  • Governança de campanha: Datas de expiração e limites de uso
  • Checkout sem interrupções: Suporte a campo de UI e API via sessões de checkout

​
Criando Códigos de Desconto

Crie códigos de desconto no seu painel do Dodo Payments e, em seguida, aplique-os no checkout hospedado ou via API.

​
Configuração do Painel

  • Nome do Desconto (obrigatório): Nome interno e de exibição no painel
  • Código (obrigatório): A string que os clientes inserem no checkout
  • Tipo & Valor (obrigatório): Defina um valor percentual ou fixo, ou gere um código aleatório usando o botão fornecido
  • Data de Expiração (opcional): Data após a qual o código se torna inválido
  • Limite de Uso (opcional): Máximo total de resgates entre todos os clientes
  • Restrição de Produto (opcional): Limitar a aplicabilidade a produtos selecionados
  • Limite de Ciclo de Assinatura (opcional): Número de ciclos de cobrança aos quais o desconto se aplica
Use limites de ciclo para preços introdutórios em assinaturas (por exemplo, “50% de desconto por 3 meses”).

​
Experiência de Checkout

  1. Os compradores inserem o código no campo de checkout.
  2. Descontos elegíveis são aplicados e os totais são atualizados imediatamente.
Nas Sessões de Checkout, passe discount_code para pré-aplicar um código e defina feature_flags.allow_discount_code para mostrar o campo de entrada.

​
Gerenciamento de API

Crie códigos de desconto programaticamente com tipo e valor.

Referência da API

Veja a API para criar desconto.
Liste todos os descontos ou recupere detalhes para gerenciamento e auditoria.

Referência da API

Navegue pelas APIs de listagem e recuperação.
Procure um desconto usando seu código legível por humanos (por exemplo, “SAVE20”) em vez do ID interno.

Referência da API

Recupere desconto pelo nome do código.
Modifique a configuração do desconto, como valor, expiração ou restrições.

Referência da API

Saiba como atualizar os detalhes do desconto.
Verifique se um desconto é válido e aplicável antes de aplicar.

Referência da API

Valide o uso do desconto.
Desative ou remova descontos que não são mais necessários.

Referência da API

Exclua um desconto.

​
Casos de Uso Comuns

  • Ofertas introdutórias: Promoções de lançamento por tempo limitado para novos produtos
  • Descontos em massa ou B2B: Descontos contratados para conjuntos de produtos selecionados
  • Jogadas de retenção: Códigos de recuperação em fluxos de prevenção de churn
  • Campanhas sazonais: Promoções baseadas em feriados ou eventos

​
Exemplos de Integração

​
Aplique um desconto nas Sessões de Checkout

Pré-aplique um desconto e mostre a interface de entrada do código. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'BLACKFRIDAY2024',
  customer: { email: 'user@example.com', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​
Habilite a entrada de desconto sem pré-aplicação

Permita que os clientes insiram um código no checkout sem passar um previamente. 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return'
});

​
Melhores Práticas

  • Nomeie claramente: Use códigos reconhecíveis que correspondam aos nomes das campanhas
  • Defina prazos: Adicione expirações para gerar urgência e evitar abusos
  • Limite sabiamente: Restringa a produtos específicos para evitar vazamento de margem
  • Valide cedo: Verifique a aplicabilidade do código antes de confirmar o checkout
  • Monitore o impacto: Acompanhe o uso e a conversão por campanha
Códigos de desconto são alavancas poderosas para aquisição e retenção. Comece com ofertas simples e bem nomeadas, valide minuciosamente e itere com base no desempenho.