Documentación Oficial: BuenSubs

BuenSubs es la solución nativa de Buenclick Suite para la gestión de cobros recurrentes y membresías en WooCommerce. Es un motor completamente independiente y ligero, diseñado para reemplazar complementos pesados (como WooCommerce Subscriptions), centrándose en la estabilidad de las renovaciones automáticas y la facilidad de uso.

1. Tipos de Productos y Configuración

El plugin extiende el catálogo nativo de WooCommerce mediante el registro de nuevos tipos de productos (gestionados por class-buensubs-product-type.php). Esto permite crear y vender planes de facturación recurrente de forma natural:

  • Suscripción Simple (class-wc-product-simple-subscription.php): Un plan de pago estándar con un único precio y ciclo de facturación.
  • Suscripción Variable (class-wc-product-variable-subscription.php): Permite ofrecer múltiples niveles de precios o frecuencias bajo un mismo producto (ej. Plan Básico Mensual vs. Plan Pro Anual).

Mediante el módulo BuenSubs_Admin_Product_Fields, el administrador de la tienda puede configurar en la pestaña «Datos del producto»:

  • Precio de suscripción: Costo por ciclo.
  • Intervalo de facturación: Frecuencia de cobro (mensual, anual, semanal, etc.).
  • Periodo de prueba gratuita (Free Trial): Días de acceso gratuito antes del primer cargo real.

2. Ciclo de Vida y Gestión del Checkout

El módulo BuenSubs_Checkout intercepta el proceso normal de pago para adecuarlo a las reglas de suscripción:

  • Creación de cuenta forzada: Si hay una suscripción en el carrito, se requiere o crea automáticamente una cuenta de usuario, vital para enlazar los cobros futuros.
  • Cálculo de totales recurrentes: Diferencia el pago «hoy» (que podría ser 0.00 si hay prueba gratuita) del monto recurrente futuro.

Una vez procesado el pago, la clase BuenSubs_Subscription toma el control y asiste los Estados de la Suscripción:

  • trial: Usuario en periodo de prueba gratuita.
  • active: Cobro al día, usuario con acceso total.
  • on-hold: En espera (normalmente por fallo temporal en la tarjeta).
  • cancelled: Cancelada por el usuario o administrador.
  • expired: Suscripción que llegó a su fin y no renovó.

3. Portal del Cliente (Mi Cuenta)

Mediante el controlador BuenSubs_MyAccount, el cliente recibe un panel de autoservicio incrustado en la página nativa «Mi Cuenta» de WooCommerce.

  • Vista de Suscripciones: Muestra un listado claro de todos sus planes contratados, el estado actual, el monto recurrente y la próxima fecha de cobro.
  • Gestión de Cancelaciones: Botón directo para que el usuario pueda pausar o cancelar su membresía de forma autónoma sin saturar el soporte del comercio.

4. Motor de Notificaciones por Correo (Emails)

BuenSubs incluye un sistema transaccional de notificaciones (class-buensubs-emails.php) que hereda la estética nativa de tu tienda. Los correos automatizados incluyen:

  • Email_New_Subscription: Bienvenida y resumen del plan recién adquirido.
  • Email_Renewal_Complete: Envío de la factura/recibo tras un cobro mensual automático exitoso.
  • Email_Renewal_Failed: Aviso crítico si la tarjeta del usuario es rechazada (por falta de fondos o vencimiento), con un enlace para actualizar el método de pago.
  • Email_Payment_Reminder: Alerta previa sobre un cargo próximo.
  • Email_Subscription_Cancelled: Confirmación legal de que no se realizarán más cobros.

5. El Motor de Cobros (Integración con BuenPago)

La magia de la automatización ocurre en sincronía con BuenPago. BuenSubs tiene un motor Cron interno que verifica diariamente qué suscripciones tocan cobro hoy.

  • Cuando es el día de cobro de un cliente, BuenSubs crea un nuevo pedido de renovación (Renewal Order) en WooCommerce.
  • Hace una llamada a la pasarela (BuenPago) para que extraiga el Token de la Tarjeta de Crédito previamente guardado.
  • Ejecuta el cargo «Off-Session» directo al banco y, si es aprobado, extiende la suscripción un ciclo más.

6. Configuración Rápida

  1. Accede a Productos > Añadir Nuevo en tu panel de WordPress.
  2. En la caja «Datos del producto», despliega el menú y selecciona Suscripción Simple o Suscripción Variable.
  3. Establece el precio y define el intervalo (Ej. «Cada 1 Mes»).
  4. Verifica que tu pasarela de pago en BuenPago tenga habilitada la función de «Tokenización de Tarjetas», un requisito indispensable para poder realizar los cargos automáticos de las renovaciones en el futuro.
  5. Guarda y publica. Tu tienda ya está lista para generar ingresos recurrentes.