Configurar pasarelas de pago en WHMCS
Third Party Applications
24

Qué es una pasarela de pago

Una pasarela es el puente entre tu tienda y el mundo del dinero. Cuando un cliente pulsa "Pagar", WHMCS se comunica con la pasarela elegida, esta procesa la tarjeta o el método que sea y devuelve una respuesta: aprobado, rechazado o pendiente. Sin pasarela, tu cliente no puede pagarte online y todo vuelve a ser transferencias a mano. Por eso configurar al menos dos pasarelas (para redundancia) es una de las primeras cosas que debes hacer después de instalar.

Opciones más comunes

WHMCS trae integraciones con decenas de pasarelas. Las que suelen usar los resellers que empiezan son estas:

  • PayPal: simple de activar, solo necesitas un correo de empresa verificado. Cobra comisión por transacción pero acepta tarjetas sin que el cliente tenga cuenta PayPal.
  • Stripe: procesador de tarjetas moderno. Permite cobros recurrentes reales, donde WHMCS cobra solo cada mes sin pedir nada al cliente. Requiere registrarte y verificar tu negocio.
  • Tarjeta directa vía procesador local: si vives en un país con procesadores propios (Niubiz, Izipay, Kushki, MercadoPago), busca su módulo oficial en el marketplace de WHMCS.
  • Transferencia bancaria: no es una pasarela automática, sino un método manual. WHMCS genera la factura con instrucciones y luego tú marcas el pago a mano cuando lo confirmas en tu banco. Útil como respaldo para clientes que no tienen tarjeta.

Dónde se activan

Entra al panel admin, abre la configuración general y busca la sección de "Payment Gateways". Ahí verás todas las pasarelas disponibles listadas en una pestaña, y las activas en otra. Para activar una, haz clic en ella, llena los datos que pida (correo, claves API, moneda aceptada) y guarda. Inmediatamente aparecerá como opción al cliente en la pantalla de pago.

Datos técnicos típicos

Casi toda pasarela moderna te pide una API Key pública y una API Key secreta. Esas claves las generas desde el panel de la pasarela (no desde WHMCS). Cópialas con cuidado porque se copian mal con facilidad. Algunas pasarelas también requieren configurar una URL de notificación (webhook) dentro de su panel, apuntando a tu WHMCS. Ese webhook es el que le dice a WHMCS "el pago de la factura X ya fue confirmado" en tiempo real.

Modo prueba versus modo producción

Todas las pasarelas serias ofrecen un modo "sandbox" o "test". En ese modo, las transacciones no mueven dinero real; puedes cobrar una y otra vez con tarjetas de prueba para validar que todo el flujo funciona: el cliente paga, WHMCS marca la factura como pagada y el servicio se aprovisiona.

Activa la pasarela primero en modo prueba. Haz dos o tres pedidos simulados. Verifica que el correo de confirmación llegue, que la factura cambie a "Paid" y que la cuenta de hosting se cree en WHM. Solo entonces desactiva el modo prueba y ponla en producción. Hacerlo al revés —activar producción sin probar— es una forma garantizada de perder tu primer cliente.

Suscripciones automáticas

Si vendes servicios recurrentes, lo ideal es que el cliente no tenga que pagar manualmente cada mes. Las pasarelas modernas como Stripe permiten crear una "suscripción": el cliente paga una sola vez con tarjeta y autoriza a que el cobro se repita automáticamente en cada ciclo. WHMCS gestiona la creación y cancelación de esas suscripciones desde cada factura. Pon esta opción visible en el carrito para reducir drásticamente la morosidad.

Múltiples pasarelas, múltiples monedas

Si facturas en dólares y en moneda local, necesitarás pasarelas distintas para cada moneda. WHMCS permite tener varias activas a la vez y mostrar al cliente solo las compatibles con la moneda de su factura. Configura cada una con cuidado, revisa que los tipos de cambio automáticos estén actualizados y prueba antes de lanzar.