Pular para o conteúdo principal
A cobrança baseada em assentos permite cobrar os clientes com base no número de usuários, membros da equipe ou licenças de que precisam. É o modelo padrão de precificação para ferramentas de colaboração em equipe, software empresarial e produtos SaaS B2B.

Implementation Tutorial

Guia passo a passo com exemplos de código.

Add-ons Documentation

Saiba mais sobre o sistema de complementos que alimenta a cobrança baseada em assentos.

Subscription Management

Gerencie assinaturas baseadas em assentos e mudanças de plano.

Webhooks

Acompanhe alterações de assentos com webhooks de assinatura.

O que é Cobrança Baseada em Assentos?

A cobrança baseada em assentos (também chamada de preços por usuário ou por assento) cobra dos clientes com base no número de usuários que acessam seu produto. Em vez de uma taxa fixa, o preço escala com o tamanho da equipe.

Casos de Uso Comuns

Benefícios da Cobrança Baseada em Assentos

Para o Seu Negócio:
  • A receita escala naturalmente à medida que os clientes crescem
  • Preços previsíveis que os clientes podem orçar
  • Caminho claro de upgrade de individual para equipe para empresarial
  • Maior valor vitalício à medida que as equipes se expandem
Para Seus Clientes:
  • Pague apenas pelo que usam
  • Fácil de entender e prever custos
  • Flexibilidade para adicionar/remover usuários conforme necessário
  • Preços justos que correspondem ao tamanho da equipe

Como a Cobrança Baseada em Assentos Funciona no Dodo Payments

O Dodo Payments implementa a cobrança baseada em assentos usando o sistema de Add-ons. Veja como funciona:

Visão Geral da Arquitetura

Uma assinatura Team Pro custa 99/me^seinclui5assentos.Sevoce^tivermaisde5usuaˊrios,paga99/mês e inclui 5 assentos. Se você tiver mais de 5 usuários, paga 15/mês adicionais por cada assento extra. Por exemplo, se sua equipe precisar de 15 assentos:
  • Plano base: $99/mês (inclui 5 assentos)
  • Complementos: 10 assentos extras × 15/me^s=15/mês = 150/mês
  • Custo mensal total: 99+99 + 150 = $249 por 15 assentos

Componentes Chave


Estratégias de Preço

Escolha a estratégia de preço baseada em assentos que se encaixa no seu negócio:

Estratégia 1: Base + Add-on por Assento

Inclua um número definido de assentos no plano base, cobrando por assentos adicionais. Exemplo:
Melhor para: Produtos onde pequenas equipes podem funcionar com a oferta base.

Estratégia 2: Preço Puro por Assento

Cobre uma taxa fixa por assento sem taxa base. Exemplo:
Implementação: Defina o preço do plano base como $0, use apenas o add-on de assento. Melhor para: Preços simples e transparentes; modelos baseados em uso.

Estratégia 3: Preço por Assento em Camadas

Diferentes planos base com diferentes taxas por assento. Exemplo:
Implementação: Crie produtos separados para cada camada com preços de add-on diferentes. Melhor para: Incentivar upgrades para camadas superiores; vendas empresariais.

Estratégia 4: Pacotes de Assentos

Venda assentos em pacotes em vez de individualmente. Exemplo:
Implementação: Crie múltiplos add-ons para diferentes tamanhos de pacotes. Melhor para: Simplificar decisões de compra; incentivar compromissos maiores.

Configurando a Cobrança Baseada em Assentos

Passo 1: Planeje Sua Estrutura de Preços

Antes da implementação, defina sua estrutura de preços:
1

Define Base Plan

Decida o que está incluído na assinatura base:
  • Preço base (pode ser $0 para um modelo puramente por assento)
  • Número de assentos incluídos
  • Recursos disponíveis nesse nível
2

Set Seat Pricing

Determine o custo do complemento por assento:
  • Preço por assento adicional
  • Quaisquer descontos por volume (por meio de vários complementos)
  • Máximo de assentos permitidos (se aplicável)
3

Consider Billing Frequency

Alinhe o preço dos assentos com seu ciclo de cobrança:
  • Assinaturas mensais → cobranças mensais por assento
  • Assinaturas anuais → cobranças anuais por assento (frequentemente com desconto)

Passo 2: Crie o Add-on de Assento

No seu painel do Dodo Payments:
  1. Navegue até ProdutosAdd-Ons
  2. Clique em Criar Add-On
  3. Configure o add-on:
Crie nomes de complementos descritivos que façam sentido nas faturas. “Assento adicional da equipe” é mais claro do que “Complemento de assento” para clientes que revisam suas cobranças.

Passo 3: Crie o Produto de Assinatura

Crie seu produto de assinatura:
  1. Navegue até ProdutosCriar Produto
  2. Selecione Assinatura
  3. Configure preços e detalhes
  4. Na seção Add-Ons, anexe seu add-on de assento

Passo 4: Anexe o Add-on ao Produto

Vincule o add-on de assento à sua assinatura:
  1. Edite seu produto de assinatura
  2. Role até a seção Add-Ons
  3. Clique em Adicionar Add-Ons
  4. Selecione seu add-on de assento
  5. Salve as alterações
Seu produto de assinatura agora oferece suporte a preços baseados em assentos. Os clientes podem comprar qualquer quantidade de assentos adicionais durante o checkout.

