Modelos de Facturación Híbrida

​

¿Qué es la Facturación Híbrida?

​

¿Por qué usar la Facturación Híbrida?

​

Patrones Híbridos Comunes

​

Modelo Híbrido 1: Suscripción + Uso

​

Cómo Funciona

• Incluido: 10,000 llamadas API/mes
• Exceso: $0.005 por llamada después de 10,000

• Suscripción base: $49.00
• Exceso: (25,000 - 10,000) × $0.005 =$75.00
• Total: $124.00

​

Casos de Uso

• Plataformas API: Acceso base + cargos por solicitud
• Servicios de IA/ML: Suscripción + uso de token/generación
• Servicios de almacenamiento: Plan base + exceso por GB
• Plataformas de comunicación: Base + cargos por mensaje/minuto

​

Implementación

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' }
    }]
  })
});

​

Variaciones de Precios

​

Modelo Híbrido 2: Suscripción + Asientos

​

Cómo Funciona

• Tarifa base de plataforma: $99/mes (incluye 3 asientos)
• Asientos adicionales: $15/asiento/mes

• Tarifa de plataforma: $99.00
• Asientos extra: (12 - 3) × $15 =$135.00
• Total: $234.00/mes

​

Casos de Uso

• Herramientas de colaboración: Tarifa de espacio de trabajo + por miembro
• Sistemas CRM: Licencia de plataforma + por representante de ventas
• Gestión de proyectos: Plan de equipo + por contribuyente
• Herramientas de desarrollo: Tarifa de organización + por desarrollador

​

Implementación

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
  }]
});

​

Variaciones de Precios

​

Modelo Híbrido 3: Suscripción + Complementos de Características

​

Cómo Funciona

• Analítica Avanzada: +$19/mes
• Acceso a API: +$9/mes
• Soporte Prioritario: +$29/mes
• Marca Blanca: +$49/mes

• Plan básico: $29.00
• Analítica: $19.00
• Acceso a API: $9.00
• Total: $57.00/mes

​

Casos de Uso

• Plataformas SaaS: Características básicas + módulos premium
• Herramientas de marketing: Herramienta base + integraciones
• Productos de analítica: Tablero + informes avanzados
• Software de seguridad: Protección básica + características avanzadas

​

Implementación

# 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: Asientos + Uso

​

Cómo Funciona

• 5 GB de procesamiento de datos/mes
• Exceso: $2/GB después de la asignación

• Tarifas de asiento: 10 × $20 =$200.00
• Datos incluidos: 10 × 5 GB = 50 GB
• Exceso: (80 - 50) × $2 =$60.00
• Total: $260.00/mes

​

Casos de Uso

• Plataformas de analítica: Por analista + procesamiento de datos
• Herramientas de diseño: Por diseñador + almacenamiento/exportaciones
• Entornos de desarrollo: Por desarrollador + horas de computación
• Herramientas de comunicación: Por usuario + volumen de mensajes/llamadas

​

Opciones de Implementación

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: Suscripción + Asientos + Uso (Triple Híbrido)

​

Cómo Funciona

• Tarifa de Plataforma: $199/mes
• Por Asiento: $25/usuario/mes
• Uso: $0.10/1000 llamadas API (50K incluidas)

• Plataforma: $199.00
• Asientos: 20 × $25 =$500.00
• Uso: (150K - 50K) × $0.10/1K = $10.00
• Total: $709.00/mes

​

Casos de Uso

• SaaS Empresarial: Plataforma + equipo + consumo
• Plataformas de datos: Espacio de trabajo + analistas + consultas
• Plataformas de integración: Hub + conectores + transacciones
• Plataformas de IA: Espacio de trabajo + desarrolladores + inferencia

​

Opciones de Implementación

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 por Niveles + Exceso de Uso

​

Cómo Funciona

​

Implementación

# 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

​

Ruta de Actualización

• Mayor asignación incluida
• Tarifas de exceso más bajas
• Más 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: Suscripción + Cargos Bajo Demanda

​

Cómo Funciona

• Acceso a la plataforma
• 5 horas de consultoría/mes
• Soporte por correo electrónico

• Consultoría extra: $150/hora
• Desarrollo personalizado: $200/hora
• Soporte de emergencia: $100/incidente

• Retención: $199.00
• 3 horas de consultoría extra: $450.00
• 1 soporte de emergencia: $100.00
• Total: $749.00

​

Casos de Uso

• Servicios de consultoría: Retención + facturación por hora
• Servicios gestionados: Tarifa base + cargos por incidente
• Servicios de agencia: Tarifa mensual + cargos por proyecto
• Planes de soporte: Tarifa SLA + por ticket o por hora

​

Implementación

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}`);
});

​

Ejemplos del Mundo Real

​

Ejemplo 1: Plataforma SaaS de IA

• Suscripción Base: $99/mes (acceso a la plataforma, 5 asientos incluidos)
• Complemento de Asiento: $20/asiento/mes
• Complementos de Características: Modelos Personalizados ($49/mes), Acceso a API ($29/mes), Cola Prioritaria ($19/mes)
• Exceso de Uso: $0.02 por 1,000 tokens después de 100K (cobrado a través de demanda)

​

Ejemplo 2: Plataforma de Herramientas para Desarrolladores

• Usuarios extra: $10/usuario/mes
• Construcciones prioritarias: $19/mes
• Dominios personalizados: $9/dominio/mes

​

Ejemplo 3: Automatización de Marketing

• Base: $79/mes (características básicas de automatización, 3 asientos incluidos)
• Niveles de Contacto (complementos): 1K incluidos, 5K (+$30), 25K (+$80), 100K (+$200)
• Complementos de Características: Marketing por SMS ($29/mes), Páginas de Aterrizaje ($19/mes), Pruebas A/B ($29/mes)
• Asientos de Equipo: $15/usuario/mes de complemento
• Volumen de Correos Electrónicos: Rastrear en la aplicación, cobrar exceso a través de demanda ($1/1,000 correos electrónicos sobre el límite)

​

Mejores Prácticas de Implementación

​

Claridad en la Página de Precios

​

Previsibilidad de Costos

// 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;
}

​

Visibilidad del 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)
  };
}

​

Transparencia en la Facturación

​

Solución de Problemas de Facturación Híbrida

​

Documentación Relacionada