Credit-Based Billing

​

¿Qué es la Facturación Basada en Créditos?

• Plataformas AI y LLM: Otorgar tokens o créditos de generación por nivel de plan
• Servicios API: Asignar créditos de llamadas API con precios por exceso
• Plataformas de infraestructura: Emitir horas de computación o créditos de almacenamiento
• Servicios de comunicación: Proporcionar créditos de mensajes o minutos por suscripción
• SaaS con niveles de consumo: Agrupar el uso incluido en conjuntos de créditos

​

Conceptos Básicos

​

Tipos de Crédito

​

Ciclo de Vida del Crédito

​

Fuentes de Otorgamiento

​

Creación de Créditos

1

Navigate to Credits

Ve a Productos en tu panel de control y selecciona la pestaña Créditos. Haz clic en Crear Crédito para comenzar.

2

Configure Basic Information

Ingresa un Nombre de Crédito: este es tu identificador interno para el crédito.

3

Set General Settings

Configura el tipo de crédito y las propiedades de visualización:

​

Credit Type

string

requerido

Elige Unidad Personalizada o Créditos Fiat.

• Unidad Personalizada: Define tu propia métrica (tokens, llamadas API, horas de computación). Requiere un Nombre de Unidad (p. ej., “Tokens de Plataforma”) y una configuración de Precisión.
• Créditos Fiat: Los créditos representan valor monetario real. Requiere una selección de Moneda de Unidad (USD, EUR, GBP, INR, etc.).

​

Unit Name

string

Solo para créditos de Unidad Personalizada. La etiqueta que los clientes verán para este crédito (p. ej., “Tokens AI”, “Llamadas API”). Mostrado en el checkout y el portal del cliente.

​

Precision

number

Solo para créditos de Unidad Personalizada. Número de decimales permitidos:

• 0 - Números enteros (mejor para elementos contables como llamadas API)
• 1 - Un decimal (0.0)
• 2 - Dos decimales (0.00) - predeterminado
• 3 - Tres decimales (0.000)

La precisión no se puede cambiar después de crear el crédito.

​

Credit Expiry

string

Duración de validez de los créditos después de la emisión:

• 7 días, 30 días (predeterminado), 60 días, 90 días, Personalizado o Nunca

Selecciona Personalizado para especificar un número personalizado de días (mínimo 1).

4

Configure Subscription Settings (Optional)

Estas configuraciones controlan el comportamiento del crédito dentro de suscripciones recurrentes:

​

Rollover

boolean

Permitir que los créditos no utilizados se lleven al siguiente ciclo de facturación. Cuando está habilitado, configura:

• Porcentaje Máximo de Rollover (0–100%) - Limitar cuánto se lleva
• Período de Rollover - Duración de validez de los créditos llevados (p. ej., 1 mes)
• Máximo de Rollovers - Cantidad máxima de rollovers consecutivos antes de que los créditos se pierdan

Cuando se Agotan los Créditos o Expira la Suscripción:

​

Allow Overage

boolean

Permitir que los clientes sigan usando tu servicio después de que su saldo de créditos llegue a cero. Cuando está habilitado, configura:

• Límite de Exceso - Máximo de créditos que los clientes pueden consumir más allá de su saldo
• Precio por Unidad - Costo por crédito adicional cuando el exceso está habilitado (con selector de moneda)

​

Overage Behavior

string

requerido

Controla cómo se maneja el exceso al final del ciclo de facturación:

• Perdonar exceso al reinicio (predeterminado) - El uso más allá del límite de crédito se rastrea pero no se factura. El saldo se restablece en cada ciclo.
• Facturar exceso en la facturación - El uso más allá del límite de crédito se carga en la siguiente factura, luego el saldo se restablece.
• Llevar el déficit hacia adelante - El uso más allá del límite de crédito se lleva como un saldo negativo al siguiente ciclo.
• Llevar el déficit hacia adelante (auto-repago) - El déficit se lleva y se repaga automáticamente con nuevos créditos en el siguiente ciclo.

5

Create Credit

Haz clic en Crear Crédito para guardar. El crédito ahora está disponible para adjuntar a cualquier producto.

Tu derecho de crédito está listo. Adjuntalo a productos para comenzar a emitir créditos a los clientes.

​

Adjuntar Créditos a Productos

​

Productos de Suscripción

1

Create or Edit a Subscription Product

Ve a Productos → Crear Producto o edita un producto existente. Selecciona Suscripción como tipo de precio y configura tu precio recurrente.

2

Open Entitlements Section

Expande la sección Derechos y haz clic en el botón Adjuntar junto a Créditos.

3

Select Credits to Attach

Se abre un panel de Agregar Créditos. Puedes seleccionar un crédito existente del menú desplegable o hacer clic en Crear nuevo crédito para definir uno en el momento.

Puedes adjuntar hasta 5 créditos por producto. Cada crédito puede tener su propia configuración.

4

Configure Credit Settings

Para cada crédito adjunto, configura:

​

Credits issued per billing cycle

number

requerido

La cantidad de créditos otorgados al cliente cada período de facturación.

​

Low Balance Threshold

number

Notificar cuando los créditos caen por debajo de esta cantidad. Útil para alertar a los clientes antes de que se queden sin créditos.

​

Credits During Free Trial

number

Establece una cantidad diferente de créditos para los períodos de prueba. Habilita Expirar créditos de prueba después de que termine la prueba para revocar créditos de prueba no utilizados cuando la prueba se convierte en una suscripción de pago.

​

Allow Proration

boolean

Prorratea los créditos restantes cuando un cliente mejora o reduce su plan de suscripción.

​

Import Default Credit Settings

