Modelos de Faturamento Híbrido

​

O que é Faturamento Híbrido?

​

Por que usar Faturamento Híbrido?

​

Padrões Híbridos Comuns

​

Modelo Híbrido 1: Assinatura + Uso

​

Como Funciona

• Incluído: 10.000 chamadas de API/mês
• Excesso: $0.005 por chamada após 10.000

• Assinatura base: $49.00
• Excesso: (25.000 - 10.000) × $0.005 =$75.00
• Total: $124.00

​

Casos de Uso

• Plataformas de API: Acesso base + cobranças por solicitação
• Serviços de IA/ML: Assinatura + uso de token/geração
• Serviços de armazenamento: Plano base + excesso por GB
• Plataformas de comunicação: Base + cobranças por mensagem/minuto

​

Implementação

Dashboard: Meters → Create Meter
Event Name: "api.call"
Aggregation: Count
This tracks API calls per customer

Dashboard: Create Product → Subscription
Name: "Pro Plan"
Base Price: $49/month

Then attach usage pricing:
- Meter: api.call
- Price per unit: $0.005
- Free threshold: 10,000 (included in subscription)

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

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: `call_${Date.now()}`,
      customer_id: 'cus_123',
      event_name: 'api.call',
      timestamp: new Date().toISOString(),
      metadata: { endpoint: '/v1/generate' }
    }]
  })
});

​

Variações de Preço

​

Modelo Híbrido 2: Assinatura + Assentos

​

Como Funciona

• Taxa base da plataforma: $99/mês (inclui 3 assentos)
• Assentos adicionais: $15/assento/mês

• Taxa da plataforma: $99.00
• Assentos extras: (12 - 3) × $15 =$135.00
• Total: $234.00/mês

​

Casos de Uso

• Ferramentas de colaboração: Taxa de espaço de trabalho + por membro
• Sistemas de CRM: Licença de plataforma + por representante de vendas
• Gerenciamento de projetos: Plano de equipe + por colaborador
• Ferramentas de desenvolvimento: Taxa de organização + por desenvolvedor

​

Implementação

Dashboard: Products → Add-ons → Create Add-on
Name: "Additional Seat"
Price: $15/month
Description: "Add another team member"

Dashboard: Create Product → Subscription
Name: "Team Plan"
Price: $99/month
Description: "Includes 3 team members"

Then in Add-ons section:
- Attach: "Additional Seat" add-on

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_team_plan',
    quantity: 1,
    addons: [{
      addon_id: 'addon_seat',
      quantity: 9  // 9 extra seats (12 total with 3 included)
    }]
  }],
  customer: { email: 'admin@company.com' },
  return_url: 'https://yourapp.com/success'
});

// Add 5 more seats
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_team_plan',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  addons: [{
    addon_id: 'addon_seat',
    quantity: 14  // New total: 14 extra seats
  }]
});

​

Variações de Preço

​

Modelo Híbrido 3: Assinatura + Complementos de Recursos

​

Como Funciona

• Análises Avançadas: +$19/mês
• Acesso à API: +$9/mês
• Suporte Prioritário: +$29/mês
• Marca Branca: +$49/mês

• Plano principal: $29.00
• Análises: $19.00
• Acesso à API: $9.00
• Total: $57.00/mês

​

Casos de Uso

• Plataformas SaaS: Recursos principais + módulos premium
• Ferramentas de marketing: Ferramenta base + integrações
• Produtos de análises: Painel + relatórios avançados
• Software de segurança: Proteção básica + recursos avançados

​

Implementação

# Add-on 1: Advanced Analytics
Dashboard: Products → Add-ons → Create Add-on
Name: "Advanced Analytics"
Price: $19/month

# Add-on 2: API Access
Name: "API Access"
Price: $9/month

# Add-on 3: Priority Support
Name: "Priority Support"
Price: $29/month

# Add-on 4: White-label
Name: "White-label"
Price: $49/month

Dashboard: Create Product → Subscription
Name: "Core Plan"
Price: $29/month

