Guía de instalación y configuración de SubscriptionConfigurator

SubscriptionConfigurator te permite vender suscripciones online: tus clientes arman su plan a medida en una página pública, pagan con tarjeta a través de Stripe, y FacturaScripts genera la factura ya cobrada automáticamente. Esta guía te lleva paso a paso desde la instalación hasta tu primera venta real.

🧰 Antes de empezar

Necesitás:

✅ Una cuenta de Stripe (podés probar todo en modo test antes de activar cobros reales).
✅ La extensión PHP sodium habilitada en tu servidor (la mayoría de los hostings ya la trae activada; se usa para guardar tus claves de Stripe de forma cifrada).

📦 1. Instalar el plugin

Subí el plugin desde Admin → Plugins → Subir plugin, seleccioná el archivo .zip y activalo. Al activarse, el plugin crea sus propias tablas — no necesitás hacer nada más en la base de datos.

🗂️ 2. Dar de alta tus productos

El configurador no inventa productos: usa los Productos normales de FacturaScripts. Para cada uno que quieras que aparezca en el configurador, andá a Admin → Productos del configurador y creá una fila indicando:

📌 Producto: el producto real de FacturaScripts (creálo primero en Productos si todavía no existe).
📌 Sección: qué tipo de ítem es — Plan, Módulo, Extra por especialidad, Extra por especialista, Extra administrativo, Almacenamiento base, Almacenamiento extra, o Servicio de pago único.
📌 Si es un Plan: escribí una descripción corta (ej. "Incluye 2 usuarios") que se va a mostrar debajo del nombre del plan en la página pública, y opcionalmente qué módulos incluye gratis.
📌 Si es un Módulo: opcionalmente, restringilo a un plan concreto (por ejemplo, un módulo que solo se pueda comprar en el plan más caro).

Repetí esto por cada plan, módulo y extra que quieras ofrecer.

💳 3. Configurar Stripe

Andá a Admin → Stripe y cargá:

🔑 Clave publicable (pk_test_... o pk_live_...).
🔒 Clave secreta (sk_test_... o sk_live_...) — se guarda cifrada.

Guardá, y después apretá "Sincronizar precios con Stripe". Esto crea automáticamente, en tu cuenta de Stripe, un Precio por cada producto que diste de alta en el paso anterior — no tenés que crear nada manualmente en el dashboard de Stripe.

🔔 4. Configurar el webhook de Stripe

Para que FacturaScripts se entere cuando alguien paga, Stripe necesita avisarle. En el Dashboard de Stripe:

Andá a Webhooks (dentro de "Developers" o "Workbench", según la versión del panel).
Agregá un endpoint con esta URL: https://tu-dominio.com/RUTA-DE-TU-FACTURASCRIPTS/WebhookStripe
Seleccioná estos eventos: checkout.session.completed e invoice.payment_succeeded.
Copiá el "Signing secret" (whsec_...) que te muestra Stripe.
Pegalo en el campo "Firma del webhook" de Admin → Stripe, y guardá.

⚠️ Si estás probando en local (localhost), Stripe no puede alcanzar esa URL desde internet. Usá la Stripe CLI (stripe listen --forward-to http://localhost/.../WebhookStripe) mientras hacés pruebas.

🎨 5. Personalizar la apariencia

Andá al Panel de control de FacturaScripts (Admin → Panel de control) y buscá la pestaña "Configurador de suscripción". Ahí podés cambiar:

✏️ El nombre de tu marca y el título/subtítulo de la página pública.
🎨 Los tres colores principales de la página, para que combinen con tu identidad.

💡 El logo que se muestra es el mismo que ya tenés cargado en Ajustes → Empresa — no hace falta subirlo dos veces.

🚀 6. Publicar tu página de venta

Tu página pública ya está lista en: https://tu-dominio.com/RUTA-DE-TU-FACTURASCRIPTS/PublicSubscriptionConfigurator

Podés enlazarla desde tu web, tus redes o tus campañas — no requiere que el visitante inicie sesión ni se registre.

✅ 7. Qué pasa cuando alguien compra

🛒 El visitante arma su plan, ve el precio actualizado al instante, y hace clic en "Suscribirme y pagar".
💳 Se lo redirige a una página de pago de Stripe, donde también completa su NIF/CIF y dirección de facturación.
🧾 Al pagar, Stripe le avisa a FacturaScripts, que automáticamente crea (o reutiliza) el Cliente con esos datos fiscales, genera una Factura real con cada ítem elegido y su IVA correspondiente, y la marca como cobrada.
🔁 Cada renovación mensual o anual repite el paso 3 sola, sin que tengas que hacer nada.

📊 8. Hacer seguimiento

En Admin → Suscripciones podés ver de un vistazo qué suscripciones están activas, quién las contrató y qué eligió cada cliente — sin tener que cruzar tus facturas con el dashboard de Stripe.