> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Facturación Basada en el Uso
> Cobra a los clientes en función de lo que realmente utilizan con mediciones flexibles y facturación automatizada.
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
Tu aplicación envía eventos cuando ocurren acciones facturables.
```javascript theme={null}
{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
```
Los medidores agregan eventos en cantidades facturables utilizando agregaciones Count, Sum, Max o Last.
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
### Productos con Precios Basados en el Uso
Establece precios por unidad y umbrales gratuitos opcionales:
**Ejemplo**: 2,500 llamadas - 1,000 gratuitas = 1,500 × $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](/features/credit-based-billing) 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
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
Vincula el medidor a un producto con precios:
1. Selecciona **Usage-Based Billing**
2. Elige tu medidor
3. Establece el precio por unidad y el umbral gratuito
```javascript theme={null}
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" }
}]
})
});
```
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
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.
Realiza un seguimiento de tokens, generaciones, tiempo de procesamiento. Ejemplo: \$0.04 por imagen estándar, \$0.08 por HD.
Factúra por datos procesados, consultas realizadas, registros analizados. Ejemplo: \$5 por GB después de 10 GB gratuitos.
Cuenta mensajes, minutos, datos transferidos. Ejemplo: \$0.01 por SMS enviado.
## Próximos Pasos
Aprende a estructurar y enviar eventos de uso desde tu aplicación.
Domina la configuración del medidor, los tipos de agregación y el filtrado de eventos.
Construye un generador de imágenes de IA completo con facturación basada en uso desde cero.
Guía completa para implementar facturación basada en uso en tu aplicación.