Saltar al contenido principal
La facturación basada en el uso te permite cobrar a los clientes por lo que realmente utilizan: llamadas a la API, almacenamiento, tokens de IA o cualquier métrica que definas. Los clientes pagan por el consumo, no por tarifas fijas.
Perfecto para: APIs, servicios de IA, plataformas de infraestructura y cualquier producto donde el valor escala con el uso.

​
Cómo Funciona

1

Send Usage Events

Tu aplicación envía eventos cuando ocurren acciones facturables.
{
  "event_id": "evt_123",
  "customer_id": "cus_abc",
  "event_name": "api.call",
  "metadata": { "endpoint": "/v1/users" }
}
2

Meters Aggregate Usage

Los medidores agregan eventos en cantidades facturables utilizando agregaciones Count, Sum, Max o Last.
3

Automatic Billing

Establece precios por unidad y umbrales gratuitos. Los clientes son facturados automáticamente cada ciclo.

​
Conceptos Clave

​
Eventos

Los eventos representan acciones de uso en tu aplicación. Cada evento incluye:
  • Nombre del evento: Tipo de uso (por ejemplo, api.call)
  • ID de cliente: Quién lo utilizó
  • Metadatos: Propiedades adicionales para la agregación

​
Medidores

Los medidores agregan eventos en cantidades facturables:
  • Conteo: Total de eventos (llamadas a la API)
  • Suma: Sumar valores (total de bytes)
  • Máximo: Valor más alto (usuarios picos)
  • Último: Valor más reciente
Interfaz de creación de medidor

​
Productos con Precios Basados en el Uso

Establece precios por unidad y umbrales gratuitos opcionales:
Configuración de precios
Ejemplo: 2,500 llamadas - 1,000 gratuitas = 1,500 × 0.02=0.02 = 30.00

​
Deducción basada en créditos

En lugar de cobrar por unidad en dólares, puedes configurar medidores para deducir del saldo de crédito de un cliente. Los créditos se renuevan en cada ciclo de facturación y se aplican antes de cualquier cargo por excedente.

​
Inicio Rápido

1

Create a Meter

En tu panel: Meters → Create Meter
  1. Define el nombre del evento (por ejemplo, api.call)
  2. Elige la agregación (Count, Sum, Max, Last)
  3. Agrega filtros opcionales
2

Add to Product

Vincula el medidor a un producto con precios:
Añadiendo medidor al producto
  1. Selecciona Usage-Based Billing
  2. Elige tu medidor
  3. Establece el precio por unidad y el umbral gratuito
3

Send Events

await fetch('https://test.dodopayments.com/events/ingest', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    events: [{
      event_id: "unique_event_id",
      customer_id: "cus_abc123",
      event_name: "api.call",
      metadata: { endpoint: "/v1/users" }
    }]
  })
});
4

Monitor Usage

Panel del medidor
Consulta el panel de tu medidor para ver eventos y la agregación del uso. Los clientes son facturados automáticamente cada ciclo.

​
Casos de Uso

APIs & Infrastructure

Realiza un seguimiento de llamadas a la API, horas de cómputo, ancho de banda, almacenamiento. Ejemplo: $0.001 por llamada después de 10,000 gratuitas.

AI Usage Tracking

Realiza un seguimiento de tokens, generaciones, tiempo de procesamiento. Ejemplo: $0.04 por imagen estándar, $0.08 por HD.

Data & Analytics

Factúra por datos procesados, consultas realizadas, registros analizados. Ejemplo: $5 por GB después de 10 GB gratuitos.

Communication

Cuenta mensajes, minutos, datos transferidos. Ejemplo: $0.01 por SMS enviado.

​
Próximos Pasos

Event Ingestion

Aprende a estructurar y enviar eventos de uso desde tu aplicación.

Meters Guide

Domina la configuración del medidor, los tipos de agregación y el filtrado de eventos.

Complete Tutorial

Construye un generador de imágenes de IA completo con facturación basada en uso desde cero.

Integration Guide

Guía completa para implementar facturación basada en uso en tu aplicación.