Then in Add-ons section:
- Attach all feature add-ons

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_core_plan',
    quantity: 1,
    addons: [
      { addon_id: 'addon_analytics', quantity: 1 },
      { addon_id: 'addon_api_access', quantity: 1 }
      // Customer didn't select support or white-label
    ]
  }],
  return_url: 'https://yourapp.com/success'
});

// Customer wants to add Priority Support
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_core_plan',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately',
  addons: [
    { addon_id: 'addon_analytics', quantity: 1 },
    { addon_id: 'addon_api_access', quantity: 1 },
    { addon_id: 'addon_priority_support', quantity: 1 }  // New!
  ]
});

​

Modelo Híbrido 4: Assentos + Uso

​

Como Funciona

• 5 GB de processamento de dados/mês
• Excesso: $2/GB após a permissão

• Taxas de assento: 10 × $20 =$200.00
• Dados incluídos: 10 × 5 GB = 50 GB
• Excesso: (80 - 50) × $2 =$60.00
• Total: $260.00/mês

​

Casos de Uso

• Plataformas de análises: Por analista + processamento de dados
• Ferramentas de design: Por designer + armazenamento/exportações
• Ambientes de desenvolvimento: Por desenvolvedor + horas de computação
• Ferramentas de comunicação: Por usuário + volume de mensagens/chamadas

​

Opções de Implementação

Dashboard: Meters → Create Meter
Event Name: "data.processed"
Aggregation: Sum
Property: "bytes"

Dashboard: Create Product → Subscription
Name: "Team Analytics"
Base Price: $0/month

Attach usage pricing:
- Meter: data.processed
- Price per unit: $2/GB
- Free threshold: 0 (managed by your app)

// Your application tracks seats and calculates total cost
async function calculateMonthlyBill(customerId: string) {
  const seatCount = await getSeatCount(customerId);
  const seatFee = seatCount * 20; // $20/seat

  // Usage is billed by Dodo automatically
  // You invoice/charge seat fees separately or include in base price

  // Alternatively, adjust base subscription price when seats change
  const totalBasePrice = seatCount * 2000; // $20/seat in cents
  await client.subscriptions.update('sub_123', {
    // Update subscription to reflect seat-based pricing
  });
}

// When checking usage, apply per-seat allowance
async function checkUsageOverage(customerId: string) {
  const seatCount = await getSeatCount(customerId);
  const includedGB = seatCount * 5; // 5 GB per user

  const currentUsage = await getUsageFromDodo(customerId);
  const overage = Math.max(0, currentUsage - includedGB);

  // Overage is billed by Dodo at $2/GB
  return { included: includedGB, used: currentUsage, overage };
}

Dashboard: Products → Add-ons → Create Add-on
Name: "Team Member"
Price: $20/month

Dashboard: Create Product → Subscription
Name: "Team Analytics"
Base Price: $0/month

Attach add-on:
- "Team Member" add-on

Enable on-demand charging

// Track usage events in your system
async function trackDataProcessed(customerId: string, bytes: number) {
  await saveUsageEvent({
    customer_id: customerId,
    event_type: 'data.processed',
    bytes: bytes,
    timestamp: new Date()
  });
}

async function billUsageOverage(subscriptionId: string) {
  const subscription = await getSubscription(subscriptionId);
  const seatCount = subscription.addons.find(a => a.id === 'addon_seat')?.quantity || 0;

  const includedGB = seatCount * 5;
  const usedGB = await calculatePeriodUsage(subscription.customer_id);
  const overageGB = Math.max(0, usedGB - includedGB);

  if (overageGB > 0) {
    const overageCharge = overageGB * 200; // $2/GB in cents
    await client.subscriptions.charge(subscriptionId, {
      product_price: overageCharge,
      product_description: `Data overage: ${overageGB} GB × $2/GB`
    });
  }
}

​

Modelo Híbrido 5: Assinatura + Assentos + Uso (Triple Hybrid)

​

Como Funciona

• Taxa da Plataforma: $199/mês
• Por Assento: $25/usuário/mês
• Uso: $0.10/1000 chamadas de API (50K incluídas)

