Configurar módulos de pago en PrestaShop con Syspanel | Guía

Introducción: Por qué es clave configurar bien los módulos de pago en PrestaShop

Si tienes una tienda online con PrestaShop, ya sabes que uno de los pasos más importantes para empezar a vender es configurar los módulos de pago. Sin una pasarela de pago funcional, tus clientes no podrán completar sus compras, y eso significa perder ventas. En este artículo te voy a guiar paso a paso para que puedas instalar y configurar los módulos pago PrestaShop usando Syspanel, el panel de control que te permite gestionar tu servidor y tu tienda de forma sencilla.

Vamos a centrarnos en el proceso completo, desde la instalación del módulo hasta la configuración de la pasarela pago, asegurándonos de que todo funcione correctamente. Además, incluiremos trucos y consejos para que no te pierdas en el camino.

[TIP] Si eres nuevo en PrestaShop, no te preocupes. Este artículo está escrito pensando en usuarios sin experiencia técnica. Solo necesitas tener acceso a tu panel de administración de PrestaShop y a Syspanel.

¿Qué es Syspanel y por qué usarlo para configurar módulos de pago?

Syspanel es el nombre que le damos a HestiaCP, un panel de control de hosting muy potente pero fácil de usar. Con Syspanel puedes gestionar tus dominios, bases de datos, cuentas de correo y, por supuesto, acceder a los archivos de tu tienda PrestaShop. El acceso a Syspanel se realiza a través del puerto 2106 (por ejemplo: https://tudominio.com:2106).

La ventaja de usar Syspanel para configurar módulos de pago es que te permite:

Subir e instalar módulos manualmente si no aparecen en el marketplace.
Gestionar permisos de archivos y carpetas.
Ver los logs del servidor si algo falla.
Tener control total sobre tu tienda sin depender de terceros.

Requisitos previos antes de empezar

Antes de lanzarte a configurar los módulos pago PrestaShop, asegúrate de tener lo siguiente:

Acceso a Syspanel (usuario y contraseña, más el puerto 2106).
Acceso al panel de administración de PrestaShop (tu tienda online).
Un módulo de pago compatible con tu versión de PrestaShop (por ejemplo, PayPal, Stripe, Redsys, etc.).
Credenciales de la pasarela de pago (API Key, Secret Key, etc.) que te proporcionará tu banco o proveedor de pagos.
Conexión a Internet estable para descargar e instalar los módulos.

[WARNING] No todos los módulos de pago son gratuitos. Algunos requieren una suscripción mensual o un pago único. Verifica los costos antes de instalarlos.

Paso 1: Acceder a Syspanel y preparar el entorno

Lo primero es iniciar sesión en Syspanel. Para ello:

Abre tu navegador y escribe: https://tudominio.com:2106
Introduce tu usuario y contraseña (los mismos que usas para gestionar tu hosting).
Una vez dentro, verás el panel principal con todas las opciones.

Desde aquí, puedes acceder al gestor de archivos (File Manager) para subir módulos manualmente, o ir directamente a la sección de Bases de datos si necesitas crear una nueva para el módulo.

[INFO] Si tu módulo de pago requiere una base de datos adicional (por ejemplo, para guardar transacciones), créala desde Syspanel antes de continuar. Normalmente, los módulos de PrestaShop usan la base de datos de la tienda, pero algunos plugins externos pueden necesitar una separada.

Paso 2: Instalar el módulo de pago en PrestaShop

Ahora vamos a instalar el módulo de pago. Hay dos formas de hacerlo:

Opción A: Desde el marketplace de PrestaShop (recomendado para principiantes)

En el panel de administración de PrestaShop, ve a Módulos > Catálogo de módulos.
Busca el módulo que necesitas (por ejemplo, "PayPal" o "Stripe").
Haz clic en Instalar y sigue las instrucciones.
Una vez instalado, aparecerá en la lista de módulos instalados.

Opción B: Subir el módulo manualmente desde Syspanel (para módulos personalizados o de pago)

Descarga el archivo ZIP del módulo desde la web del proveedor.
Accede a Syspanel y ve a Archivos > File Manager.
Navega hasta la carpeta de tu tienda: /public_html/modules/ (o la ruta donde tengas instalado PrestaShop).
Sube el archivo ZIP directamente (algunos paneles permiten arrastrar y soltar).
Descomprime el ZIP desde el File Manager (botón derecho > Extract).
Vuelve al panel de administración de PrestaShop y ve a Módulos > Gestor de módulos.
Busca el módulo recién subido y haz clic en Instalar.

[TIP] Si el módulo no aparece después de subirlo, verifica que la carpeta del módulo tenga los permisos correctos (755 para carpetas, 644 para archivos). Puedes cambiarlos desde Syspanel en las propiedades del archivo.

Paso 3: Configurar la pasarela de pago

Una vez instalado el módulo, toca configurarlo para que se conecte con tu pasarela pago. Cada módulo es diferente, pero los pasos generales son:

En el panel de PrestaShop, ve a Módulos > Gestor de módulos.
Busca el módulo de pago instalado y haz clic en Configurar.
Se abrirá una página con campos como:
- Modo de prueba / Producción: Elige "Producción" cuando estés listo para vender. Durante las pruebas, usa "Sandbox" o "Pruebas".
- API Key / Client ID: Cópialo de tu cuenta en el proveedor de pagos (por ejemplo, en PayPal Developers o Stripe Dashboard).
- Secret Key / Client Secret: También lo obtienes del proveedor.
- Moneda predeterminada: Selecciona la moneda de tu tienda (EUR, USD, etc.).
Guarda los cambios.

[WARNING] Nunca compartas tus claves API o Secret Key. Guárdalas en un lugar seguro. Si crees que se han filtrado, genera nuevas desde el panel del proveedor.

Ejemplo práctico: Configurar PayPal

Ve a PayPal Developers y crea una aplicación.
Copia el Client ID y Secret.
En PrestaShop, pega esos valores en los campos correspondientes.
Activa el modo "Producción" cuando hayas probado con éxito en modo Sandbox.

Paso 4: Probar la pasarela de pago

Antes de abrir tu tienda al público, es fundamental hacer una prueba real. Para ello:

En la configuración del módulo, cambia a Modo de pruebas (Sandbox).
Realiza una compra de prueba desde tu tienda (usa una tarjeta de prueba que te proporciona el proveedor, por ejemplo, para Stripe: 4242 4242 4242 4242).
Verifica que el pago se procesa correctamente y que el pedido aparece en el panel de administración.
Si todo funciona, cambia a Modo producción y repite la prueba con una tarjeta real (puedes usar una de débito con saldo mínimo).

[INFO] Algunos módulos tienen una opción para "probar conexión". Úsala para asegurarte de que las claves API son correctas.

Paso 5: Solucionar problemas comunes (FAQ)

Aquí tienes las preguntas más frecuentes que resuelven dudas sobre módulos pago PrestaShop y Syspanel configuración:

¿Por qué no aparece el módulo después de instalarlo?

Causa: Puede que la carpeta del módulo no tenga permisos correctos o que el archivo ZIP no se haya descomprimido bien.
Solución: Desde Syspanel, ve a File Manager, revisa los permisos (755 para carpetas, 644 para archivos) y asegúrate de que la carpeta del módulo esté dentro de /modules/.

¿El pago no se procesa y da error "Conexión fallida"?

Causa: Las claves API son incorrectas o el servidor no tiene habilitada la extensión cURL.
Solución: Verifica las claves en el proveedor. Desde Syspanel, puedes revisar los logs del servidor (en la sección "Logs") para ver el error exacto.

¿Cómo activo el modo de pruebas en mi módulo?

En la configuración del módulo, busca "Modo de prueba" o "Sandbox". Actívalo y usa tarjetas de prueba del proveedor.

¿Puedo usar varios módulos de pago a la vez?

Sí, PrestaShop permite tener múltiples pasarelas activas. Solo asegúrate de que no entren en conflicto (por ejemplo, dos módulos que usen el mismo método de pago).

¿Syspanel me ayuda si el módulo no funciona?

Sí, desde Syspanel puedes:
- Revisar los logs del servidor.
- Cambiar permisos de archivos.
- Forzar la recarga de la configuración de PHP.
- Contactar con soporte técnico si el problema es del servidor.

Consejos adicionales para optimizar la configuración

Actualiza siempre los módulos: Los desarrolladores lanzan parches de seguridad. Desde PrestaShop, revisa las actualizaciones periódicamente.
Usa SSL: Asegúrate de que tu tienda tenga certificado SSL activo (HTTPS). Syspanel suele incluirlo gratis con Let's Encrypt.
Prueba con diferentes navegadores: A veces, problemas de caché o cookies afectan el proceso de pago.
Backup antes de cambios: Siempre haz una copia de seguridad de tu tienda desde Syspanel antes de instalar o actualizar módulos.

[TIP] Si tu módulo de pago tiene opciones de "personalización" (como colores o textos), ajústalos para que coincidan con el diseño de tu tienda. Esto mejora la experiencia del usuario.

Conclusión

Configurar los módulos pago PrestaShop con Syspanel no tiene por qué ser complicado. Siguiendo estos pasos, podrás tener tu pasarela pago funcionando en pocos minutos. Recuerda que Syspanel te da el control total sobre los archivos y la configuración del servidor, lo que facilita la resolución de problemas.

Si te encuentras con algún error, no dudes en revisar los logs desde Syspanel o consultar la documentación oficial de tu módulo. Y, por supuesto, siempre puedes contactar con nuestro equipo de soporte técnico para ayudarte.

¡Ahora ya estás listo para vender con total seguridad!