Instalar y configurar módulos de pago en PrestaShop desde cPanel

Configurar los módulos de pago en tu tienda PrestaShop es uno de los pasos más importantes para empezar a vender online. Sin una pasarela de pago funcional, tus clientes no podrán completar sus compras, y eso se traduce en pérdida de ventas. En esta guía, te explicaré paso a paso cómo instalar y configurar los principales módulos de pago, como PayPal, usando tu panel de control cPanel. No necesitas ser un experto técnico; solo sigue las instrucciones al pie de la letra.

¿Qué son los módulos de pago en PrestaShop?

Los módulos de pago son extensiones que conectan tu tienda con servicios financieros como PayPal, Stripe, transferencias bancarias o contra reembolso. Cada módulo tiene su propia configuración y requisitos técnicos. En PrestaShop, la mayoría de estos módulos se gestionan desde el propio backoffice, pero algunos requieren ajustes adicionales en el servidor, como la instalación de librerías o la configuración de SSL. Aquí es donde entra cPanel, tu aliado para gestionar el hosting.

Requisitos previos antes de empezar

Antes de lanzarte a instalar módulos, asegúrate de tener lo siguiente:

Acceso a cPanel: Debes tener credenciales de administrador de tu hosting. Si usas un panel alternativo como Syspanel (accesible por el puerto 2106), el proceso es similar, pero centrémonos en cPanel para esta guía.
SSL activo: Para procesar pagos seguros, necesitas un certificado SSL en tu dominio. En cPanel, puedes instalarlo fácilmente desde la sección "SSL/TLS".
Versión de PrestaShop compatible: Verifica que tu versión de PrestaShop sea compatible con los módulos que vas a instalar. Por ejemplo, PayPal requiere PrestaShop 1.7 o superior.
Credenciales de la pasarela de pago: Para PayPal, necesitas un ID de cliente y una clave secreta. Para Stripe, una clave publicable y una clave secreta.

Paso 1: Acceder a cPanel y preparar el entorno

Primero, inicia sesión en cPanel. Normalmente, la URL es algo como https://tudominio.com/cpanel o https://tudominio:2083. Introduce tu usuario y contraseña.

[TIP] Si tu proveedor usa Syspanel, la URL será https://tudominio:2106. El proceso es idéntico; solo cambia el puerto.

Una vez dentro, busca la sección "Archivos" y haz clic en "Administrador de archivos". Aquí podrás navegar por los directorios de tu sitio. Ve a la carpeta public_html (o la carpeta donde esté instalado PrestaShop). Normalmente, los módulos de pago se instalan desde el backoffice, pero a veces necesitas subir archivos manualmente si el módulo no aparece en el marketplace.

Paso 2: Instalar un módulo de pago desde el backoffice de PrestaShop

La forma más sencilla de instalar un módulo de pago es desde el panel de administración de PrestaShop. Sigue estos pasos:

Accede a tu backoffice de PrestaShop (normalmente tudominio.com/admin).
Ve a "Módulos" > "Catálogo de módulos".
Busca el módulo que deseas instalar, por ejemplo, "PayPal". Encontrarás varios, pero el oficial es "PayPal Official Module for PrestaShop".
Haz clic en "Instalar". El módulo se descargará e instalará automáticamente.

[INFO] Si el módulo no aparece, puede que tu tienda no tenga conexión al marketplace. En ese caso, descarga el módulo desde la web oficial de PrestaShop y súbelo manualmente desde la sección "Módulos" > "Subir un módulo".

Paso 3: Configurar PayPal en PrestaShop (instalación y ajustes básicos)

Una vez instalado, es hora de configurarlo. Aquí te detallo el proceso para PrestaShop PayPal instalación:

En el backoffice, ve a "Módulos" > "Gestor de módulos" y busca "PayPal".
Haz clic en "Configurar".
Se abrirá una interfaz con varias pestañas. La principal es "Configuración de la cuenta".
Selecciona tu país y moneda. Luego, elige el tipo de cuenta: "PayPal Business" (necesitas una cuenta empresarial).
Haz clic en "Conectar con PayPal". Te redirigirá a PayPal para que autorices la conexión. Inicia sesión y acepta los permisos.
Una vez vuelvas a PrestaShop, verás que la cuenta está vinculada. Activa las opciones de pago que desees: Pago estándar, Pago rápido (Express Checkout) o Tarjeta de crédito (PayPal Pro).

[WARNING] Si no ves la opción de conectar, asegúrate de que tu servidor tenga habilitada la extensión cURL en PHP. Esto se configura en cPanel desde la sección "Seleccionar versión de PHP" > "Extensiones".

Paso 4: Configurar SSL y requisitos del servidor desde cPanel

Para que los módulos pago PrestaShop funcionen correctamente, el servidor debe cumplir ciertos requisitos. Desde cPanel, puedes verificar y ajustar lo siguiente:

Verificar la versión de PHP

En cPanel, busca "Seleccionar versión de PHP" (o "MultiPHP Manager").
Asegúrate de que uses PHP 7.4 o superior (recomendado PHP 8.0 para PrestaShop 8).
En la misma sección, habilita las extensiones: cURL, OpenSSL, JSON, mbstring y PDO. Son esenciales para la comunicación con pasarelas de pago.

Instalar o renovar SSL

Ve a "SSL/TLS" > "Instalar y gestionar SSL para tu sitio".
Si no tienes SSL, usa "AutoSSL" (o "Let's Encrypt" si tu hosting lo ofrece). Actívalo para tu dominio.
Una vez instalado, en PrestaShop, ve a "Parámetros de la tienda" > "Tráfico y SEO" y activa "SSL en todas las páginas".