• Plataforma: $199.00
• Assentos: 20 × $25 =$500.00
• Uso: (150K - 50K) × $0.10/1K = $10.00
• Total: $709.00/mês

​

Casos de Uso

• SaaS Empresarial: Plataforma + equipe + consumo
• Plataformas de dados: Espaço de trabalho + analistas + consultas
• Plataformas de integração: Hub + conectores + transações
• Plataformas de IA: Espaço de trabalho + desenvolvedores + inferência

​

Opções de Implementação

Dashboard: Products → Add-ons → Create Add-on
Name: "User Seat"
Price: $25/month

Dashboard: Create Product → Subscription
Name: "Enterprise Platform"
Base Price: $199/month

Attach add-on:
- "User Seat" add-on

Enable on-demand charging

const session = await client.checkoutSessions.create({
  product_cart: [{
    product_id: 'prod_enterprise_platform',
    quantity: 1,
    addons: [{
      addon_id: 'addon_user_seat',
      quantity: 20  // 20 users
    }]
  }],
  customer: { email: 'enterprise@company.com' },
  return_url: 'https://yourapp.com/success'
});

// Track API calls in your system
async function trackApiCall(customerId: string, endpoint: string) {
  await saveUsageEvent({
    customer_id: customerId,
    event_type: 'api.call',
    endpoint: endpoint,
    timestamp: new Date()
  });
}

async function billUsageOverage(subscriptionId: string) {
  const usage = await calculatePeriodUsage(subscriptionId);
  const includedCalls = 50000;
  const overageCalls = Math.max(0, usage.totalCalls - includedCalls);

  if (overageCalls > 0) {
    // $0.10 per 1000 calls = $0.0001 per call
    const overageCharge = Math.ceil(overageCalls / 1000) * 10; // cents
    await client.subscriptions.charge(subscriptionId, {
      product_price: overageCharge,
      product_description: `API usage: ${overageCalls.toLocaleString()} calls over 50K included`
    });
  }
}

Dashboard: Meters → Create Meter
Event Name: "api.call"
Aggregation: Count

Dashboard: Create Product → Subscription
Name: "Enterprise Platform"
Base Price: $199/month

Attach usage pricing:
- Meter: api.call
- Price: $0.10 per 1000 calls
- Free threshold: 50,000

// When seats change, update subscription price
async function updateSeatCount(subscriptionId: string, newSeatCount: number) {
  const basePlatformFee = 19900; // $199 in cents
  const perSeatFee = 2500; // $25 in cents
  const totalPrice = basePlatformFee + (newSeatCount * perSeatFee);

  // Store seat count in your system
  await updateSeatsInDatabase(subscriptionId, newSeatCount);

  // Note: You may need to handle this via plan changes or
  // create multiple tier products for common seat counts
}

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: `api_${Date.now()}`,
      customer_id: 'cus_enterprise',
      event_name: 'api.call',
      timestamp: new Date().toISOString()
    }]
  })
});

​

Modelo Híbrido 6: Base em Camadas + Excesso de Uso

​

Como Funciona

​

Implementação

# For each tier, create a subscription product:

# Starter Tier
Dashboard: Create Product → Subscription
Name: "Starter"
Base Price: $19/month
Usage Pricing:
- Meter: api.call
- Price: $0.02/call
- Free threshold: 1,000

# Pro Tier
Name: "Pro"
Base Price: $79/month
Usage Pricing:
- Meter: api.call
- Price: $0.01/call
- Free threshold: 25,000

# ... and so on for Business and Enterprise

​

Caminho de Upgrade

• Permissão incluída maior
• Taxas de excesso mais baixas
• Mais valor por dólar

// Customer upgrades from Starter to Pro
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

​

Modelo Híbrido 7: Assinatura + Cobranças Sob Demanda

​

Como Funciona

• Acesso à plataforma
• 5 horas de consultoria/mês
• Suporte por e-mail

• Consultoria extra: $150/hora
• Desenvolvimento personalizado: $200/hora
• Suporte de emergência: $100/incidente

