> ## Documentation Index > Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt > Use this file to discover all available pages before exploring further. # Descontos > Crie códigos promocionais para impulsionar conversões, realizar campanhas e recompensar clientes com descontos percentuais em compras únicas e de assinatura. 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, defina limites e expirações, restrinja a produtos e aplique-os facilmente no checkout. Aplique códigos durante o checkout hospedado com `discount_code` e controles de UI. Verifique se um desconto é válido pelo seu ID. Procure e valide um desconto usando seu código (por exemplo, "SAVE20"). Crie códigos de desconto novos programaticamente. 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 * **Descontos flexíveis**: Descontos baseados em porcentagem * **Códigos acumuláveis**: Aplique até 20 códigos por checkout, pagamento ou assinatura — combine campanhas (e.g. `WELCOME10` + `BLACKFRIDAY20`) sem criar códigos personalizados * **Controle direcionado**: Restrinja por produto e ciclos de assinatura * **Governança de campanha**: Datas de expiração e limites de uso * **Checkout sem interrupções**: Suporte para campo de interface e API por meio de sessões de checkout 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 exibido internamente e no painel * **Código** (obrigatório): A string que os clientes inserem no checkout * **Tipo e Quantidade** (obrigatório): Defina um valor percentual (apenas descontos baseados em porcentagem são suportados atualmente) 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): Limite a 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): Anexe 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. Veja a API para criar desconto. Liste todos os descontos ou recupere detalhes para gerenciamento e auditoria. 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. Recupere desconto pelo nome do código. Modifique a configuração do desconto, como valor, expiração ou restrições. Saiba como atualizar os detalhes do desconto. Verifique se um desconto é válido e aplicável antes de aplicar. Valide o uso do desconto. Desative ou remova descontos que não são mais necessários. 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. ```typescript theme={null} 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. ```typescript theme={null} 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. ```typescript theme={null} 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. ```typescript theme={null} 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. ### Permitir entrada de desconto sem pré-aplicação Permita que os clientes insiram um código no checkout sem informar um previamente. ```typescript theme={null} 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 tempo**: Adicione expirações para criar urgência e prevenir uso indevido * **Defina o escopo sabiamente**: Limite a produtos específicos para evitar perda de margem * **Valide cedo**: Verifique a aplicabilidade do código antes de confirmar o checkout * **Monitore o impacto**: Acompanhe uso e 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 cuidadosamente e itere com base no desempenho.