Configurar pago en PrestaShop con cPanel | Guía hosting

Configurar el módulo de pago en tu tienda online con PrestaShop es uno de los pasos más importantes para empezar a vender. 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 extensa y detallada, te explicaré paso a paso cómo configurar el módulo de pago en PrestaShop desde el panel de control cPanel. No necesitas ser un experto en hosting ni en programación; solo sigue las instrucciones al pie de la letra.

[INFO] Este artículo está pensado para usuarios que tienen su tienda alojada en un servidor con cPanel, el panel de control más común en el hosting compartido. Si usas Syspanel (antes conocido como HestiaCP), el proceso es similar, pero accedes por el puerto 2106.

¿Qué necesitas antes de empezar?

Antes de lanzarte a configurar nada, asegúrate de tener a mano lo siguiente:

Acceso a cPanel de tu hosting. Normalmente lo obtienes con las credenciales que te dio tu proveedor de hosting.
Credenciales de la pasarela de pago. Por ejemplo, si usas PayPal, necesitarás tu Client ID y Secret. Si usas Redsys o Stripe, necesitarás las claves de API o el terminal proporcionado por tu banco.
Acceso al panel de administración de PrestaShop. Usuario y contraseña de tu back office.
Una cuenta de prueba en la pasarela de pago. Muchas ofrecen entornos sandbox para hacer pruebas sin cobrar dinero real.

[TIP] Si es tu primera vez, te recomiendo empezar con PayPal o Stripe, ya que son los módulos más sencillos de configurar y tienen una gran compatibilidad con PrestaShop.

Paso 1: Acceder a tu panel de control (cPanel)

El primer paso técnico es entrar a cPanel. Aquí gestionarás los archivos de tu tienda y, en algunos casos, tendrás que instalar certificados SSL o verificar que tu servidor cumple con los requisitos de la pasarela.

Abre tu navegador y escribe la dirección de acceso a cPanel. Normalmente es algo como tudominio.com/cpanel o tudominio.com:2083.
Introduce tu usuario y contraseña de cPanel.
Una vez dentro, busca la sección "Archivos" o "Files". Aquí encontrarás el Administrador de archivos (File Manager).

[WARNING] No modifiques archivos del sistema si no estás seguro de lo que haces. Siempre es mejor hacer una copia de seguridad antes de tocar nada.

Paso 2: Verificar los requisitos del servidor

Cada módulo de pago tiene requisitos técnicos específicos. Por ejemplo, algunos necesitan cURL activado, OpenSSL o una versión concreta de PHP. Vamos a comprobarlo desde cPanel.

### Comprobar la versión de PHP

En cPanel, busca la sección "Software" y haz clic en "Seleccionar versión de PHP".
Asegúrate de que tienes una versión compatible con tu PrestaShop (normalmente PHP 7.4, 8.0 o 8.1). Las versiones muy antiguas o muy nuevas pueden dar problemas.
Marca las extensiones necesarias: curl, openssl, json, mbstring, gd, pdo_mysql.

### Activar cURL y otras extensiones

Si no ves las extensiones marcadas, actívalas desde el mismo selector. En la mayoría de los casos, solo tienes que hacer clic en la casilla y guardar los cambios.

[INFO] Si tu hosting usa Syspanel, accede por el puerto 2106 y busca la opción de "Versión de PHP" en el menú de configuración del sitio web.

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

Ahora pasamos a la parte divertida: instalar el módulo en tu tienda online.

Inicia sesión en el back office de PrestaShop (normalmente tudominio.com/admin).
Ve al menú "Módulos" y luego a "Catálogo de módulos".
Busca el nombre de la pasarela que quieres instalar (por ejemplo, "PayPal", "Stripe", "Redsys").
Haz clic en "Instalar". Si el módulo es de pago, deberás comprarlo primero.
Una vez instalado, verás el módulo en la lista de "Módulos instalados".

[TIP] Si el módulo no aparece en el catálogo, puedes subirlo manualmente desde la opción "Subir un módulo" en la parte superior. Asegúrate de que el archivo esté en formato .zip.

Paso 4: Configurar el módulo de pago desde el back office

Cada módulo tiene su propia interfaz de configuración, pero todos siguen una estructura similar. Te explico con el ejemplo de PayPal, que es el más común.

### Configuración general del módulo

Busca el módulo instalado en la lista y haz clic en "Configurar".
Se abrirá una nueva ventana con varias pestañas. Normalmente verás:
- Configuración de la cuenta: aquí pegarás tus claves de API.
- Configuración de pago: elegirás el modo (producción o pruebas).
- Apariencia: personalizarás los botones y colores.

### Obtener las claves de API desde la pasarela

Para PayPal, por ejemplo:

Ve a developer.paypal.com e inicia sesión.
Crea una aplicación REST en el panel de desarrollador.
Copia el Client ID y el Secret.
Vuelve a PrestaShop y pégalos en los campos correspondientes.