• Retentor: $199.00
• 3 horas de consultoria extra: $450.00
• 1 suporte de emergência: $100.00
• Total: $749.00

​

Casos de Uso

• Serviços de consultoria: Retentor + faturamento por hora
• Serviços gerenciados: Taxa base + cobranças por incidente
• Serviços de agência: Taxa mensal + cobranças por projeto
• Planos de suporte: Taxa de SLA + por ticket ou por hora

​

Implementação

const subscription = await client.subscriptions.create({
  billing: {
    city: 'San Francisco',
    country: 'US',
    state: 'CA',
    street: '123 Main St',
    zipcode: '94105'
  },
  customer: { customer_id: 'cus_123' },
  product_id: 'prod_retainer',
  quantity: 1,
  payment_link: true,
  return_url: 'https://yourapp.com/success',
  on_demand: {
    mandate_only: false,
    product_price: 19900  // $199 initial charge
  }
});

// Charge for 3 hours of consulting
await client.subscriptions.charge('sub_123', {
  product_price: 45000,  // $450.00 (3 × $150)
  product_description: 'Consulting - 3 hours (March 15)'
});

// Charge for emergency support incident
await client.subscriptions.charge('sub_123', {
  product_price: 10000,  // $100.00
  product_description: 'Emergency support - Server outage (March 18)'
});

// Retrieve subscription charges
const payments = await client.payments.list({
  subscription_id: 'sub_123'
});

// Show itemized breakdown to customer
payments.items.forEach(payment => {
  console.log(`${payment.description}: $${payment.amount / 100}`);
});

​

Exemplos do Mundo Real

​

Exemplo 1: Plataforma SaaS de IA

• Assinatura Base: $99/mês (acesso à plataforma, 5 assentos incluídos)
• Complemento de Assento: $20/assento/mês
• Complementos de Recursos: Modelos Personalizados ($49/mês), Acesso à API ($29/mês), Fila Prioritária ($19/mês)
• Excesso de Uso: $0.02 por 1.000 tokens após 100K (cobrado via sob demanda)

​

Exemplo 2: Plataforma de Ferramentas para Desenvolvedores

• Usuários extras: $10/usuário/mês
• Builds prioritárias: $19/mês
• Domínios personalizados: $9/dominio/mês

​

Exemplo 3: Automação de Marketing

• Base: $79/mês (recursos principais de automação, 3 assentos incluídos)
• Camadas de Contato (complementos): 1K incluído, 5K (+$30), 25K (+$80), 100K (+$200)
• Complementos de Recursos: Marketing por SMS ($29/mês), Páginas de Destino ($19/mês), Teste A/B ($29/mês)
• Assentos de Equipe: $15/usuário/mês de complemento
• Volume de E-mail: Rastreie no aplicativo, cobre o excesso via sob demanda ($1/1.000 e-mails acima do limite)

​

Melhores Práticas de Implementação

​

Clareza na Página de Preços

​

Previsibilidade de Custos

// Provide a cost calculator
function estimateMonthlyCost({
  plan,
  seats,
  expectedUsage,
  addons
}: EstimateParams): number {
  let total = plan.basePrice;

  // Add seat costs
  const extraSeats = Math.max(0, seats - plan.includedSeats);
  total += extraSeats * plan.seatPrice;

  // Add usage overage
  const overage = Math.max(0, expectedUsage - plan.includedUsage);
  total += overage * plan.overageRate;

  // Add feature add-ons
  total += addons.reduce((sum, addon) => sum + addon.price, 0);

  return total;
}

​

Visibilidade de Uso

// Display usage dashboard
async function getUsageSummary(subscriptionId: string) {
  const usage = await client.subscriptions.getUsageHistory(subscriptionId);

  return {
    current: usage.current_period_usage,
    included: usage.free_threshold,
    remaining: Math.max(0, usage.free_threshold - usage.current_period_usage),
    overage: Math.max(0, usage.current_period_usage - usage.free_threshold),
    projectedCost: calculateProjectedOverage(usage)
  };
}

​

Transparência de Faturamento

​

Resolvendo Problemas de Faturamento Híbrido

​

Documentação Relacionada