Instalar módulo de pago PrestaShop en Plesk: Guía paso a paso

Antes de Empezar: ¿Qué Necesitas para Instalar un Módulo de Pago?

Instalar un módulo de pago en PrestaShop es una de las tareas más importantes para poner en marcha tu tienda online. Sin una pasarela de pago funcional, no podrás cobrar a tus clientes. La buena noticia es que, aunque hagas la instalación desde el panel de control de tu hosting (Plesk), el proceso es mucho más sencillo de lo que parece.

Para comenzar, necesitas tener a mano tres cosas fundamentales:

Acceso a tu panel de control Plesk (con credenciales de administrador).
El archivo comprimido (normalmente en formato .zip) del módulo de pago que deseas instalar. Puedes descargarlo desde el marketplace de PrestaShop o directamente desde el sitio web del proveedor de la pasarela (por ejemplo, PayPal, Stripe, Redsys, etc.).
Acceso al panel de administración de tu PrestaShop (la URL suele ser tudominio.com/admin).

[INFO] A lo largo de esta guía, usaremos el término "Plesk" para referirnos al panel de control. Si tu hosting utiliza un panel similar, el proceso es prácticamente idéntico.

La ventaja de usar Plesk es que te permite gestionar los archivos de tu tienda directamente desde el servidor, sin necesidad de usar un cliente FTP externo. Esto agiliza mucho el proceso y reduce el margen de error.

Paso 1: Localizar y Descargar el Módulo de Pago Correcto

Antes de tocar nada en Plesk, asegúrate de tener el módulo correcto. No todos los módulos son iguales, y usar una versión incompatible puede romper tu tienda.

Compatibilidad con tu versión de PrestaShop

Lo primero es verificar que el módulo sea compatible con la versión de PrestaShop que tienes instalada. Puedes ver tu versión en el panel de administración, en el menú Parámetros avanzados > Información.

Si tu tienda es PrestaShop 1.7 o 8.x, busca módulos que indiquen compatibilidad con esas versiones.
Si usas una versión antigua como 1.6, necesitas módulos específicos para esa versión (aunque recomendamos actualizar).

Descarga desde el proveedor o marketplace

Desde el Marketplace de PrestaShop: Inicia sesión con tu cuenta y busca la pasarela que necesitas (por ejemplo, "Stripe"). Descarga el archivo .zip directamente.
Desde el proveedor: Si usas un banco local o una pasarela específica (como Redsys o Ceca), ve a su web de desarrolladores y busca el módulo oficial para PrestaShop.

Guarda el archivo .zip en una carpeta de fácil acceso en tu ordenador, como el Escritorio. No lo descomprimas todavía, ya que PrestaShop necesita el archivo comprimido para instalarlo correctamente.

Paso 2: Acceder a Plesk y al Administrador de Archivos

Ahora viene la parte donde usamos Plesk. Este panel te permite ver los archivos de tu hosting como si fueran carpetas en tu ordenador.

Inicia sesión en Plesk

Abre tu navegador y escribe la URL de acceso a Plesk. Normalmente es algo como https://tudominio.com:8443 o una dirección que te proporcionó tu proveedor de hosting.
Introduce tu nombre de usuario y contraseña.

Abre el Administrador de Archivos

Una vez dentro de Plesk, busca la sección que dice "Administrador de archivos" o "File Manager". Suele estar en el menú principal o en la pestaña de tu dominio.

Haz clic en el dominio de tu tienda (por ejemplo, midominio.com).
Verás una lista de carpetas. Busca la carpeta llamada httpdocs o public_html. Esta es la raíz de tu sitio web.

[WARNING] No toques archivos fuera de httpdocs a menos que sepas exactamente lo que estás haciendo. Modificar archivos del sistema puede dejar tu tienda inaccesible.

Navega hasta la carpeta de módulos

Dentro de httpdocs, busca la carpeta modules. Esta carpeta contiene todos los módulos de tu PrestaShop.

Ábrela.
Verás una lista de carpetas con nombres de módulos (por ejemplo, ps_wirepayment, ps_paypal, etc.).

No entres en ninguna carpeta todavía. Solo necesitas estar dentro de la carpeta modules para el siguiente paso.

