En el capítulo 8 viste los tres modos de facturación de un tenant, y en el 7, los cortes por saldo y por límites. Este capítulo sigue el dinero: cuándo una conversación cuesta algo, a quién se le descuenta, cómo se recarga y qué cambia al pasar de un plan a otro.
Cuándo una ejecución cuesta algo
Una ejecución solo genera un cobro cuando usa una conexión de modelo heredada: la configuró un ancestro, por ejemplo la agencia, y el tenant la usa. Si el tenant cargó su propia clave de proveedor (capítulo 2), el proveedor le cobra directo y la plataforma no descuenta nada ni controla el saldo.
Por eso, en el caso típico, Clínica del Sol no tiene claves propias: usa las conexiones de Nortelink, y cada respuesta del agente de turnos tiene un costo que alguien tiene que pagar.
Quién paga
La plataforma busca al pagador subiendo por el árbol de tenants desde el que consumió:
- Si el tenant está en modo ilimitado y tiene padre, sube al padre.
- Repite hasta encontrar un tenant que no sea ilimitado, o llegar a la raíz.
- Ese tenant paga.
| Clínica del Sol | Nortelink | Quién paga |
|---|---|---|
| Ilimitado (el modo con el que nace) | Prepago | Nortelink, de su saldo |
| Prepago | Prepago | Clínica del Sol, de su saldo. El de Nortelink no se toca |
| Pospago | Cualquiera | Clínica del Sol, a cuenta |
Se descuenta un solo saldo por ejecución: el del pagador. No hay reparto entre la agencia y la plataforma.
Cuánto se cobra
El importe sale de la configuración del pagador:
- Si tiene un precio propio por modelo (por millón de tokens), se usa ese.
- Si no, el costo real del proveedor multiplicado por su multiplicador de precio. El multiplicador se hereda de los ancestros y, si nadie lo define, es 1.
El descuento se hace una vez por ejecución, al terminar todos los pasos. Si el descuento falla, la respuesta igual llega al usuario.
Precios propios y multiplicador los configura un super admin, en la facturación de cada tenant. Una agencia no fija los precios de sus clientes desde su cuenta.
Lo que ve el cliente: la pantalla Facturación
Con la funcionalidad de autogestión habilitada, el menú muestra Facturación, con dos pestañas:
- Resumen: la Billetera, con el saldo, la recarga automática y los botones para recargar y gestionar medios de pago; y la Suscripción, con el plan, su estado, la próxima renovación y el botón para cambiar de plan.
- Transacciones: recargas, ajustes, descuentos por consumo y reinicios de ciclo.

Recargar saldo
Recargar Billetera ofrece montos fijos en dólares —5, 10, 25, 50, 100, 250 o 500, salvo que la instalación los cambie— y abre el pago en Stripe. Al volver, la pantalla muestra "Estamos confirmando tu recarga" hasta que llega la confirmación.
El saldo se acredita solo cuando Stripe confirma el pago, no cuando el usuario vuelve a la pantalla. Una misma compra no se puede acreditar dos veces.
Gestionar Métodos de Pago abre el portal de clientes de Stripe, que es donde están las tarjetas y las facturas. La plataforma no emite facturas propias.
Cuando el saldo llega a cero
Un tenant prepago necesita saldo mayor que cero para que una ejecución empiece. Sin saldo:
- El usuario final lee: "El asistente no está disponible en este momento."
- El admin del tenant ve un aviso: Tu asistente está pausado por falta de saldo, con el botón Recargar.
- Se genera el aviso de saldo agotado (capítulo 7).
En cuanto se acredita una recarga, el agente vuelve a responder; no hay que reactivar nada.
Planes
Un plan empaqueta un precio mensual o anual con lo que el tenant recibe al tenerlo:
- Saldo inicial, que se suma al saldo una sola vez cuando se asigna el plan.
- Saldo incluido por ciclo, que se aplica en cada renovación.
- Límites, funcionalidades, límites por minuto y modo de facturación, que reemplazan los del tenant al asignar el plan.
Los planes los crea y los asigna un super admin. Un tenant ve sus propios planes y los de sus ancestros, y puede comprar los que son públicos, tienen precio en Stripe para el intervalo elegido y están habilitados para él.
Cambiar de plan
Cambiar Plan lo pueden usar el propietario y los administradores del tenant. Qué pasa depende de la dirección:
- Subir de plan: se aplica en el momento. Stripe cobra la diferencia prorrateada y el tenant recibe enseguida los límites y funcionalidades del plan nuevo.
- Bajar de plan: queda programado para el fin del período. La pantalla muestra el cambio pendiente y el tenant conserva el plan actual hasta entonces.
- Sin suscripción en Stripe: subir de plan pasa por el pago en Stripe; bajar se aplica directo.
Se aceptan códigos de promoción, y antes de confirmar se muestra una vista previa del importe.
La renovación reinicia el saldo
Cuando Stripe cobra la renovación de un plan con saldo incluido, el saldo se fija en ese monto; no se suma. Lo que quedaba del ciclo anterior, recargas incluidas, se pierde. Si un cliente recarga a mitad de ciclo, conviene avisarle que esa recarga vence con la renovación.
Quién puede hacer qué
| Acción | Quién |
|---|---|
| Ver facturación y transacciones | Cualquier usuario del tenant |
| Recargar | Cualquier usuario que vea la pantalla Facturación |
| Comprar o cambiar plan | Propietario o administrador, con planes habilitados |
| Modo de facturación, multiplicador, precios, ajustes de saldo | Super admin |
| Crear y asignar planes | Super admin |
Las funcionalidades Autogestión de facturación y Planes se habilitan por tenant y también dependen de la licencia de la instalación. Stripe se configura una vez para toda la instalación: una agencia no conecta su propia cuenta de Stripe.
Dónde termina
- Solo Stripe y solo dólares. No hay otros medios de pago ni monedas.
- La recarga automática todavía no funciona. La pantalla permite configurar monto y umbral, pero la plataforma no guarda el medio de pago que necesita para cobrar sola, así que nunca se dispara. Hasta que se resuelva, el saldo se recarga a mano.
- El límite duro y el límite suave no cortan nada, aunque la pantalla diga que bloquean el servicio. Los cortes reales son el saldo y los límites de consumo mensuales (capítulo 7).
- Los mensajes incluidos de un plan son informativos. Para limitar mensajes hay que usar los límites de consumo.
- Una suscripción vencida o cancelada no corta el servicio: el runtime no mira la suscripción, solo el saldo y los límites.
- La agencia no ve el detalle de consumo de un cliente ilimitado en sus propias transacciones, aunque lo esté pagando.
- Un cambio de plan puede desligar la suscripción de Stripe. Después de subir de plan, un segundo cambio puede tomar el camino de "sin suscripción". Antes de un segundo cambio, revisá la suscripción en Stripe.
- No hay reparto de margen entre la plataforma y la agencia: el multiplicador es el único recargo.
Para revisar
- Cada cliente tiene el modo correcto: si está en ilimitado, lo paga la agencia.
- Los tenants prepagos tienen un umbral de saldo bajo con margen para recargar a mano.
- Los límites de consumo mensuales están definidos donde hace falta un tope real.
- Los clientes con plan saben que la renovación reinicia el saldo.
- Los planes públicos tienen precio en Stripe para cada intervalo que se ofrece.