Stripe Meter Event
Stripe Meter Event envía a Stripe un registro de consumo de un cliente: cuántas llamadas ha hecho, cuántas unidades ha usado, cuántos minutos ha consumido. Stripe suma esos registros en un medidor y los cobra según el precio por uso que tengas configurado.
Sirve para la facturación por uso: el cliente paga lo que consume en lugar de una cuota fija. El medidor y su precio se configuran antes en Stripe; este componente solo envía los consumos.
Cuándo usarlo
- Cobras a tus clientes por cada documento que procesa tu flujo y quieres registrar cada uno en Stripe.
- Vendes un asistente de IA y quieres cobrar por las consultas que hace cada cliente.
- Al final de cada día quieres enviar a Stripe el total de unidades consumidas por cada cliente.
Configuración
Necesitas una credencial Stripe API con la clave secreta de tu cuenta de Stripe. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Stripe API de tu cuenta. |
| Event Name (obligatorio) | El nombre del evento tal como lo configuraste en el medidor de Stripe, por ejemplo consultas_asistente. Hasta 100 caracteres. |
| Customer ID (obligatorio) | El identificador del cliente en Stripe (empieza por cus_) al que se asigna el consumo. |
| Value (obligatorio) | La cantidad consumida, un número. Por ejemplo, 1 por cada consulta o 250 por 250 unidades. |
| Identifier | Un identificador único del registro, hasta 100 caracteres. Si envías dos veces el mismo, Stripe solo lo cuenta una vez. Vacío, Stripe genera uno. |
| Timestamp | El momento del consumo, como marca de tiempo Unix (número de segundos). Vacío, se usa el momento actual. Stripe solo acepta consumos de los últimos 35 días. |
Resultado
La salida Data devuelve el registro que Stripe ha aceptado, con el nombre del evento, el cliente, el valor y el momento del consumo.
Puedes conectarla a un registro propio o a una hoja de cálculo para llevar el control de lo enviado. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.
Ejemplo
Una empresa vende un servicio de extracción de datos de facturas y cobra cada documento procesado.
- En Stripe, crea un medidor con el evento
documentos_procesadosy un precio por unidad. - Al final del flujo que procesa cada documento, añade Stripe Meter Event.
- Pon Event Name en
documentos_procesados, pasa a Customer ID el identificador del cliente y pon Value en1. - En Identifier, pasa el identificador del documento, así un documento reprocesado no se cobra dos veces.
Buenas prácticas
- Usa siempre Identifier cuando el mismo flujo pueda ejecutarse más de una vez para el mismo consumo.
- Comprueba que Event Name coincide exactamente con el del medidor de Stripe; si no, el consumo no se suma al medidor que esperas.
Componentes relacionados
- Stripe Price: precios de tus productos.
- Stripe Subscription: suscripciones de tus clientes.
- Stripe Customer: crea y gestiona clientes.