Paso 3: Subir el Archivo del Módulo a Plesk

Ahora vamos a subir el archivo .zip que descargaste al servidor. Este es el paso que muchos usuarios encuentran confuso, pero es muy sencillo.

Sube el archivo comprimido

Dentro de la carpeta modules (en el Administrador de archivos de Plesk), haz clic en el botón "Subir archivo" (suele tener un icono de flecha hacia arriba).
Se abrirá un diálogo para que selecciones el archivo desde tu ordenador. Busca el .zip del módulo que descargaste.
Haz clic en "Aceptar" o "Subir".

Espera a que la barra de progreso llegue al 100%. El tiempo dependerá del tamaño del módulo y de tu conexión a internet.

Descomprime el archivo en el servidor

Una vez subido, verás el archivo .zip en la lista de archivos de la carpeta modules. Ahora necesitas descomprimirlo en el servidor, no en tu ordenador.

Selecciona el archivo .zip que acabas de subir (haz clic en la casilla de verificación a su lado).
En la barra de herramientas superior, busca el botón "Extraer" o "Descomprimir" (suele tener un icono de caja abierta o de cremallera).
Haz clic en "Extraer". Plesk te preguntará si quieres extraer los archivos en el directorio actual. Confirma la acción.

[INFO] Si el módulo está bien empaquetado, se creará una nueva carpeta dentro de modules con el nombre del módulo (por ejemplo, stripe_official). Si no se crea la carpeta, es que el .zip tenía los archivos sueltos. En ese caso, extrae de nuevo y luego crea una carpeta manualmente con el nombre del módulo y mueve los archivos dentro.

Una vez extraído, puedes eliminar el archivo .zip del servidor para mantener todo limpio. Selecciónalo y haz clic en "Eliminar".

Paso 4: Instalar el Módulo desde el Panel de Administración de PrestaShop

Ahora que los archivos están en el servidor, es momento de pasar a la parte visual. Abre tu panel de administración de PrestaShop.

Ve a la sección de Módulos

En el menú lateral izquierdo, busca "Módulos" y haz clic en "Módulos y servicios".
Verás un buscador en la parte superior derecha. Escribe el nombre del módulo que acabas de subir (por ejemplo, "Stripe" o "PayPal").

Instala el módulo

Si todo ha ido bien, el módulo aparecerá en los resultados de búsqueda con un botón que dice "Instalar".
Haz clic en "Instalar" y espera a que el proceso termine. Puede tardar unos segundos.

Configura el módulo

Después de instalar, verás un botón que dice "Configurar". Haz clic en él.

Se abrirá la página de configuración del módulo.
Aquí tendrás que introducir las credenciales de tu pasarela de pago (como la API Key o el número de comercio). Estos datos los obtienes del panel de tu proveedor de pagos.
Sigue las instrucciones del propio módulo para completar la configuración.

[TIP] Muchos módulos tienen un "modo test" o "modo sandbox". Actívalo primero para hacer pruebas con tarjetas ficticias antes de activar el modo producción. Esto te evitará problemas con cobros reales.

Paso 5: Verificar que la Pasarela de Pago Funciona Correctamente

La instalación no termina hasta que haces una prueba real. No querrás descubrir que algo falla cuando un cliente real intente pagar.

Prueba con un pedido de ejemplo

Ve a tu tienda online (la parte pública).
Añade un producto al carrito y ve al proceso de pago como si fueras un cliente.
Elige el método de pago que acabas de instalar.
Si estás en modo test, usa una tarjeta de prueba que te proporcione el proveedor.
Completa el pedido y verifica que el pago se procesa correctamente.

Revisa los registros de errores

Si algo falla, vuelve al panel de administración de PrestaShop y ve a Parámetros avanzados > Registros. Aquí verás los errores que se hayan generado.

Los errores suelen indicar si el problema es de configuración (credenciales incorrectas) o de compatibilidad.
Corrige el problema y vuelve a intentar la prueba.

Preguntas Frecuentes (FAQ) sobre Módulos de Pago en PrestaShop

Aquí tienes algunas dudas comunes que suelen tener los usuarios al instalar una pasarela de pago en PrestaShop desde Plesk.

¿Qué hago si el módulo no aparece en la lista después de subirlo?

