Planes, límites y facturación — las respuestas claras

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.

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.

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.

Una petición reintentada nunca se rechaza por los eventos que ya registró: un lote reenviado con las mismas claves de idempotencia responde con los eventos que creó, incluso en el límite. Y cuando tu organización llega a un límite, su página Billing lo indica en tu plan y, si existe, señala el plan que se ajusta a tu uso.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

No. Los eventos enviados con una clave de prueba (mf_test_…) tienen su propia cuota mensual, una décima parte de la del plan: 5.000 en Drip, 20.000 en Flow, 70.000 en Stream y 400.000 en Torrent. Nunca cuentan en los eventos de producción del plan, y un paquete de eventos solo amplía la cuota de producción. Pasada la cuota de prueba (más el mismo pequeño margen que tiene el tráfico de producción), los nuevos eventos de prueba se rechazan con un error que la nombra.

Las claves de prueba también están limitadas a 60 solicitudes por minuto (claves de producción: 300), y los datos de prueba caducan: los eventos de uso de prueba se borran a los 30 días, y una suscripción de prueba sin uso durante 90 días se borra junto con su saldo y registro de prueba. Ninguna de las dos reglas toca los datos de producción.

La página Billing y el diálogo Usage de tu organización muestran los eventos de prueba del mes frente a su cuota, junto a los de producción.

La retención es cuánto tiempo se conservan tus eventos de uso de producción — de 45 días en Drip a 12 meses en Torrent. Los eventos más antiguos se borran, así que los resúmenes y analíticas llegan hasta ahí; expórtalos antes si quieres conservarlos más tiempo. Los saldos de créditos y el registro de transacciones de producción no se borran con ellos, sea cual sea el plan: cada concesión, descuento y cargo queda registrado. Los datos de prueba tienen su propio plazo, más corto — mira la pregunta anterior.

Comunidad (Drip): la documentación de este sitio, el foro de la comunidad (GitHub Discussions, para ambos SDK) 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.

Node.js (npm install meterflow, documentación) y Python (pip install meterflow, documentación). Ambos están totalmente tipados — el paquete de Node.js no tiene dependencias en tiempo de ejecución y el de Python solo depende de httpx — 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.

Sí. MeterFlow aloja una página que muestra a uno de tus clientes su saldo de créditos, sus movimientos recientes y el plan en el que está, con lo que queda de cada allowance medida — con tu nombre, tu logo y tus colores. Tu servidor crea un enlace con portal.createSession() (en Python create_session()) y envía al cliente a él; no hay ninguna página que construir ni alojar.

Un enlace dura una hora salvo que elijas otra cosa, un día como máximo, y es de solo lectura. Un botón Buy more puede abrir tu propia página de pago: MeterFlow nunca cobra el pago — cuando tu checkout lo confirma, tu servidor concede los créditos. Cómo encaja todo se explica en la guía del panel.

Puedes llevártelos en cualquier momento. Un owner o admin de la organización puede descargar eventos de uso, registro de créditos, suscripciones y reservas de créditos de cualquier proyecto en CSV o JSON Lines, un entorno (producción o prueba) por archivo — desde Exportar datos en la tabla Proyectos del panel, o desde la API (GET /api/v1/projects/{project_id}/export/{dataset}).

Cada fila se escribe exactamente como la API devuelve ese registro, y una tabla grande se descarga en una sola solicitud.

Las dos cosas se hacen desde el panel. Para eliminar una organización, su owner elige Eliminar en ella en el Dashboard: sus proyectos se desactivan al momento, y la organización con todo lo que contiene se elimina cuando han pasado 30 días. Un plan de pago se cancela antes desde su página Billing.

Para cerrar tu cuenta, abre tu perfil (tu imagen, arriba a la derecha), elige Eliminar cuenta y escribe tu contraseña. Elimina antes las organizaciones de las que eres owner; tu cuenta se elimina cuando han pasado 30 días. Hasta entonces puedes iniciar sesión y cancelar cualquiera de las dos. ¿No puedes iniciar sesión? Escribe a support@meter-flow.com.

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.