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

Introduce un Credit Name; este es el identificador interno del 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.

• Custom Unit: Define tu propia métrica (tokens, llamadas a la API, horas de cómputo). Requiere un Unit Name (por ejemplo, “Platform tokens”) y una configuración de Precision.
• Fiat Credits: Los créditos representan un valor monetario real. Requiere seleccionar una Unit Currency (USD, EUR, GBP, INR, etc.).

​

Unit Name

string

Solo para créditos de tipo Custom Unit. La etiqueta que los clientes ven para este crédito (por ejemplo, “AI Tokens” o “API Calls”). Se muestra en el checkout y en el Customer Portal.

​

Precision

number

Only for Custom Unit credits. Number of decimal places allowed, from 0 to 10:

• 0: Números enteros (recomendado para elementos contables, como las llamadas a la API)
• 1: Un decimal (0.0)
• 2: Dos decimales (0.00), valor predeterminado
• 3: Tres decimales (0.000)
• Hasta 10: Para unidades de alta precisión (por ejemplo, tokens fraccionarios o microconsumo)

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:

• Max Rollover Percentage (0–100 %): Limita cuánto se transfiere al siguiente ciclo
• Rollover Timeframe: Durante cuánto tiempo siguen siendo válidos los créditos transferidos (por ejemplo, 1 Month)
• Max Rollover Count: Número máximo de transferencias consecutivas antes de que se pierdan los créditos

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:

• Overage Limit: Máximo de créditos que los clientes pueden consumir por encima de su saldo
• Price Per Unit: Coste de cada crédito adicional cuando el exceso de uso está habilitado (con selector de moneda)

​

Overage Behavior

string

requerido

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

• Forgive overage at reset (predeterminado): El uso que supera el límite de créditos se registra, pero no se factura. El saldo se restablece en cada ciclo.
• Bill overage at billing: El uso que supera el límite de créditos se cobra en la siguiente factura y después se restablece el saldo.
• Carry over deficit: El uso que supera el límite de créditos se transfiere al siguiente ciclo como saldo negativo.
• Carry over deficit (auto-repay): El déficit se transfiere al siguiente ciclo y se paga automáticamente con los nuevos créditos.

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

Notifica cuando el saldo caiga por debajo de este porcentaje (0–100). Útil para alertar a los clientes antes de que se queden sin saldo.

​

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 + de la sección Select meter para añadir un meter. Una suscripción puede tener hasta 50 meters.

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

Solo se aplica cuando el meter factura en dinero. Cuando el meter factura en créditos, cada unidad se descuenta del saldo de créditos.

​

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

​

Billing basado en el uso con créditos

​

Cómo funciona la deducción de créditos basada en meters

1. Tu aplicación envía eventos de uso: Cada evento incluye un ID de cliente, un nombre de evento y metadatos
2. Los meters agregan eventos: Mediante la agregación Count, Sum, Max o Last
3. Los créditos se descuentan automáticamente: Un worker en segundo plano procesa los eventos cada minuto, convierte las unidades del meter en créditos usando la tarifa configurada y descuenta el importe del saldo del cliente mediante el orden FIFO (primero las concesiones que caducan antes)
4. El exceso de uso se registra: Si el saldo de créditos llega a cero y el exceso de uso está habilitado, el sistema registra el uso excedente para facturarlo al final del ciclo

​

Panel de Meters

​

Experiencia del cliente

​

Checkout

​

Customer Portal

• Available Balance: Saldo de créditos actual mostrado de forma destacada
• Credit Tabs: Permite cambiar entre diferentes tipos de crédito (por ejemplo, “OpenAI Credits” o “Usage Tokens”)
• Recent Transactions: Historial completo con fecha, ID de transacción, tipo, importe y saldo acumulado

​

Detalles de la suscripción

• Credit allocation por ciclo de billing (por ejemplo, “1000 credits each cycle”)
• Remaining balance (por ejemplo, “7500 credits remaining”)
• Renewal date para la siguiente emisión de créditos
• Pestaña Usage History con un desglose por meter que muestra las unidades consumidas, los umbrales, los precios unitarios y los costes totales

​

Detalles de la transacción

​

Gestión de créditos

​

Vistas del dashboard

​

Lista de derechos de crédito

​

Detalles de los créditos del cliente

• Credit Selector: Cambia entre diferentes derechos de crédito
• Available Balance: Saldo actual mostrado de forma grande y destacada
• Apply Credit/Debit: Botón para ajustar manualmente el saldo del cliente
• Recent Transactions: Ledger completo con fecha, ID de transacción, tipo, importe y saldo acumulado

​

Ajustes manuales

​

Ledger de créditos

​

Webhooks

​

Gestión mediante 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: 'pdt_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

​

Prácticas recomendadas

• Empieza de forma sencilla: Comienza con un único tipo de crédito y sin rollover. Añade complejidad según los comentarios de los clientes y los patrones de uso.
• Establece expectativas claras: Muestra de forma destacada las asignaciones de créditos, los saldos restantes y los precios del exceso de uso en las páginas de tu producto y en el Customer Portal.
• Utiliza unidades significativas: Da a los créditos el nombre de aquello que representan (por ejemplo, “API Calls” o “AI Tokens”) en lugar de términos genéricos. Esto ayuda a los clientes a comprender su valor.
• Configura la expiración cuidadosamente: Los periodos de expiración cortos (7 días) generan urgencia, pero pueden frustrar a los clientes. Los periodos más largos (30–90 días) son más adecuados para los clientes de la mayoría de los productos SaaS.
• Supervisa los saldos bajos: Configura umbrales de saldo bajo para avisar a los clientes antes de que se queden sin créditos y reducir los cargos inesperados por exceso de uso.
• Prueba en modo de prueba: Crea créditos, asócialos a productos de prueba y simula el ciclo completo de compra → uso → deducción → expiración antes de pasar a producción.