Complementos para Assinaturas

Add-ons são produtos complementares anexados às assinaturas. Os clientes escolhem uma quantidade no checkout ou ao atualizar a assinatura, e o add-on é cobrado de acordo com o ciclo da assinatura principal.

Seat-Based Billing

Crie add-ons para assentos adicionais da equipe ou licenças de usuário.

Usage Extensions

Amplie limites de uso, chamadas de API ou franquias de dados com add-ons.

O que são add-ons?

Add-ons são produtos complementares que os clientes podem adquirir junto com a assinatura principal. Eles são ideais para cobrança baseada em assentos, upgrades de recursos, extensões de uso e serviços adicionais.

Add-ons anexados a produtos de assinatura no dashboard

Principais benefícios

Os add-ons permitem modelos de preços flexíveis, otimização da receita por meio de oportunidades de upsell, gerenciamento simplificado em um único dashboard e liberdade para que os clientes personalizem suas assinaturas.

Criando add-ons

Os add-ons são criados como produtos separados no dashboard e, depois, anexados aos produtos de assinatura. Isso permite reutilizar add-ons em várias assinaturas e gerenciar os preços de forma independente.

Configuração de add-ons

Ao criar add-ons, você pode configurar:

Preço: Defina o valor do add-on (price) na menor unidade da moeda. O add-on é cobrado de acordo com o ciclo da assinatura principal
Moeda: Defina o preço-base em qualquer moeda que o Dodo Payments possa cobrar. O seletor de moedas pesquisável fixa USD, GBP, EUR e INR no topo; clientes fora da sua moeda-base são cobrados por meio do Adaptive Currency
Quantidade: Os clientes escolhem uma quantidade quando o add-on é anexado a uma assinatura
Disponibilidade: Anexe o add-on aos produtos de assinatura por meio da lista addons de cada produto. O add-on não possui uma configuração de disponibilidade própria
Configurações de impostos: Configure o tax_category apropriado

Primeiros passos

Pronto para implementar add-ons no seu negócio de assinaturas? Veja como começar:

Plan Your Add-ons

Identifique os recursos, serviços ou capacidades adicionais que seriam úteis para seus clientes como add-ons.Considere:

O que os clientes solicitam com frequência?
Quais recursos poderiam ser monetizados separadamente?
O que criaria caminhos naturais de upgrade?

Create Your First Add-on

Use o dashboard ou a API do Dodo Payments para criar seu primeiro produto add-on.

Dashboard Guide

Siga nosso guia passo a passo para criar add-ons no dashboard.

Attach to Subscriptions

Conecte seus add-ons aos produtos de assinatura apropriados nos quais eles devem estar disponíveis.

Test Integration

Crie sessões de checkout de teste com diferentes combinações de add-ons para garantir que tudo funcione corretamente.

Monitor Performance

Acompanhe as taxas de adoção dos add-ons e o impacto na receita para otimizar sua estratégia de preços.

Casos de uso comuns

Cobrança baseada em assentos: Membros adicionais da equipe, licenças de usuário ou usuários simultâneos
Upgrades de recursos: Recursos premium, análises avançadas ou suporte prioritário
Extensões de uso: Armazenamento adicional, chamadas de API ou franquias de largura de banda
Add-ons de serviço: Serviços profissionais, treinamento ou horas de consultoria

Exemplos de integração

Sessões de checkout com add-ons

Ao criar uma sessão de checkout, inclua add-ons com quantidades:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1,
      addons: [
        {
          addon_id: 'addon_456',
          quantity: 3 // 3 additional seats
        }
      ]
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123",
            "quantity": 1,
            "addons": [
                {
                    "addon_id": "addon_456",
                    "quantity": 3  # 3 additional seats
                }
            ]
        }
    ],
    customer={"email": "customer@example.com"},
    return_url="https://yourapp.com/success"
)

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123",
        "quantity": 1,
        "addons": [
          {
            "addon_id": "addon_456",
            "quantity": 3
          }
        ]
      }
    ],
    "customer": {"email": "customer@example.com"},
    "return_url": "https://yourapp.com/success"
  }'

Para permitir que os clientes adicionem ou removam add-ons por conta própria na página de checkout, defina o recurso allow_editing_addons como true ao criar a sessão. O valor padrão é false, e o recurso se aplica somente a produtos de assinatura.

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  feature_flags: {
    allow_editing_addons: true // customers can edit add-ons at checkout
  },
});