[WARNING] Nunca compartas tu Secret Key. Es como la contraseña de tu cuenta bancaria.

### Configurar el modo de pruebas (Sandbox)

Antes de activar el modo real, siempre es recomendable hacer pruebas con dinero ficticio.

En la configuración del módulo, busca la opción "Modo sandbox" o "Modo de pruebas".
Actívalo.
Si la pasarela lo requiere, crea una cuenta de prueba en su portal de desarrolladores.

Paso 5: Configurar la URL de retorno y notificaciones (IPN)

Muchas pasarelas de pago necesitan que les digas a qué URL deben enviar la confirmación del pago. Esto se llama IPN (Instant Payment Notification) o Webhook.

En la configuración de tu módulo en PrestaShop, busca la sección "URL de notificación" o "Webhook".
Copia la URL que te muestra. Normalmente es algo como: https://tudominio.com/module/paypal/ipn.
Ve al panel de tu pasarela de pago (por ejemplo, PayPal) y pega esa URL en el campo correspondiente de "Notificaciones" o "IPN".

[INFO] Si no configuras bien la IPN, los pedidos pueden quedar en estado "pendiente" aunque el cliente haya pagado.

Paso 6: Configurar el SSL desde cPanel

Para que los pagos sean seguros, tu tienda debe funcionar con HTTPS. El certificado SSL se instala desde cPanel.

En cPanel, busca la sección "Seguridad" y haz clic en "SSL/TLS".
Elige la opción "Instalar y gestionar SSL para tu sitio".
Si tu hosting incluye un certificado gratuito (AutoSSL o Let's Encrypt), selecciona tu dominio y haz clic en "Instalar".
Espera unos minutos y verifica que tu tienda carga con https://.

[TIP] Si ves un candado verde en la barra de direcciones, todo está correcto. Si no, revisa que no haya contenido mixto (archivos cargados sin HTTPS).

Paso 7: Probar el pago en tu tienda

Una vez que todo está configurado, es hora de hacer una prueba real (pero en modo sandbox).

Ve a tu tienda online como si fueras un cliente.
Añade un producto al carrito y ve al proceso de pago.
Selecciona el método de pago que configuraste.
Si estás en modo pruebas, usa una tarjeta de prueba (por ejemplo, 4111111111111111 para Stripe) o inicia sesión con una cuenta sandbox de PayPal.
Completa la compra.
Vuelve al back office de PrestaShop y verifica que el pedido aparezca como "Pago aceptado".

[WARNING] Si el pago falla, revisa los logs del módulo en PrestaShop (suelen estar en la pestaña "Registros" del módulo) y los logs de errores de cPanel en la sección "Errores del servidor".

Solución de problemas comunes (FAQ)

Aquí tienes las preguntas más frecuentes que resolvemos en soporte técnico.

### ¿Por qué no aparece el módulo de pago en el front office?

Revisa que el módulo esté instalado y configurado correctamente.
Asegúrate de que el modo de pruebas esté desactivado si quieres que los clientes reales lo vean.
Comprueba que el grupo de clientes tenga acceso al módulo (en la configuración del módulo, pestaña "Restricciones").

### ¿El pago se queda en "pendiente" todo el rato?

Es probable que la IPN no esté bien configurada. Revisa el paso 5.
También puede ser que el servidor no esté recibiendo las notificaciones. En cPanel, revisa los logs de acceso en la sección "Estadísticas" o "Raw Access Logs".

### ¿Necesito un certificado SSL para pagar?

Sí, es obligatorio. La mayoría de las pasarelas de pago no funcionan sin HTTPS. Además, Google penaliza las tiendas sin SSL.

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

Sí, PrestaShop permite tener activos varios métodos de pago. Solo debes instalarlos y configurarlos por separado. Eso sí, asegúrate de que no entren en conflicto.

### ¿Qué hago si mi hosting usa Syspanel en lugar de cPanel?

No te preocupes. Los pasos son muy similares. Accede a Syspanel por el puerto 2106 (ejemplo: tudominio.com:2106). Busca las opciones de "Archivos" para el File Manager y "Configuración de PHP" en el menú del sitio web.

Consejos finales para una configuración exitosa

Configurar el módulo de pago en PrestaShop desde cPanel puede parecer complicado al principio, pero siguiendo estos pasos de forma ordenada, lo tendrás listo en menos de una hora.

Recuerda siempre:

Hacer una copia de seguridad de tu tienda antes de instalar nuevos módulos.
Probar en sandbox antes de lanzarte a producción.
Mantener actualizados tanto PrestaShop como los módulos de pago.
Revisar los logs si algo falla. El error suele estar ahí.

[INFO] Si después de todo sigues teniendo problemas, contacta con el soporte de tu hosting. Muchas veces el bloqueo viene por la configuración del servidor (firewall, mod_security, etc.) y ellos pueden ayudarte a solucionarlo.

Ahora ya sabes cómo configurar el pago en tu tienda online. ¡A vender se ha dicho!