Planes y facturación
¿Qué cuenta exactamente como evento de uso?
Un evento de uso es un registro que tu aplicación envía a MeterFlow — “el cliente user-842 generó 1 imagen”, “42 segundos de vídeo renderizados”. Cada registro cuenta una vez, tanto si lo envías de uno en uno como si envías muchos en una sola llamada por lotes.
Los eventos se cuentan por organización — entre todos sus proyectos y todos tus clientes — en cada mes natural (UTC). Las lecturas nunca cuentan: consultar un saldo, listar planes o pedir un resumen de uso es gratis. Conceder o descontar créditos tampoco es un evento de uso.
Cómo un evento se convierte en una cifra en la página de uso de un cliente se explica en la guía del panel.
¿Puedo registrar el mismo uso con menos eventos?
Normalmente sí — y es la palanca más potente que tienes. Un evento de uso lleva una cantidad en su campo value, y un meter con agregación Sum suma esos valores. Así, un solo evento con value 1.300 es un evento frente a tu límite mensual y 1.300 unidades en el meter.
El estilo que agota un plan es un evento por cada llamada a la API: 1.000 usuarios haciendo 100 llamadas al día son unos 3 millones de eventos al mes. Agrega en tu propia aplicación durante la ventana que puedas permitirte perder si se cae — una petición, un trabajo, un minuto — y registra después un único evento con el total.
Ojo: el batch no es lo mismo. Enviar 100 eventos en una sola llamada batch ahorra peticiones HTTP, pero cada uno sigue siendo su propio registro y sigue contando. Solo agruparlos en un único evento con un value mayor reduce la cuenta.
Dos límites: funciona con meters Sum, porque los meters Count ignoran el valor y cuentan ocurrencias; y no cambia nada de lo que se paga, ya que un límite de plan «metered» cobra por unidad en cualquier caso.
¿Qué pasa cuando mi organización alcanza su límite mensual de eventos?
Lo sabrás mucho antes de que te afecte: enviamos un correo al contacto de facturación de la organización al 80 % y de nuevo al 100 % de los eventos incluidos, y la página de Facturación muestra el consumo del mes frente a tu plan.
Superar el 100 % no detiene la ingesta al instante: un pequeño margen por encima de la cantidad incluida mantiene tu tráfico de producción mientras decides. Pasado ese margen, los nuevos eventos de uso se rechazan con un error claro “Plan limit reached” (HTTP 403) hasta que subas de plan o empiece el nuevo mes. Nada se pierde en silencio y nada se cobra — MeterFlow nunca factura excedentes.
Todo lo demás sigue funcionando: los eventos ya registrados, los saldos de créditos, las suscripciones, el panel y todos los endpoints de lectura. El contador se reinicia al comienzo de cada mes natural (UTC); subir de plan eleva el límite de inmediato, y un paquete de eventos lo eleva para el mes en curso.
Tu aplicación recibe el rechazo como un error normal de la API: trátalo como cualquier otro 4xx — regístralo y no reintentes a ciegas.
¿Pago por evento? ¿Hay cargos por exceso?
No. Cada plan tiene un precio mensual fijo con un número fijo de eventos incluidos. La fila “Precio efectivo / 1.000 eventos” de la página de precios es simplemente ese precio dividido por los eventos incluidos — una cifra de comparación homogénea, no una tarifa que cobremos.
Si necesitas más eventos de los que incluye tu plan tienes dos caminos, y ninguno es una factura por consumo: subir de plan, o añadir un paquete de eventos — 100.000 eventos extra por 15 $, desde tu página de Facturación, hasta diez a la vez. Un paquete cubre el mes en que lo compras (si lo compras en los últimos cinco días del mes, cubre también el siguiente) y no se acumula. Está deliberadamente por encima de la tarifa efectiva de cualquier plan de pago: para un crecimiento sostenido sale mejor subir de plan; el paquete es para el pico que no esperabas.
¿Puedo pagar anualmente?
Por ahora no — todos los planes se facturan mensualmente. Si la facturación anual es importante para tus compras, escríbenos a support@meter-flow.com.
¿Cómo funciona el pago — moneda, IVA, facturas?
El checkout y la facturación los gestiona Paddle, nuestro merchant of record. Los precios están en USD; Paddle muestra tu moneda local y el IVA o impuesto aplicable en el checkout, cobra el pago (tarjetas, PayPal, Apple Pay, Google Pay) y emite la factura. Las empresas pueden introducir su número de IVA en el checkout.
¿Puedo subir o bajar de plan, o cancelar?
Sí, en cualquier momento. Subir de plan eleva tus límites de inmediato. Si cancelas, tu plan sigue activo hasta el final del periodo pagado. Tu primer pago está cubierto por una garantía de devolución de 14 días — consulta la política de reembolsos.
Bajar de plan nunca borra nada: si tu organización supera los límites del plan inferior, lo que existe sigue funcionando; simplemente no puedes añadir más hasta volver a estar por debajo.
Organizaciones, proyectos y equipo
Organización o proyecto — ¿cuál necesito?
Un proyecto, casi siempre. Un proyecto es un producto o app: tiene sus propias claves API, meters, planes, saldos de clientes y uso, y los proyectos nunca ven los datos de los demás. Todos los proyectos de una organización comparten una sola cuota de eventos y una sola factura — cada plan de pago incluye 20.
Una organización es el límite de facturación: su propio plan, su propia cuota de eventos, su propia factura, su propio equipo. Crea una segunda solo cuando realmente necesites facturación separada o un equipo separado — dos empresas, por ejemplo. Cada organización se factura con su propio plan, y las adicionales empiezan gratis en Drip.
Tengo varios productos, o soy una agencia con varios clientes — ¿una organización o varias?
Una sola organización, con un proyecto por producto o cliente. Pagas una vez y la cuota de eventos se comparte entre todos. Varias organizaciones significan varias facturas.
Dale a un cliente su propia organización solo si debe recibir su propia factura y gestionar su propio equipo — esa organización funcionará entonces con su propio plan.
¿Mis propios clientes cuentan como usuarios del equipo?
No. Los usuarios del equipo son tus compañeros en el panel — tú más las personas que invitas. Tus usuarios finales nunca inician sesión en MeterFlow: existen solo como IDs de cliente en tu proyecto, son ilimitados en todos los planes y no tienen coste por cliente.
Me han invitado a la organización de otra persona — ¿afecta a mis límites?
No. El límite de organizaciones solo cuenta las que posees. Dentro de una organización a la que te invitaron se aplica el plan de su propietario — a todos sus miembros.
Límites y entornos
¿Los proyectos, meters, claves API y webhooks están realmente limitados en los planes de pago?
Sí, y las cifras están publicadas: 20 proyectos, 75 meters por proyecto, 10 claves API por proyecto y entorno, 30 endpoints de webhook por proyecto — iguales en todos los planes de pago. Son techos de plataforma dimensionados para que una integración real nunca los alcance, no palancas de venta: subir de plan no los mueve. Si tu integración realmente necesita más, escribe a support@meter-flow.com.
El plan gratuito Drip tiene límites más pequeños para evaluar (2 proyectos, 5 meters, 4 claves API por entorno, 3 webhooks); ahí, subir de plan sí los eleva. El límite de claves API se mantiene moderado incluso en los planes de pago a propósito: cada clave activa es una credencial con su propio límite de peticiones, así que es un techo de seguridad — revoca las claves que ya no uses.
¿Qué pasa si alcanzo uno de esos límites?
La acción de creación se rechaza con un mensaje que nombra el límite — nada de lo que ya existe se ve afectado. En Drip el mensaje te invita a subir de plan, porque los límites de pago son mayores; en un plan de pago te remite al soporte, porque subir de plan no cambiaría el límite y no queremos prometer lo contrario.
¿Los entornos de prueba y producción necesitan planes separados?
No — todos los planes incluyen ambos. Las claves de prueba (mf_test_…) y de producción (mf_live_…) escriben en datos completamente aislados: saldos, suscripciones y uso nunca se mezclan, mientras que meters y planes son configuración compartida que defines una sola vez. El límite de claves API se aplica por entorno: un proyecto tiene el número completo de claves de producción y el número completo de claves de prueba.
¿Qué significa retención de analíticas — pierdo datos?
La retención es hasta cuándo tu historial de uso sigue siendo consultable para resúmenes y analíticas — de 45 días en Drip a 12 meses en Torrent. Los saldos de créditos y el registro de transacciones nunca se borran, sea cual sea el plan: cada concesión, descuento y cargo queda registrado.
Ayuda
¿Qué significan los niveles de soporte?
Comunidad (Drip): la documentación de este sitio y los issue trackers de los repositorios públicos de los SDK (Node.js, Python) — consultables en cualquier momento, respondidos cuando podemos, sin respuesta garantizada. Email (Flow): escribe a support@meter-flow.com (o usa el formulario de ayuda) y te responde una persona. Prioritario (Stream y Torrent): tus mensajes se atienden antes en la cola.
Ningún plan incluye todavía un SLA contractual — no publicaremos uno hasta poder cumplirlo.
¿Para qué lenguajes hay SDK?
Node.js (npm install meterflow, documentación) y Python (pip install meterflow, documentación). Ambos están totalmente tipados, tienen una sola dependencia y cubren las mismas operaciones: créditos, eventos de uso, suscripciones, planes y comprobaciones de entitlements, además de una vista de solo lectura de tus endpoints de webhook y sus recibos de entrega. Cualquier otro lenguaje llama directamente a la API REST — los SDK son envoltorios finos sobre ella, no un conjunto de funciones aparte.
¿Dónde aprendo cómo funcionan realmente los meters, planes, créditos y eventos de uso?
La guía del panel explica cada diálogo campo por campo con ejemplos, y el tour del panel muestra las pantallas. Esta página solo cubre planes y facturación.