Alterações de plano com add-ons

Modifique assinaturas existentes para adicionar, remover ou atualizar add-ons:

// Add add-ons to existing subscription
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_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: 'pdt_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [] // Empty array removes all existing add-ons
});

# Add add-ons to existing subscription
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[
        {'addon_id': 'addon_123', 'quantity': 2}
    ]
)

# Remove all existing add-ons
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[]
)

Preços dinâmicos

Calcule os custos totais dinamicamente com base nas seleções de add-ons:

interface AddonSelection {
  price: number;
  quantity: number;
}

function calculateTotalCost(basePrice: number, addons: AddonSelection[]) {
  const addonTotal = addons.reduce((sum, addon) => 
    sum + (addon.price * addon.quantity), 0
  );
  return basePrice + addonTotal;
}

Gerenciamento pela API

O Dodo Payments fornece uma API completa para gerenciar add-ons programaticamente:

Create Add-ons

Use o endpoint POST /addons para criar novos add-ons com preços, descrições e opções de configuração personalizadas.

API Reference

Consulte a documentação completa da API para criar add-ons.

Update Add-ons

Modifique add-ons existentes usando o endpoint PATCH /addons/{id} para atualizar preços, descrições ou categorias de impostos.

API Reference

Saiba como atualizar os detalhes dos add-ons programaticamente.

List and Retrieve

Use GET /addons para listar todos os add-ons ou GET /addons/{id} para recuperar os detalhes de um add-on específico.

API Reference

Acesse a documentação completa da API de listagem e recuperação.

Image Management

Atualize as imagens dos add-ons usando o endpoint PUT /addons/{id}/images para melhorar a apresentação dos produtos.

API Reference

Saiba como gerenciar imagens de add-ons por meio da API.

Práticas recomendadas

Comece de forma simples: Lance de 2 a 3 add-ons principais e amplie as opções com base no feedback e no uso dos clientes.
Mantenha a clareza dos preços: Comunique claramente o preço e o valor dos add-ons para que os clientes entendam o que estão recebendo pelo custo adicional.
Teste detalhadamente: Valide as combinações de add-ons para garantir que os cálculos de preços permaneçam precisos e que os fluxos de checkout funcionem sem problemas.

Considerações de design

Proposta de valor clara: Cada add-on deve oferecer um benefício claro que os clientes possam entender
Agrupamento lógico: Agrupe add-ons relacionados no fluxo de checkout
Quantidades flexíveis: Permita que os clientes ajustem as quantidades dos add-ons conforme necessário
Preços transparentes: Exiba os custos totais com clareza durante todo o processo de checkout

Relacionados

Seat-Based Billing

Guia para implementar preços por assento com add-ons.

Checkout Sessions

API e configuração completas de sessões de checkout.

Subscriptions

Ciclo de vida da assinatura, ciclos de cobrança e renovação.

Adaptive Currency

Exiba os preços nas moedas locais durante o checkout.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Seat-Based Billing

Usage Extensions

O que são add-ons?

Principais benefícios

Criando add-ons

Configuração de add-ons

Primeiros passos

Dashboard Guide

Casos de uso comuns

Exemplos de integração

Sessões de checkout com add-ons

Alterações de plano com add-ons

Preços dinâmicos

Gerenciamento pela API

API Reference

API Reference

API Reference

API Reference

Práticas recomendadas

Considerações de design

Relacionados

Seat-Based Billing

Checkout Sessions

Subscriptions

Adaptive Currency

Seat-Based Billing

Usage Extensions

​O que são add-ons?

​Principais benefícios

​Criando add-ons

​Configuração de add-ons

​Primeiros passos

Dashboard Guide

​Casos de uso comuns

​Exemplos de integração

​Sessões de checkout com add-ons

​Alterações de plano com add-ons

​Preços dinâmicos

​Gerenciamento pela API

API Reference

API Reference

API Reference

API Reference

​Práticas recomendadas

​Considerações de design

​Relacionados

Seat-Based Billing

Checkout Sessions

Subscriptions

Adaptive Currency

O que são add-ons?

Principais benefícios

Criando add-ons

Configuração de add-ons

Primeiros passos

Casos de uso comuns

Exemplos de integração

Sessões de checkout com add-ons

Alterações de plano com add-ons

Preços dinâmicos

Gerenciamento pela API

Práticas recomendadas

Considerações de design

Relacionados