WHMCS
  • 23 Apr 2025
  • 4 Minutes to read
  • Contributors
  • Dark
    Light

WHMCS

  • Dark
    Light

Article summary


WHMCS es una plataforma de automatización diseñada para empresas que ofrecen servicios en línea, como alojamiento web, registro de dominios, soluciones SaaS y otros productos digitales. Desarrollada en PHP, permite gestionar de forma centralizada clientes, facturación, soporte técnico y procesos recurrentes. Desde su creación, ha sido adoptada por miles de proveedores a nivel global, consolidándose como una solución robusta, flexible y escalable para administrar negocios digitales en crecimiento.

La integración entre ePayco y WHMCS brinda a los proveedores de servicios digitales una solución de pagos completa, permitiéndoles aceptar transacciones a través de una amplia variedad de métodos, incluyendo tarjetas de crédito, débito, PSE, pagos en efectivo y SafetyPay. Esta alianza combina la automatización y flexibilidad de WHMCS con la seguridad, eficiencia y cobertura del ecosistema de pagos de ePayco, optimizando así la experiencia tanto para comerciantes como para usuarios finales

 Requisitos 

  1. Tener una cuenta activa en ePayco.

  2. Tener WHMCS instalado y funcionando correctamente en tu servidor o alojamiento web 

  3. Acceso al servidor donde está instalado WHMCS para agregar archivos y configurar el módulo. 

Características

  1. Recepción de pagos por medio del Checkout y sus dos modos de integración.   

  1. Onpage checkout: 

  1. Experiencia de pago sin redirecciones. 

  1. Reduce pasos necesarios para completar el pago. 

  1. Cumple con los estándares PCI DSS y permite transacciones seguras sin comprometer los datos del cliente.   

  1. Standar checkout: 

  1. Experiencia de pago con redirección. 

  1. Reduce pasos necesarios para completar el pago. 

  1. Cumple con los estándares PCI DSS y permite transacciones seguras sin comprometer los datos del cliente

  1. Mas de 22 medios de pago disponibles. 

  2. Disponible para modelo Agregador y Gateway. 

  1. Actualización de estados transaccionales en los pedidos de la tienda en tiempo real. 

  1. Creación de ordenes en WHMCS con identificador único de transacción. 

  2. Configuración de la cuenta por medio de las llaves de integración del comercio. 

  3. Permite recibir pagos en dólares (USD) y pesos colombianos (COP). 

¡Y mucho más! 

¿Cómo puedo comenzar a recibir pagos por medio del checkout de ePayco en WHMCS? 

Una vez tengas una cuenta registrada y validada en ePayco y tu tienda construida en WHMCS debes realizar los siguientes pasos:   

  1. Clonar el repositorio en su máquina. 

git clone https://github.com/epayco/Plugin_ePayco_WHMCS.git   

2. Ingresar a la carpeta creada y copiar el contenido en su instalación de WHMCS en la ruta raíz de tu tienda ruta/instalación/whmcs/ 

cd payco_whmcs 

cp . -R /ruta/instalación/whmcs/payco_whmcs 

3- Dirigirse a la ruta de instalación de su whmcs ruta/instalacion/whmcs/modules/gateways/ y asegurarse que los archivos descargados se encuentren en la ruta correspondiente 

ruta/de/su/instalación/whmcs/modules/gateways/epayco.php  ruta/de/su/instalación/whmcs/modules/gateways/epayco/epayco.php  ruta/de/su/instalación/whmcs/modules/gateways/callback/epayco.php 

1. Instalación del plugin 

 

Una vez configurado el plugin en los archivos indicados anteriormente, accede a tu dashboard de WHMCS. Dirígete al ícono de llave y selecciona "Aplicaciones e integraciones".   


2. Búsqueda del módulo 

  En la pestaña de búsqueda, escribe "ePayco".


 3. Selección del módulo 

Aparecerá un recuadro con el nombre "ePayco". Haz clic sobre él.

Se abrirá la información del módulo de ePayco. Haz clic en "Instalar". Serás redirigido al formulario de configuración del método de pago.


4. Configuración con llaves secretas 

Allí podrás configurar el módulo con tus llaves públicas y privadas de ePayco. 

¿Dónde conseguir las llaves de mi comercio?

Ingresa a tu dashboard de ePayco, ve a la sección "Configuración", luego a "Personalizaciones", y en la categoría "Llaves Secretas" encontrarás las llaves correspondientes a tu negocio. 

     

5. Ajustes adicionales   

Configura el resto del plugin según tus necesidades (moneda, idioma, etc.) y haz clic en "Guardar". Con esto, el plugin quedará habilitado y listo para usar en tu tienda de WHMCS.   

   

¡Importante! 

Si deseas "Habilitar el modo de pruebas" debes activar también el switch de prueba en tu Dashboard de ePayco. 

    6. Proceso de pago   

Al realizar una compra en tu tienda, en los métodos de pago disponibles aparecerá ePayco. Selecciónalo y haz clic en "Completar pedido".     


  1. Pantalla de pago   

    Se mostrará una landing page con el botón "Pagar con ePayco"

  2. Factura y confirmación 


    Luego verás la factura del producto junto con el botón de "Pagar con ePayco" nuevamente. Haz clic en él.

  3. Redirección al checkout 

     

    Serás redirigido al Checkout Estándar de ePayco, donde podrás seleccionar tu método de pago, completar los formularios y recibir la respuesta de tu transacción.

Importante

Como administrador del comercio de WHMCS podrá comprobar todas las transacciones desde su Dashboard de ePayco. 

ASPECTOS A TENER EN CUENTA

    • La experiencia de pago con WHMCS puede convivir con la funcionalidad de 3D Secure para la protección de tus transacciones. Para más información sobre este protocolo de seguridad, puedes consultar la documentación oficial de ePayco.   

    • No te preocupes por el estado de la transacción de pago: ePayco se encarga de actualizar automáticamente el estado de la transacción en WHMCS, de acuerdo con la respuesta de la pasarela.   

    • ePayco, como procesador de pagos, ofrece una forma sencilla y segura para que nuestros clientes puedan recibir dinero, utilizando múltiples métodos de pago y soluciones de recaudo.    La integración con WHMCS está enfocada únicamente en brindar esta funcionalidad de pagos. La creación, configuración y gestión de productos, planes, impuestos, dominios o servicios dentro de WHMCS es responsabilidad exclusiva del comercio.   

    • Ten en cuenta que WHMCS envía a ePayco el valor total del pedido. Si el pedido incluye impuestos, cargos adicionales o descuentos, estos deben estar bien configurados dentro de WHMCS para que se reflejen correctamente en la transacción procesada por ePayco. 






Was this article helpful?

What's Next