[TIP] Si tu hosting usa Syspanel, busca la sección "SSL Certificates" y sigue el mismo proceso. El puerto 2106 te da acceso a funciones similares.

Paso 5: Solucionar problemas comunes con módulos de pago

A veces, aunque instales todo correctamente, pueden surgir errores. Aquí tienes los más frecuentes y cómo resolverlos desde cPanel.

Error: "Módulo no se puede instalar por falta de permisos"

Esto ocurre cuando la carpeta modules no tiene permisos de escritura. Desde cPanel:

Ve a "Administrador de archivos".
Navega a public_html/modules.
Haz clic derecho en la carpeta del módulo (ej. paypal) y selecciona "Permisos".
Cambia los permisos a 755 (o 0755). Aplica también a subcarpetas.

Error: "No se puede conectar con PayPal"

Verifica que cURL esté habilitado en PHP (paso anterior).
Comprueba que tu servidor tenga acceso a internet. Desde cPanel, usa "Terminal" (si está disponible) y ejecuta curl -I https://api.paypal.com. Si no responde, contacta a tu proveedor de hosting.
Asegúrate de que el puerto 443 esté abierto. En cPanel, ve a "Firewall" o "ConfigServer Security & Firewall" y permite el tráfico saliente a PayPal.

Error: "El módulo no aparece en la lista de pagos"

Ve a "Módulos" > "Gestor de módulos" y busca el módulo. Si está instalado pero no activo, actívalo.
Luego, ve a "Mejoras" > "Rendimiento" y haz clic en "Limpiar caché".
Si sigue sin aparecer, desde cPanel, elimina la carpeta var/cache dentro de la instalación de PrestaShop (excepto el archivo .htaccess).

Paso 6: Probar el módulo de pago antes de lanzar la tienda

Antes de abrir tu tienda al público, haz una prueba de compra real. Usa el modo "Sandbox" de PayPal (entorno de pruebas) para simular transacciones sin dinero real.

En la configuración de PayPal en PrestaShop, activa "Modo sandbox".
Crea una cuenta de prueba en developer.paypal.com y obtén credenciales de prueba.
Realiza una compra en tu tienda con una tarjeta de crédito ficticia (PayPal proporciona números de prueba).
Verifica que el pedido aparezca en el backoffice y que el estado cambie a "Pago aceptado".

[INFO] Si todo funciona, desactiva el modo sandbox y activa el modo producción con tus credenciales reales.

Preguntas frecuentes (FAQ) sobre módulos de pago en PrestaShop

Aquí respondo las dudas más comunes que recibo como técnico de soporte.

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

Sí, PrestaShop permite activar múltiples pasarelas. Por ejemplo, puedes tener PayPal, transferencia bancaria y contra reembolso. Solo asegúrate de que no entren en conflicto. En "Módulos" > "Pago", puedes ordenar la prioridad de cada uno.

¿Qué hago si el módulo de pago no se actualiza?

Desde el backoffice, ve a "Módulos" > "Catálogo de módulos" y busca actualizaciones. Si no aparecen, descarga la última versión desde el sitio oficial y súbela manualmente. En cPanel, elimina la carpeta del módulo antiguo en public_html/modules antes de subir la nueva.

¿Es necesario tener SSL para todos los módulos de pago?

Sí, absolutamente. Cualquier pasarela de pago que maneje datos sensibles (como tarjetas de crédito) exige SSL. Además, Google penaliza las tiendas sin SSL en los resultados de búsqueda.

¿Puedo configurar pagos desde Syspanel en lugar de cPanel?

Sí, el proceso es similar. Syspanel (con puerto 2106) ofrece las mismas funciones: administrador de archivos, gestión de PHP y SSL. Solo cambia la interfaz. Si tu hosting usa Syspanel, busca las secciones equivalentes.

Mi módulo de pago da error "500 Internal Server Error"

Esto suele deberse a un conflicto de PHP o permisos. Desde cPanel:

Revisa los logs de errores en "Errores" > "Registro de errores".
Aumenta el límite de memoria de PHP en "Seleccionar versión de PHP" > "Opciones" y cambia memory_limit a 256M.
Si el error persiste, desactiva el módulo y actívalo de nuevo.

Consejos finales para optimizar tus módulos de pago

Mantén todo actualizado: Tanto PrestaShop como los módulos de pago reciben parches de seguridad. Revisa las actualizaciones cada mes.
Usa un CDN: Si tu tienda tiene tráfico global, un CDN (como Cloudflare) puede acelerar la carga de las páginas de pago. Configúralo desde cPanel en la sección "Cloudflare".
Monitorea los logs: Desde cPanel, revisa "Registro de errores" periódicamente para detectar fallos en los módulos de pago. Esto te ayudará a solucionar problemas antes de que afecten a los clientes.

Configurar los módulos pago PrestaShop no tiene por qué ser un dolor de cabeza. Con cPanel, tienes todas las herramientas a tu alcance para instalar, configurar y solucionar problemas. Recuerda que la clave está en la preparación del servidor: PHP correcto, SSL activo y permisos adecuados. Si sigues esta guía, tu tienda estará lista para aceptar pagos en pocos minutos.

[WARNING] No olvides hacer una copia de seguridad de tu base de datos y archivos antes de instalar cualquier módulo. En cPanel, usa "Copias de seguridad" para descargar un respaldo completo.

Ahora, ¡a vender! Si tienes alguna duda, no dudes en contactar a tu soporte técnico. Estamos aquí para ayudarte.