Facturación y presupuestos de IA

Planes y unidades de IA

La facturación es por espacio. Gratis incluye 200.000 unidades de Muetext AI al mes, Pro 2.000.000 y Empresa 10.000.000, con límites de API más altos en los planes de pago. Las respuestas de bots que usan Muetext AI y la indexación de documentos gastan unidades del espacio; las que usan la clave del responsable del bot, no.

Una recarga de IA añade 1.000.000 de unidades al plan. Las unidades de recargas se gastan después de las del plan y se acumulan para el mes siguiente.

Mejorar y gestionar

Los responsables y administradores del espacio abren Ajustes → Facturación y eligen Mejorar, Recargar IA o Gestionar facturación. Mejorar y Recargar llevan a Stripe Checkout; Gestionar facturación abre el portal de clientes de Stripe para cambiar de plan, actualizar la tarjeta, ver facturas o cancelar. Los demás miembros ven el plan y el medidor de uso, pero no pueden cambiarlos.

El nuevo plan o la recarga aparece segundos después de un pago correcto. El medidor se pone ámbar al 80% de las unidades del mes y rojo al 100%, cuando el trabajo de Muetext AI se pausa hasta una recarga, una mejora o el mes siguiente.

Pagos fallidos

Si falla una renovación, el espacio mantiene su plan mientras Stripe reintenta el cobro, y Ajustes → Facturación pide al responsable actualizar la tarjeta. Si Stripe deja de reintentar, el espacio pasa al plan Gratis: no se borra nada y pagar la factura pendiente restaura el plan. Al cancelar, el plan sigue hasta el final del periodo pagado.

Cómo se aplica

Los planes y presupuestos solo cambian cuando Stripe confirma el pago, mediante una función de la base de datos que los usuarios de la app no pueden llamar. Cada cambio queda en el registro de auditoría. El webhook de Stripe en /api/channels/stripe verifica la cabecera Stripe-Signature (HMAC-SHA256, tolerancia de cinco minutos), registra cada id de evento una vez y omite los reenvíos, así que un reintento nunca duplica una recarga.

Activar Stripe (para el responsable de Muetext)

La facturación sigue apagada, y la app muestra "La facturación aún no está configurada", hasta que estén los cinco ajustes del servidor. Usa primero claves de prueba; los eventos reales y de prueba nunca se mezclan.

En Stripe, crea dos precios recurrentes (Pro y Empresa) y un precio único para la recarga de IA, y añade un endpoint de webhook para https://<tu-app>/api/channels/stripe con los eventos de abajo. Activa el cambio de plan y la cancelación en los ajustes del portal de clientes.

STRIPE_SECRET_KEY=sk_test_...        # o una clave restringida rk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...      # del endpoint de webhook
STRIPE_PRICE_PRO=price_...           # recurrente, mensual
STRIPE_PRICE_BUSINESS=price_...      # recurrente, mensual
STRIPE_PRICE_AI_TOPUP=price_...      # único, 1.000.000 de unidades cada uno

# eventos del webhook
checkout.session.completed
checkout.session.async_payment_succeeded
customer.subscription.created
customer.subscription.updated
customer.subscription.deleted
invoice.paid
invoice.payment_failed