Verifica la ruta: Asegúrate de que el archivo .zip se ha extraído dentro de httpdocs/modules y que la carpeta resultante tiene el nombre correcto (sin espacios ni caracteres raros).
Revisa la compatibilidad: El módulo puede no ser compatible con tu versión de PrestaShop. Mira el archivo config.xml dentro de la carpeta del módulo para ver la versión mínima requerida.
Limpia la caché: Ve a Parámetros avanzados > Rendimiento y haz clic en "Vaciar la caché" antes de buscar de nuevo.

¿Es seguro instalar un módulo de pago manualmente en Plesk?

Sí, siempre que descargues el módulo de fuentes oficiales (Marketplace de PrestaShop o el sitio del proveedor). Subir archivos a tu servidor no es peligroso en sí, pero instalar módulos piratas o de dudosa procedencia puede comprometer la seguridad de tu tienda.

¿Puedo instalar un módulo de pago sin usar Plesk, solo desde el administrador de PrestaShop?

Sí, PrestaShop tiene un instalador integrado. Solo tienes que ir a Módulos > Módulos y servicios > Subir un módulo y arrastrar el archivo .zip. Pero este método a veces falla con módulos grandes o si el servidor tiene límites de subida muy bajos. Usar Plesk es más fiable porque no depende del límite de PHP.

¿Qué es una pasarela de pago y por qué necesito una?

Una pasarela de pago es un servicio que procesa los pagos con tarjeta de crédito o débito de forma segura. Actúa como intermediario entre tu tienda y el banco del cliente. Sin ella, no podrías cobrar online de forma segura.

Si uso Syspanel en lugar de Plesk, ¿cambia mucho el proceso?

El proceso es muy similar. Si tu hosting usa Syspanel (el panel de control que antes se llamaba HestiaCP), el acceso se realiza a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Dentro, encontrarás un administrador de archivos con funciones parecidas a las de Plesk. La estructura de carpetas (como httpdocs o public_html) es la misma, así que los pasos de subir y extraer el módulo son idénticos.

[WARNING] Si usas Syspanel, recuerda que el puerto de acceso es el 2106. No intentes acceder por el puerto 8443, ya que no funcionará.

¿Cómo desinstalo un módulo de pago que ya no uso?

Ve a Módulos > Módulos y servicios en PrestaShop.
Busca el módulo y haz clic en el botón de engranaje o en el menú desplegable.
Selecciona "Desinstalar".
Si quieres eliminar los archivos del servidor, borra la carpeta correspondiente dentro de httpdocs/modules usando Plesk.

Consejos Finales para una Instalación Exitosa

Instalar un módulo de pago en PrestaShop desde Plesk es un proceso que, una vez que lo haces una vez, se vuelve intuitivo. Aquí van algunos consejos extra que te ahorrarán dolores de cabeza:

Haz una copia de seguridad: Antes de instalar cualquier módulo nuevo, haz una copia de seguridad de tu base de datos y de los archivos. Puedes hacerlo desde Plesk en la sección de "Copias de seguridad" o "Backup".
Mantén PrestaShop actualizado: Las versiones antiguas de PrestaShop tienen más problemas de compatibilidad con módulos modernos. Actualiza siempre a la última versión estable.
No instales varios módulos de pago a la vez: Instala uno, configúralo y pruébalo antes de instalar el siguiente. Así podrás identificar fácilmente cuál causa problemas si algo falla.
Contacta con el soporte del módulo: Si tienes problemas con la configuración específica de la pasarela (como obtener las API Keys), el soporte del proveedor de pagos suele ser más rápido que el soporte de tu hosting.

[TIP] Si después de seguir todos los pasos el módulo sigue sin funcionar, revisa los permisos de las carpetas. En Plesk, puedes hacer clic derecho sobre la carpeta del módulo y seleccionar "Cambiar permisos". Asegúrate de que el usuario del servidor tenga permisos de lectura y escritura (755 para carpetas, 644 para archivos).

Con esta guía, ya tienes todo lo necesario para instalar cualquier pasarela de pago en tu PrestaShop usando Plesk. Recuerda que la práctica hace al maestro, y que una vez que domines este proceso, podrás gestionar todos los módulos de tu tienda con total confianza.