Facturacion y Suscripciones
Administra tu plan de suscripcion, metodo de pago e historial de facturacion a traves del portal de facturacion de Stripe.
Planes
| Funcion | Trial | Starter | Pro |
|---|---|---|---|
| POS y pedidos | Si | Si | Si |
| Gestion de menu | Si | Si | Si |
| Pantalla de cocina | Si | Si | Si |
| Inventario | - | Si | Si |
| Reportes | Basico | Completo | Completo |
| Integraciones de delivery | - | - | Si |
| Inteligencia de delivery | - | - | Si |
| Sugerencias de IA | - | - | Si |
| Marcas virtuales | - | - | Si |
| Lealtad y CRM | - | Si | Si |
| Marca personalizada | - | - | Si |
Administrar Tu Suscripcion
Mejorar Plan
- Ve a Configuracion > Facturacion
- Selecciona el plan al que deseas subir
- Seras redirigido a Stripe Checkout
- Completa el pago
- Tu plan se actualiza inmediatamente
Bajar de Plan
- Ve a Configuracion > Facturacion > Administrar Suscripcion
- Esto abre el Portal de Cliente de Stripe
- Selecciona un plan inferior
- El cambio toma efecto al final de tu periodo de facturacion actual
Cancelar
- Abre el Portal de Cliente de Stripe desde Configuracion > Facturacion
- Cancela tu suscripcion
- El acceso continua hasta el final del periodo pagado
Metodos de Pago
Administra metodos de pago a traves del Portal de Cliente de Stripe:
- Agrega o elimina tarjetas de credito/debito
- Establece un metodo de pago predeterminado
- Ve facturas proximas
Eventos de Facturacion
El sistema maneja estos eventos de facturacion automaticamente:
| Evento | Accion |
|---|---|
| Checkout completado | Plan activado, tenant actualizado |
| Suscripcion actualizada | Nivel de plan cambiado |
| Suscripcion eliminada | Revertido a trial |
| Pago fallido | Notificacion enviada, periodo de gracia inicia |
Facturas
Accede a tu historial completo de facturacion y descarga facturas desde el Portal de Cliente de Stripe.
Stripe Webhook
El sistema de facturacion depende de un webhook de Stripe para mantenerse sincronizado con cambios en la suscripcion.
URL del Webhook: https://pos.desktop.kitchen/api/billing/webhook
Eventos Manejados
| Evento | Accion |
|---|---|
checkout.session.completed | Activa el plan, vincula el cliente de Stripe al tenant |
customer.subscription.updated | Actualiza el nivel de plan (starter/pro) |
customer.subscription.deleted | Revierte el tenant al plan trial |
invoice.payment_failed | Registra la falla, inicia periodo de gracia |
Configuracion
- En el Dashboard de Stripe, crea un endpoint apuntando a
https://pos.desktop.kitchen/api/billing/webhook - Selecciona los cuatro eventos listados arriba
- Copia el signing secret y establecelo como la variable de entorno
STRIPE_WEBHOOK_SECRET
La ruta del webhook esta montada antes del middleware express.json() para que Stripe pueda verificar la firma del body crudo de la solicitud. Si agregas middleware de parseo de body global, asegurate de que la ruta del webhook quede excluida.