Transforma eventos de uso en bruto en cantidades facturables con agregación y filtrado.
Los medidores convierten eventos sin procesar en cantidades facturables. Filtran eventos y aplican funciones de agregación (Count, Sum, Max, Last) para calcular el uso por cliente.
La etiqueta de unidad para facturas e informes. Ejemplos: calls, tokens, GB, hours.
3
Filtering (Optional)
Agrega condiciones para filtrar qué eventos se cuentan:
Lógica AND: Todas las condiciones deben coincidir
Lógica OR: Cualquier condición puede coincidir
Comparadores disponibles: igual a, no igual a, mayor que, mayor o igual que, menor que, menor o igual que, contiene, no contiene.Activa el filtrado, elige la lógica y, a continuación, añade condiciones con una clave de propiedad, un comparador y un valor.
4
Create
Revisa tu configuración y haz clic en Create Meter.
De forma predeterminada, los medidores cobran a los clientes por unidad en dólares (o en la moneda configurada). En su lugar, puedes configurar un medidor para deducir del saldo de crédito de un cliente, de modo que el uso consuma créditos en lugar de generar un cargo monetario.
La deducción basada en créditos requiere un Credit Entitlement asociado al mismo producto. Crea primero el Credit Entitlement y, después, vincúlalo al medidor.
Primero, crea un Credit Entitlement en Products → Credits. Define la unidad (por ejemplo, “API Calls”, “Tokens”), la precisión y la configuración del ciclo de vida (caducidad, acumulación y exceso de uso).Consulta la guía de facturación basada en créditos para obtener instrucciones detalladas.
2
Create or Edit a Usage-Based Product
Ve a tu producto basado en uso y abre la sección de configuración del Medidor.
3
Add a Meter
Haz clic en el botón + para adjuntar un medidor. Configura el nombre del evento, el tipo de agregación y la unidad de medida como de costumbre.
4
Enable 'Bill Usage in Credits'
Activa Bill usage in Credits en la configuración del medidor para mostrar la configuración de créditos:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
El número de unidades de uso necesarias para deducir 1 crédito. Por ejemplo:
1 = cada evento del medidor deduce 1 crédito
100 = 100 eventos del medidor deducen 1 crédito
1000 = 1.000 llamadas a la API consumen 1 crédito
5
Free Threshold and Credits
El Free Threshold se aplica a los medidores facturados en dinero, no a los medidores facturados en créditos. Cuando un medidor factura en créditos, cada unidad cuenta para la deducción de créditos.Ejemplo: Con meter-units-per-credit igual a 1, a un cliente que realiza 2,500 llamadas a la API se le deducen 2,500 créditos.
Una vez configurado, la canalización de deducción se ejecuta automáticamente:
Llegan los eventos — Tu aplicación envía eventos de uso mediante la Event Ingestion API.
El medidor agrega los datos — Los eventos se agregan según la configuración del medidor (Count, Sum, Max, Last).
El worker en segundo plano procesa los datos — Cada minuto, un worker obtiene los nuevos eventos desde el último punto de control.
Se deducen los créditos — El uso agregado se convierte en créditos mediante la tasa meter_units_per_credit y se deduce mediante el orden FIFO (primero se consumen las concesiones que caducan antes).
Se realiza un seguimiento del exceso de uso — Si el saldo llega a cero, el uso adicional se registra como exceso de uso y se gestiona según el comportamiento configurado (se perdona al restablecerse, se factura en la siguiente factura o se arrastra como déficit). Dodo Payments no bloquea el uso cuando se agota el saldo. Para detener el acceso cuando llegue a cero, comprueba el saldo en tu aplicación.
La deducción de créditos se ejecuta de forma asíncrona (aproximadamente cada 1 minuto). Puede haber un breve retraso entre la ingesta del evento y la deducción del saldo. Diseña tu aplicación para gestionar este retraso y no dependas de comprobaciones del saldo en tiempo real para controlar el acceso en solicitudes individuales.
Puedes vincular varios medidores del mismo producto al mismo Credit Entitlement. Todos los medidores deducen de un único saldo compartido.Ejemplo: Una plataforma de IA con dos medidores:
text.generation — 1 crédito por cada 1.000 tokens
image.generation — 10 créditos por imagen
Ambos deducen del mismo fondo de “Créditos de IA”. El cliente ve un saldo unificado en su portal.
Usa diferentes tarifas meter_units_per_credit entre medidores para expresar costos relativos. Las operaciones costosas (generación de imágenes) requieren menos unidades del medidor por crédito que las operaciones baratas (completado de texto).
List Customer Ledger
Consulta el historial completo de deducción de créditos de un cliente.
Get Customer Balance
Consulta el saldo de créditos actual de un cliente mediante la API.
