Billing y wallet
Administra la suscripción de Stripe, pagos y saldo prepago para consumo.
Para que sirve
- Una agencia contrata un plan y conserva el saldo para el consumo variable de sus clientes sin mezclar ambos cobros.
- Un contact center mantiene continuidad en mensajería, IA y voz recargando saldo cuando llega a un umbral definido.
- Un negocio revisa créditos, débitos y consumo diario para explicar el gasto operativo de la cuenta.
- Un administrador recibe alertas cuando falla el cobro del plan o de un reintento de Stripe.
Que lo hace diferente
- Separa el plan recurrente de Stripe del wallet prepago: el wallet registra recargas y consumos variables de asistentes y herramientas de IA, síntesis de voz, transcripción y grabación de reuniones, envíos masivos de correo, búsqueda de productos, generación de contenido y trámites 10DLC.
- La auto-recarga se programa por saldo mínimo y monto; límites móviles de 24 horas y 30 días pueden desactivarla después de una recarga pagada, conservando el motivo.
- Las notificaciones de cobro fallido alcanzan a owners y admins de cliente, sin afectar el estado por la mera notificación.
Acceso
- Ruta principal:
/[orgId]/settings - Como se llega:
Avatar menu > Settings - Permiso requerido: owner o admin de la organización
Alcance tecnico
- Frontend: rutas de Settings y My Profile relacionadas
- Backend: servicios Feathers de este módulo
- Superficies publicas: no aplica salvo integraciones de terceros
- Integraciones externas: Stripe, Google, Microsoft, Wise, Meta, S3 o proveedores de voz según la funcionalidad
Funcionalidades internas
| Funcionalidad | Archivo | Resumen |
|---|---|---|
| Plan de suscripción | subscription-plan.md | Muestra el plan y complementos recurrentes, con acceso a cambio de plan. |
| Checkout de Stripe | stripe-checkout.md | Inicia el checkout de Stripe para contratar o cambiar la suscripción. |
| Cambio de plan | plan-changes.md | Permite actualizar o reducir el plan y compara las opciones disponibles. |
| Cancelación de suscripción | subscription-cancellation.md | Solicita la cancelación de la suscripción de la organización. |
| Facturas de Stripe | billing-invoices.md | Lista el historial de facturas de Stripe cuando existe cliente de Stripe. |
| Recarga de wallet | wallet-recharge.md | Añade fondos prepagos al wallet mediante Stripe. |
| Auto-recarga de wallet | wallet-auto-recharge.md | Configura el umbral y monto para recargar automáticamente cuando el saldo baja. |
| Protecciones de auto-recarga | wallet-safeguards.md | Desactiva futuras auto-recargas anómalas y muestra el motivo al superar los límites móviles de 24 horas o 30 días. |
| Uso de wallet | wallet-usage.md | Muestra el consumo por día y concepto, respetando la zona horaria de la organización. |
| Transacciones de wallet | wallet-transactions.md | Consulta créditos, débitos y referencias de movimientos de saldo. |
| Notificaciones de cobro fallido | billing-notifications.md | Envía email a owners y admins de cliente cuando falla el cobro del plan o un reintento. |
Relaciones
- Depende de: organizaciones, miembros y autenticación.
- Usado por: CRM, automatizaciones y las integraciones descritas.
Limitaciones y notas
- Se documenta únicamente el comportamiento confirmado en frontend, servicios y hooks revisados.