Documentación Oficial: BuenPago

BuenPago es el motor de procesamiento de transacciones financieras de Buenclick Suite. Funciona como una pasarela de pago avanzada para WooCommerce, unificando múltiples proveedores bajo una misma infraestructura, gestionando la tokenización de tarjetas de forma segura y automatizando la recepción de webhooks.

0. Instalación y Activación

El proceso de instalación inicia en buenclick.com, donde se puede elegir y suscribir a los planes disponibles. En la plataforma se carga un formulario seguro generado por Freemius para procesar el alta. Al completarlo, el sistema avisa que se ha enviado un email con el link de descarga y la clave de licencia necesaria para activar el plugin dentro del panel de WordPress.

1. Proveedores de Pago Integrados

La arquitectura del plugin rutea las transacciones a diferentes proveedores según la configuración del administrador. Los proveedores soportados son:

  • Recurrente.com: Integración principal con soporte para cualquier moneda. Incluye la funcionalidad crítica de Tokenización (guardado seguro de tarjetas para cobros futuros).
  • QPayPro: Conexión directa para el procesamiento de tarjetas en Centroamérica, soportando transacciones nativas en GTQ y USD.
  • PayPal: Integración estándar internacional. Soporta múltiples divisas y realiza capturas proactivas en caso de que los webhooks presenten demoras.

Nota: Si tu tienda opera con una moneda local que no es compatible directamente con QPayPro o PayPal, BuenPago incluye un conversor automático. Solo debes definir tu tasa de cambio en los ajustes y el sistema convertirá el total a Dólares (USD) al momento del pago.

2. Tokenización y Gestión de Pagos

El componente interno de gestión se encarga del ciclo de vida de los métodos de pago sin almacenar datos sensibles:

  • BuenPago delega la captura segura al proveedor.
  • Una vez validado, el proveedor devuelve un Token único irreconocible.
  • BuenPago almacena este token asociado al perfil del usuario de WordPress.
  • Se dispara una acción interna (buenpago_payment_token_captured) que permite a otras herramientas reaccionar a la nueva tarjeta guardada.

3. Webhooks y Entornos de Prueba

Para garantizar que los estados de los pedidos en WooCommerce coincidan exactamente con la realidad financiera, BuenPago levanta endpoints individuales que reciben confirmaciones asíncronas de los bancos.

  • Modo Sandbox: Todos los proveedores cuentan con un interruptor para operar en entornos de prueba, permitiendo simular transacciones completas antes de salir a producción.
  • Verificación Criptográfica (Svix): En el caso de Recurrente, BuenPago verifica la firma de cada petición entrante utilizando el protocolo Svix y cifrado HMAC-SHA256, rechazando intentos con una antigüedad mayor a 5 minutos para evitar fraudes.

4. Integraciones del Ecosistema

Fiel a la filosofía unificada, BuenPago se comunica fluidamente con el resto de las herramientas:

  • Integración con BuenSubs y WC Subscriptions: Permite la automatización de cobros recurrentes recuperando el token guardado del usuario para realizar el cargo de la renovación de forma automática.
  • Integración con BuenReg: Vincula la validación de pagos con la creación de credenciales, asegurando que los miembros pasen a estado «Activo» solo cuando se ha confirmado la liquidación de la inscripción.

5. Configuración Rápida

  1. Accede al panel de Buenclick Hub > BuenPago (o al menú independiente de BuenPago en tu barra lateral).
  2. Selecciona un único proveedor principal (Recurrente, QPayPro o PayPal) con el que deseas operar e introduce las claves API y la Tasa de Cambio si es necesario.
  3. Copia la URL de Webhook generada en la pantalla y pégala en el panel de control de tu proveedor para habilitar las confirmaciones automáticas.
  4. Dirígete a WooCommerce > Ajustes > Pagos y activa la pasarela general llamada «Buenpago – Pago con Tarjeta».
  5. (Opcional) Dentro de los ajustes de la pasarela en WooCommerce, puedes restringir métodos de envío incompatibles para ocultar el pago con tarjeta si es necesario.