boolean

Usa la configuración predeterminada de rollover, exceso y expiración del derecho de crédito. Desactívalo para personalizar configuraciones específicamente para este producto.

5

Review and Add

Revisa el crédito adjunto mostrando el nombre, cantidad y expiración. Haz clic en Agregar a Suscripción para confirmar.

​

Productos de Pago Único

1

Create a One-Time Product

Crea un producto con tipo de precio Pago Único.

2

Attach Credits

Abre la sección Derechos y adjunta créditos. Configura el número de créditos emitidos (total otorgamiento único) en la compra.

​

Productos de Facturación Basada en Uso

1

Create a Usage-Based Product

Selecciona Facturación Basada en Uso como tipo de precio. Configura el precio base y la frecuencia de facturación.

2

Add a Meter

Haz clic en el botón + en la sección Seleccionar medidor para agregar un medidor. Una suscripción puede tener hasta 3 medidores.

3

Enable Credit Billing on the Meter

Activa Facturar uso en Créditos para adjuntar un crédito al medidor. Selecciona el derecho de crédito del menú desplegable.

​

Free Threshold

number

requerido

El número de unidades que son gratis antes de que la deducción de créditos comience.

​

Bill usage in Credits

boolean

Cuando está habilitado, el uso del medidor se deduce del saldo de crédito del cliente en lugar de cobrar por unidad.

​

Meter units per credit

number

requerido

El número de unidades de uso requeridas para deducir 1 crédito. Por ejemplo, si se establece en 1000, entonces 1,000 llamadas API consumen 1 crédito.

4

Configure Credit Issuance

Establece el número de créditos emitidos y, opcionalmente, personaliza las configuraciones de crédito para este producto.

5

Verify Attachment

Una vez configurado, el medidor muestra el nombre del crédito adjunto, el precio por unidad y el umbral libre.

​

Configuraciones de Crédito

​

Rollover

​

Exceso

​

Expiración

​

Facturación de Uso con Créditos

​

Cómo Funciona la Deducción de Créditos Basada en Medidores

1. Tu aplicación envía eventos de uso - Cada evento incluye un ID de cliente, nombre del evento y metadatos
2. Los medidores agregan eventos - Usando agregación de Conteo, Suma, Máximo o Último
3. Los créditos se deducen automáticamente - Un trabajador en segundo plano procesa eventos cada minuto, convierte unidades de medidor en créditos usando tu tasa configurada, y deduce del saldo del cliente usando el orden FIFO (primero las concesiones más antiguas)
4. Se rastrea el exceso - Si el saldo de créditos llega a cero y el exceso está habilitado, el sistema rastrea el uso excesivo para la facturación al final del ciclo

​

Panel de Medidores

​

Experiencia del Cliente

​

Checkout

​

Portal del Cliente

• Saldo Disponible: Saldo de crédito actual mostrado prominentemente
• Pestañas de Crédito: Cambia entre diferentes tipos de créditos (p. ej., “Créditos OpenAI”, “Tokens de Uso”)
• Transacciones Recientes: Historial completo con fecha, ID de transacción, tipo, cantidad y saldo en curso

​

Detalles de Suscripción

• Asignación de crédito por ciclo de facturación (p. ej., “1000 créditos cada ciclo”)
• Saldo restante (p. ej., “7500 créditos restantes”)
• Fecha de renovación para la próxima emisión de crédito
• Pestaña Historial de Uso con desglose a nivel de medidor mostrando unidades consumidas, umbrales, precios por unidad y costos totales

​

Detalles de Transacción

​

Gestión de Créditos

​

Vistas del Panel de Control

​

Lista de Derechos de Crédito

​

Detalles de Crédito del Cliente

• Selector de Crédito: Cambia entre diferentes derechos de crédito
• Saldo Disponible: Saldo actual en gran exhibición
• Aplicar Crédito/Débito: Botón para ajustar manualmente el saldo del cliente
• Transacciones Recientes: Libro de contabilidad completo con fecha, ID de transacción, tipo, cantidad y saldo en curso

​

Ajustes Manuales

​

Libro Mayor de Créditos

​

Webhooks

​

Gestión de API

​

Ejemplo de Integración

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode', // defaults to 'live_mode'
});

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

await client.usageEvents.ingest({
  events: [{
    event_id: `gen_${Date.now()}`,
    customer_id: 'cus_abc123',
    event_name: 'ai.generation',
    timestamp: new Date().toISOString(),
    metadata: { model: 'gpt-4', tokens: 1500 }
  }]
});

​

Ejemplos del Mundo Real

​

Mejores Prácticas

• Comienza simple: Empieza con un solo tipo de crédito y sin rollover. Añade complejidad basada en la retroalimentación del cliente y patrones de uso.
• Establece expectativas claras: Muestra asignaciones de crédito, saldos restantes y precios de exceso de manera prominente en tus páginas de producto y portal del cliente.
• Usa unidades significativas: Nombra créditos por lo que representan (p. ej., “Llamadas API”, “Tokens AI”) en lugar de términos genéricos. Esto ayuda a los clientes a entender el valor.
• Configura expiración con cuidado: Ventanas de expiración cortas (7 días) generan urgencia pero pueden frustrar a los clientes. Ventanas más largas (30–90 días) son más amigables para la mayoría de productos SaaS.
• Monitorea bajos saldos: Establece umbrales de bajos saldos para alertar a los clientes antes de que se queden sin créditos, reduciendo las sorpresas de cargos por exceso.
• Prueba en modo de prueba: Crea créditos, ajútalos a productos de prueba y simula el ciclo completo de compra → uso → deducción → caducidad antes de ir en vivo.