Pular para o conteúdo principal
Visão geral da capa 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
  • Nome do Desconto (obrigatório): Nome de exibição interno e no painel
  • Código (obrigatório): A sequência que os clientes inserem no checkout
  • Tipo e Quantidade (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 de resgates totais entre todos os clientes
  • Restrição de Produto (opcional): Limitar aplicabilidade a produtos selecionados
  • Limite de Ciclo de Assinatura (opcional): Número de ciclos de cobrança aos quais o desconto se aplica
  • Metadados (opcional): Anexar pares de chave-valor personalizados para rastreamento interno ou integrações

​
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.

​
Criar um desconto com metadados

Anexe pares de chave-valor personalizados para rastreamento interno. 
const discount = await client.discounts.create({
  type: 'percentage',
  amount: 1500, // 15%
  code: 'SUMMER2025',
  metadata: {
    campaign: 'summer_promo',
    source: 'email_blast'
  }
});
Use metadados para marcar descontos por campanha, fonte ou ID de referência interna para que você possa conciliar o uso e medir o ROI posteriormente.

​
Aplicar um desconto em Sessões de Checkout

Pré-aplique um desconto e mostre a interface de entrada de 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'
});

​
Aplicar um desconto durante mudanças de plano

Ofereça preços promocionais quando os clientes fizerem upgrade ou downgrade de sua assinatura. 
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  discount_code: 'UPGRADE20'
});
Se a assinatura já tiver um desconto com preserve_on_plan_change=true e você não passar um novo código, o desconto existente é automaticamente preservado quando aplicável ao novo produto.

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

Deixe os clientes inserirem 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
  • Delimite o tempo: Adicione expirações para gerar urgência e evitar abusos
  • Delimite com sabedoria: Limite a produtos específicos para evitar vazamentos 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.
Last modified on April 20, 2026