> ## 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. # Complementos para Assinaturas > Aprimore seus produtos de assinatura com complementos flexíveis para cobrança baseada em assentos, upgrades de recursos e modelos de preços criativos Add-ons são produtos adicionais que podem ser anexados aos seus produtos principais de assinatura, possibilitando modelos de precificação flexíveis e experiências aprimoradas para os clientes. Seja para cobrança por assento, atualizações de recursos ou estruturas de preços personalizadas, os add-ons lhe dão o poder de criar ofertas de assinatura sofisticadas. Crie add-ons para assentos adicionais da equipe, licenças de usuário ou upgrades de capacidade com precificação por assento. Estenda limites de uso, chamadas de API ou limites de dados com preços flexíveis de complementos. ## O que são Complementos? Complementos são produtos suplementares que os clientes podem adquirir junto com sua assinatura principal. São ideais para: * **Cobrança baseada em assentos**: Membros adicionais da equipe, licenças de usuário ou usuários simultâneos * **Atualizações de recursos**: Recursos premium, análises avançadas ou suporte prioritário * **Extensões de uso**: Armazenamento extra, chamadas de API ou cotas de largura de banda * **Complementos de serviço**: Serviços profissionais, treinamentos ou horas de consultoria Complementos anexados a produtos de assinatura no painel ## Benefícios Principais * **Modelos de preços flexíveis**: Ofereça planos base com complementos opcionais para criar estruturas de preços sofisticadas. Você consegue atender a diversos segmentos de clientes com upgrades que crescem conforme as necessidades deles evoluem. * **Otimização de receita**: Aumente a receita média por usuário (ARPU) apresentando complementos relevantes. Isso cria oportunidades naturais de upsell à medida que os clientes adicionam recursos ao longo do tempo. * **Gerenciamento simplificado**: Gerencie todos os componentes de precificação em um único painel. Os complementos são incluídos automaticamente tanto nas sessões de checkout quanto no gerenciamento de assinaturas. * **Escolha do cliente**: Permita que os clientes personalizem suas assinaturas selecionando apenas os complementos de que precisam, o que melhora a satisfação e reduz o churn. ## Criando Complementos Os complementos são criados como produtos separados no painel da Dodo Payments e, em seguida, associados aos seus produtos de assinatura principais. Essa separação permite que você: * Reutilize complementos em vários produtos de assinatura * Gerencie preços de forma independente * Acompanhe o desempenho dos complementos separadamente * Atualize complementos sem afetar as assinaturas base Criando complementos na interface do painel ### Configuração de Complementos Ao criar complementos, você pode configurar: * **Preços**: Defina preços únicos ou recorrentes para o complemento * **Ciclo de cobrança**: Deve corresponder ao ciclo de cobrança da sua assinatura * **Limites de quantidade**: Defina quantidades mínimas e máximas por cliente * **Disponibilidade**: Controle quais produtos de assinatura podem usar o complemento * **Configurações fiscais**: Configure categorias de impostos apropriadas ### Primeiro Passo Pronto para implementar complementos no seu negócio de assinaturas? Veja como começar: Identifique os recursos, serviços ou capacidades adicionais que beneficiariam seus clientes como complementos. Considere: * O que os clientes solicitam com frequência? * Quais recursos poderiam ser monetizados separadamente? * O que criaria caminhos naturais de upgrade? Use o painel da Dodo Payments ou a API para criar seu primeiro produto complementar. Siga nosso guia passo a passo para criar complementos no painel. Conecte seus complementos aos produtos de assinatura apropriados onde devem estar disponíveis. Crie sessões de checkout de teste com diferentes combinações de complementos para garantir que tudo funcione corretamente. Acompanhe as taxas de adoção dos complementos e o impacto na receita para otimizar sua estratégia de preços. ## Gerenciamento de API A Dodo Payments fornece uma API abrangente para gerenciar complementos programaticamente: Use o endpoint `POST /addons` para criar novos complementos com preços personalizados, descrições e opções de configuração. Veja a documentação completa da API para criar complementos. Modifique complementos existentes usando o endpoint `PATCH /addons/{id}` para atualizar preços, descrições ou disponibilidade. Saiba como atualizar detalhes de complementos programaticamente. Use `GET /addons` para listar todos os complementos ou `GET /addons/{id}` para recuperar detalhes específicos de complementos. Acesse a documentação completa de listagem e recuperação da API. Atualize imagens de complementos usando o endpoint `PUT /addons/{id}/images` para melhorar a apresentação do produto. Saiba como gerenciar imagens de complementos via API. ## Casos de Uso Comuns * **Cobrança baseada em assentos**: Membros adicionais da equipe, licenças de usuário ou usuários simultâneos * **Atualizações de recursos**: Recursos premium, análises avançadas ou suporte prioritário * **Extensões de uso**: Armazenamento extra, chamadas de API ou cotas de largura de banda * **Complementos de serviço**: Serviços profissionais, treinamentos ou horas de consultoria ## Exemplos de Integração ### Sessões de Checkout com Complementos Ao criar sessões de checkout, você pode incluir complementos com quantidades personalizadas: ```typescript theme={null} const session = await client.checkoutSessions.create({ product_cart: [ { product_id: 'your_subscription_id', quantity: 1, addons: [ { addon_id: 'your_addon_id', quantity: 3 // 3 additional seats } ] } ], // ... other checkout options }); ``` ### Alterações de Plano com Complementos Modifique assinaturas existentes para adicionar, remover ou atualizar complementos: ```typescript theme={null} // Add add-ons to existing subscription await client.subscriptions.changePlan('sub_123', { product_id: 'prod_new', quantity: 1, proration_billing_mode: 'difference_immediately', addons: [ { addon_id: 'addon_123', quantity: 2 } ] }); // Remove all existing add-ons await client.subscriptions.changePlan('sub_123', { product_id: 'prod_new', quantity: 1, proration_billing_mode: 'difference_immediately', addons: [] // Empty array removes all existing add-ons }); ``` ### Precificação Dinâmica Calcule custos totais dinamicamente com base na seleção de complementos: ```typescript theme={null} function calculateTotalCost(basePrice: number, addons: AddonSelection[]) { const addonTotal = addons.reduce((sum, addon) => sum + (addon.price * addon.quantity), 0 ); return basePrice + addonTotal; } ``` ## Melhores Práticas * **Comece simples**: Lance com 2–3 complementos principais e expanda as opções conforme receber feedback dos clientes e observar o uso. * **Mantenha a clareza dos preços**: Comunique claramente o preço e o valor dos complementos para que os clientes entendam o que estão recebendo pelo custo adicional. * **Teste amplamente**: Valide combinações de complementos para garantir que os cálculos de preço permaneçam precisos e os fluxos de checkout funcionem corretamente. ### Considerações de Design * **Proposta de valor clara**: Cada complemento deve ter um benefício evidente que os clientes possam entender facilmente * **Agrupamento lógico**: Agrupe complementos relacionados no fluxo de checkout * **Quantidades flexíveis**: Permita que os clientes ajustem as quantidades dos complementos conforme necessário * **Preços transparentes**: Exiba os custos totais claramente ao longo do processo de checkout Complementos são uma maneira poderosa de criar modelos de preços flexíveis e escaláveis que crescem com seus clientes. Comece com casos de uso simples e expanda conforme aprender o que funciona melhor para o seu negócio e seus clientes.