--- title: "VirtueMart" slug: "virtuemart" updated: 2025-08-13T21:41:56Z published: 2025-08-13T21:41:56Z canonical: "docs.epayco.com/virtuemart" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.epayco.com/llms.txt > Use this file to discover all available pages before exploring further. # VirtueMart ## ![image-1749050297161.png](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/image-1749050297161.png) La integración de ePayco con VirtueMart permite a los comercios aceptar pagos en línea de forma segura y eficiente. Esta conexión se realiza desde el panel administrativo de Joomla mediante un plugin oficial para VirtueMart. **Requisitos previos** Para habilitar ePayco como medio de pago, necesitas: - Tener una tienda activa en Joomla con VirtueMart. - Tener una cuenta verificada en ePayco. - Acceso al panel administrativo de Joomla. ## **Modos de integración disponibles** --- ### **🧩** OnPage Checkout - El cliente realiza el pago directamente desde la tienda, sin redirección. - Reduce pasos en el proceso de compra. - Cumple con el estándar de seguridad PCI DSS. - Experiencia fluida e integrada. ### **🌐 Standard Checkout** - Redirige al cliente al formulario estándar de ePayco. - Compatible con más de 22 medios de pago: tarjetas, PSE, efectivo, billeteras, etc. - Soporta los modelos Agregador y Gateway. - Ideal para quienes prefieren mantener la experiencia de pago en un entorno certificado. Ambos métodos actualizan automáticamente el estado del pedido en tiempo real. ## **¿Cómo integrar ePayco en VirtueMart?** --- Sigue estos pasos para activar ePayco en tu tienda: 1. ****Descargar el plugin**** - Descarga el plugin desde el repositorio oficial de GitHub: **![paso 1 (1) (1).png](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/paso1.png)** **3. Preparar el archivo para Joomla** - Descomprime el archivo ZIP descargado. - Accede a la carpeta `Plugin_ePayco_VirtueMart` - Dentro, comprime la carpeta llamada `payco` nuevamente como `payco.zip` **![](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/paso3.png)** **4. Ir a la sección para instalar el plugin** - Ve al panel de administración de Joomla. - Haz clic en **Sistema** y en administrar accedemos a **Extensiones**. **![](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/paso5.png)** **5. Instalar el plugin en Joomla** - Haz clic en el botón **Instalar extensiones.** - Allí, subes el archivo **payco.zip** descargado anteriormente. **![](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/paso6%20(1).png)** **6. Activa el plugin** - Una vez subido el archivo, te mostrará un mensaje de confirmación junto con los metodos de pago. - Haz clic en el botón administrar extensiones. **![](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/paso9%20(1).png)** - Luego, haz clic en la **X** para activar a **ePayco** como medio de pago. **![](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/paso10.png)** ****4. Configurar el método de pago en VirtueMart**** - Ve al menú **Componentes > VirtueMart** - Luego, en el menú izquierdo, haz clic en Métodos de pago ![paso 3 (1) (1).png](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/paso12.png) - Haz clic en el botón **nuevo** en la parte superior de tu pantalla. ![paso 3 (1) (1).png](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/paso13.png) **5. Se desplegará un formulario donde podrás definir:** - Nombre del metodo de pago - Alias - Descripción - Moneda **6. Dirigete a la sección de configuración e ingresa tus llaves** - P_CUST_ID_CLIENTE - P_KEY - PUBLIC KEY - PRIVATE KEY **![paso 3 (1) (1).png](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/paso15(1).png)** **Aquí también puedes definir:** - **Modo de pruebas:** Activar o desactivar si necesitas hacer pruebas - **Modo de integración**: - Marcado en “Sí” para OnPage. - Marcado en “No” para Standard. - **Idioma** - **Monto mínimo e importe máximo** **Guarda los cambios.** **![](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/image-1746654968948.png)****¿Dónde puedo conseguir las llaves de mi comercio?** Ingresa a tu Dashboard de ePayco en la sección de "Configuración" da clic en "Personalizaciones" , en la categoría de "Llaves Secretas". Allí encontrarás las llaves que corresponden a tu negocio. ## **Prueba la integración** --- Realiza una compra en tu tienda para verificar el funcionamiento del plugin: 1. Añade productos al carrito. 2. Avanza al proceso de pago. 3. Selecciona ePayco como medio de pago. **![](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/compra.png)** El formulario de pago se mostrará según el tipo de integración que configuraste: - OnPage: checkout embebido directamente en la tienda. - Standard: redirección al formulario seguro de ePayco. **![](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/checkout.png)** ## Compatibilidad y versiones soportadas --- Para garantizar el correcto funcionamiento del **plugin ePayco para VirtueMart**, es importante validar que tu entorno cumpla con las siguientes versiones soportadas: - **Joomla:** 3.x / 4.x - **VirtueMart:** 3.x / 4.x - **PHP:** según compatibilidad de Joomla/VirtueMart (mínimo **7.0 o superior**) ## **Beneficios y aspectos clave** --- **![image-1751474272780.png](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/Beneficios%20y%20Aspectos%20Clave(1).png)** ## **Consideraciones importantes** --- ![image-1751474339268.png](https://cdn.document360.io/88b1b912-ebe6-4677-9cf4-27af4e66c459/Images/Documentation/image-1751474339268.png) ## Soporte --- ¿Necesitas ayuda? Puedes comunicarte con el equipo de soporte de ePayco: 📩 [soporte@epayco.co](mailto:soporte@epayco.co) 📚 Documentación técnica: [docs.epayco.co](https://docs.epayco.co)