Gerenciando Assentos

Adicionando Assentos a Novas Assinaturas

Ao criar uma sessão de checkout, especifique a quantidade de assentos:

Alterando a Contagem de Assentos em Assinaturas Existentes

Use a API de Alteração de Plano para ajustar os assentos:

Removendo Assentos

Para reduzir a contagem de assentos, especifique a quantidade menor:

Removendo Todos os Assentos Adicionais

Passe um array de add-ons vazio para remover todos os add-ons:

Prorrata para Mudanças de Assentos

Quando os clientes adicionam ou removem assentos no meio do ciclo, a prorrata determina como eles são cobrados.

Modos de prorrata

Exemplos de prorrata

Cenário: ciclo de cobrança de 15 dias restantes, adicionando 5 assentos a $10/assento
O cliente paga 25agoraedepois25 agora e depois 50/mês na renovação.
Cenário: removendo 3 assentos no meio do ciclo com prorated_immediately
Escolhendo um modo de prorrata para alterações de assentos: Use prorated_immediately para um faturamento justo baseado em dias quando as equipes ajustam assentos com frequência. Use difference_immediately para uma matemática mais simples que cobra ou credita o preço total do assento. Veja o Guia de Prorrata para comparações detalhadas.

Visualização antes de alterar

Sempre visualize a prorrata antes de fazer alterações:

Acompanhando assentos com webhooks

Monitore alterações de assentos ouvindo webhooks de assinatura:

Eventos relevantes

Exemplo de manipulador de webhook


Aplicando limites de assentos

Seu aplicativo deve aplicar limites de assentos. A Dodo Payments acompanha a cobrança, mas você controla o acesso.

Estratégias de aplicação

Impeça estritamente que usuários sejam adicionados além da contagem de assentos.

Padrões avançados

Diferentes tipos de assentos

Implementação: Crie complementos separados para cada tipo de assento.

Descontos anuais para assentos

Ofereça preços anuais de assentos com desconto:
Implementação: Crie produtos separados para planos mensais e anuais com preços de complementos diferentes.

Requisitos mínimos de assentos

Exija um número mínimo de assentos para determinados planos:

Melhores práticas

Melhores práticas de precificação

  • Clear Communication: Mostre o preço por assento de forma destacada na sua página de preços
  • Included Seats: Considere incluir alguns assentos no preço base para reduzir atritos
  • Volume Discounts: Ofereça taxas por assento mais baixas para equipes maiores e conquiste contratos empresariais
  • Annual Incentives: Desconte os planos anuais para melhorar o fluxo de caixa e a retenção

Melhores práticas técnicas

  • Cache Seat Counts: Armazene localmente a contagem de assentos da assinatura para evitar chamadas de API a cada requisição
  • Sync Regularly: Sincronize periodicamente sua contagem local de assentos com a Dodo Payments via API
  • Handle Failures: Se uma alteração de assento falhar, mostre mensagens de erro claras e opções de nova tentativa
  • Audit Trail: Registre todas as alterações de assentos para disputas de cobrança e conformidade

Melhores práticas de experiência do usuário

  • Real-Time Feedback: Mostre o impacto no custo imediatamente ao ajustar os assentos
  • Confirmation Steps: Exija confirmação antes de mudanças de cobrança
  • Proration Transparency: Explique claramente as cobranças prorrateadas antes de aplicá-las
  • Easy Downgrades: Não torne difícil reduzir assentos (isso gera confiança)

Resolução de problemas

Sintoma: Seu app mostra uma contagem de assentos diferente da assinatura.Causas:
  • Webhook não recebido ou processado
  • Condição de corrida durante a alteração de assentos
  • Dados em cache não atualizados
Soluções:
  1. Implemente manipuladores de webhook para subscription.plan_changed
  2. Adicione um botão “Sincronizar com a cobrança” que busca a assinatura atual
  3. Defina o TTL do cache para garantir uma atualização regular
Sintoma: Cliente confuso com o valor da cobrança no meio do ciclo.Causas:
  • Modo de prorrata não comunicado claramente
  • Cliente não viu a prévia antes de confirmar
Soluções:
  1. Sempre use previewChangePlan antes de fazer alterações
  2. Mostre um detalhamento claro: “Adicionar X assentos = $Y hoje (prorrateado por Z dias)”
  3. Documente sua política de prorrata no centro de ajuda
Sintoma: Complemento de assento não disponível durante o checkout.Causas:
  • Complemento não vinculado ao produto
  • Complemento arquivado ou excluído
  • Incompatibilidade de moeda entre produto e complemento
Soluções:
  1. Verifique se o complemento está vinculado nas configurações do produto
  2. Confira o status do complemento no painel de complementos
  3. Garanta que as moedas correspondam exatamente
Sintoma: Cliente quer reduzir assentos, mas há usuários atribuídos.Soluções:
  1. Mostre quais usuários devem ser removidos antes de reduzir os assentos
  2. Implemente um fluxo: Remover usuários → Reduzir assentos
  3. Considere um período de carência antes de aplicar a redução de assentos

Documentação relacionada

Seat-Based Pricing Tutorial

Guia completo de implementação com código.

Add-ons

Entenda o sistema de complementos em profundidade.

Plan Changes & Proration

Lide com modificações de assinatura.

Subscription Webhooks

Acompanhe eventos de assinatura.
Última modificação em 1 de abril de 2026