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, centrándose en la estabilidad de las renovaciones automáticas y la facilidad de uso.

0. Instalación y Activación

El proceso de instalación inicia en buenclick.com donde te puedes suscribir a los planes disponibles. Se carga el formulario generado por Freemius que solicita tus datos de facturación. Al completar el formulario, se avisa que se ha enviado un email con el link de descarga y la clave de licencia que deberás utilizar para activar el plugin en tu panel de WordPress.

1. Tipos de Productos y Configuración

El plugin extiende el catálogo nativo de WooCommerce mediante el registro de nuevos tipos de productos. Esto permite crear y vender planes de facturación recurrente de forma natural:

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

Mediante los ajustes del producto, el administrador puede configurar:

  • Precio e Intervalo: Costo y frecuencia de cobro (mensual, anual, semanal, etc.).
  • Periodo de Prueba (Free Trial): Días de acceso gratuito antes del primer cargo real.
  • Envío Incluido en el Precio: Permite marcar que la suscripción ya cubre los gastos de envío. Al activarlo, BuenSubs fuerza automáticamente el envío gratuito en el checkout para el cliente. Esta opción puede restringirse a Zonas de Envío específicas, ideal para «Subscription Boxes» locales.

2. Ciclo de Vida y Gestión del Checkout

El módulo de 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, BuenSubs asiste los Estados de la Suscripción:

  • pending: Suscripción creada pero pendiente de confirmación de pago inicial.
  • 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)

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 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. Notificaciones Transaccionales (Exclusivo Plan Pro)

Para los usuarios con licencia BuenSubs Pro, el plugin activa un sistema transaccional de notificaciones por correo electrónico que hereda la estética nativa de la tienda:

  • Bienvenida: Resumen del plan recién adquirido.
  • Aviso Preventivo: Alerta previa días antes de realizar un cargo próximo.
  • Renovación Exitosa: Envío del recibo tras un cobro automático exitoso.
  • Fallo de Renovación: Aviso crítico si la tarjeta es rechazada, con un enlace para actualizar el método de pago.
  • Cancelación: Confirmación de que no se realizarán más cobros.

5. El Motor de Cobros Automáticos

La automatización de cobros ocurre en sincronía con BuenPago (o alternativamente mediante la pasarela integrada de Glifo). BuenSubs tiene un motor Cron interno que verifica diariamente qué suscripciones tocan cobro.

  • En el día de cobro, BuenSubs crea un pedido de renovación (Renewal Order).
  • Hace una llamada a la pasarela activa para extraer 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. Planes y Límites de Capacidad

El ecosistema BuenSubs se adapta al tamaño de tu negocio:

  • Plan BuenSubs (Estándar/Starter): Ideal para negocios emergentes, permite gestionar un límite de hasta 10 suscripciones activas simultáneas de manera automatizada.
  • Plan BuenSubs Pro: Pensado para la escala masiva. Desbloquea un límite de suscripciones ilimitadas, acceso prioritario y habilita el motor de correos automáticos.