PrestaShop: Cómo instalar un módulo de pago

Para que tu tienda online con PrestaShop empiece a recibir pagos de forma segura, necesitas instalar un módulo de pago. Este artículo te guiará paso a paso, desde qué es un módulo de pago hasta cómo instalarlo y configurarlo sin complicaciones. Vamos a ello.

¿Qué es un módulo de pago en PrestaShop?

Un módulo de pago es un pequeño programa que se instala en tu PrestaShop para conectar tu tienda con un procesador de pagos (como PayPal, Stripe, Redsys, etc.). Sin él, tus clientes no podrían pagar sus compras online.

Piensa en él como un puente: por un lado está tu tienda, por el otro el banco o plataforma de pago. El módulo se encarga de que la comunicación sea fluida, segura y que el dinero llegue a tu cuenta.

Requisitos previos antes de instalar un módulo de pago

Antes de lanzarte, asegúrate de tener lo siguiente:

• Acceso al panel de administración de PrestaShop. Necesitas las credenciales de tu tienda.
• Cuenta activa en el procesador de pago. Por ejemplo, si quieres PayPal, debes tener una cuenta de negocios de PayPal.
• Datos de conexión del procesador. Normalmente son claves API, tokens o IDs que te proporciona el procesador al registrarte.
• Conexión a internet estable. La instalación y configuración suele requerir descargar archivos o hacer llamadas a servidores externos.
• Versión compatible de PrestaShop. Verifica que el módulo sea compatible con tu versión de PrestaShop (1.6, 1.7, 8.x). Puedes verlo en el apartado "Parámetros de la tienda > Información" de tu back office.

[INFO] Si utilizas un panel de control como Syspanel (accesible por el puerto 2106), puedes gestionar los archivos de tu tienda desde el administrador de archivos, aunque para instalar módulos de pago normalmente basta con el back office de PrestaShop.

Métodos para instalar un módulo de pago en PrestaShop

Existen dos formas principales de instalar un módulo de pago. Te explico ambas.

Método 1: Instalación desde el mercado de módulos de PrestaShop (Addons)

Este es el método más sencillo y recomendado para principiantes.

1. Accede a tu back office de PrestaShop. Normalmente es tudominio.com/admin o la ruta que configuraste.
2. Ve al menú "Módulos" > "Catálogo de módulos".
3. En la barra de búsqueda, escribe el nombre del módulo de pago que deseas (por ejemplo, "PayPal", "Stripe", "Redsys").
4. Aparecerá una lista de módulos. Busca el oficial del procesador (suelen tener un icono de verificación).
5. Haz clic en el botón "Instalar" o "Comprar" (si es de pago). Si es de pago, se abrirá una ventana para que completes la compra con tu cuenta de PrestaShop Addons.
6. Una vez comprado e instalado, el módulo aparecerá en la sección "Módulos" > "Gestor de módulos".
7. Busca el módulo recién instalado y haz clic en "Configurar".

Método 2: Instalación manual mediante carga de archivo ZIP

Este método es útil si tienes el archivo del módulo (normalmente un .zip) descargado desde otra fuente o desde la web del procesador.

1. Descarga el archivo ZIP del módulo en tu ordenador. Asegúrate de que sea la versión correcta para tu PrestaShop.
2. Accede a tu back office: "Módulos" > "Gestor de módulos".
3. En la parte superior derecha, haz clic en el botón "Subir un módulo".
4. Se abrirá una ventana. Arrastra el archivo .zip o haz clic para seleccionarlo desde tu ordenador.
5. PrestaShop subirá y descomprimirá el módulo automáticamente. Si todo va bien, verás un mensaje de éxito.
6. El módulo aparecerá en la lista de módulos instalados. Busca y haz clic en "Configurar".

[WARNING] No compres ni descargues módulos de sitios no oficiales. Podrían contener malware o ser incompatibles, causando problemas de seguridad o funcionamiento en tu tienda.

Configuración básica de un módulo de pago

Una vez instalado, toca configurarlo. Aunque cada módulo es diferente, los pasos generales son:

1. Accede a la configuración del módulo. Desde "Gestor de módulos", busca el módulo y haz clic en "Configurar".
2. Introduce las claves de API o credenciales. El módulo te pedirá datos como:
   • Client ID y Secret Key (para PayPal, Stripe, etc.).
   • Código de comercio o Número de terminal (para TPV virtuales como Redsys).
   • Modo de operación: Normalmente "Producción" (real) o "Pruebas" (sandbox). Empieza siempre en modo pruebas para verificar que todo funciona.
3. Configura las opciones de pago. Puedes elegir:
   • Activar/desactivar el módulo.
   • Países donde estará disponible.
   • Importe mínimo/máximo para usar este método.
   • Orden de aparición en la lista de métodos de pago.
4. Guarda los cambios. Busca el botón "Guardar" o "Actualizar".
5. Realiza una prueba de compra. Usa el modo pruebas para simular una compra en tu tienda y verificar que el proceso de pago funciona correctamente.

Solución de problemas comunes

A veces la instalación no sale a la primera. Aquí tienes los problemas más frecuentes y cómo resolverlos.

El módulo no aparece en el catálogo

• Causa: Puede que el módulo no sea compatible con tu versión de PrestaShop o que esté desactualizado.
• Solución: Busca en la web oficial del procesador de pago la versión para tu PrestaShop. Descárgala e instálala manualmente (Método 2).

Error al instalar el módulo ZIP

• Causa: El archivo ZIP está corrupto, no tiene la estructura correcta o el servidor tiene límites de tamaño de archivo.
• Solución:
  1. Verifica que el archivo ZIP no esté dañado. Vuelve a descargarlo.
  2. Comprueba el tamaño máximo de subida en tu servidor. Puedes hacerlo desde Syspanel (puerto 2106) en la sección de configuración de PHP o contactando con tu hosting.
  3. Intenta subir el módulo manualmente a través de FTP o el administrador de archivos de Syspanel. Descomprime el ZIP en la carpeta /modules/ de tu instalación de PrestaShop. Luego, ve al back office y actívalo desde "Gestor de módulos".

El módulo se instala pero no funciona

• Causa: Falta alguna dependencia (como cURL, OpenSSL) o las credenciales son incorrectas.
• Solución:
  1. Revisa los requisitos del módulo en su documentación.
  2. Verifica que las claves API estén bien copiadas, sin espacios.
  3. Comprueba que el modo pruebas esté activado y que el procesador de pago esté configurado para aceptar conexiones desde tu dominio.

Error de conexión con el procesador de pagos

• Causa: Firewall, certificado SSL o problemas de DNS.
• Solución:
  1. Asegúrate de que tu tienda tenga un certificado SSL válido (HTTPS).
  2. Desde Syspanel (puerto 2106), verifica que el firewall no bloquee las IPs del procesador de pagos.
  3. Contacta con el soporte del procesador para verificar que tu cuenta está activa y bien configurada.

Preguntas frecuentes (FAQ)

¿Puedo instalar varios módulos de pago?

Sí, PrestaShop te permite tener activos varios módulos de pago a la vez. Tus clientes podrán elegir el que prefieran al finalizar la compra.

¿Qué hago si el módulo que quiero no está en el catálogo de PrestaShop?

Puedes instalar módulos de terceros de forma manual (Método 2). Solo asegúrate de que sean de fuentes fiables y compatibles con tu versión de PrestaShop.

¿Es necesario tener conocimientos técnicos para instalar un módulo de pago?

No, el proceso está diseñado para ser sencillo. Si sigues los pasos de este artículo, podrás hacerlo sin problemas. Si surge algún error, las soluciones aquí explicadas te ayudarán.

¿Los módulos de pago gratuitos son seguros?

Depende de la fuente. Los módulos oficiales de los procesadores (PayPal, Stripe, etc.) suelen ser gratuitos y muy seguros. Evita módulos de sitios desconocidos.

¿Puedo instalar un módulo de pago desde el panel de control del hosting (Syspanel)?

Sí, puedes subir el archivo ZIP a través del administrador de archivos de Syspanel (accesible por el puerto 2106) y descomprimirlo en la carpeta /modules/. Luego, actívalo desde el back office de PrestaShop.

[TIP] Si tu hosting usa Syspanel, recuerda que el acceso al panel es a través del puerto 2106 (ej: tudominio.com:2106). Allí puedes gestionar archivos, bases de datos y configuraciones de PHP que puedan afectar a la instalación de módulos.

Conclusión

Instalar un módulo de pago en PrestaShop es un paso fundamental para que tu tienda online pueda operar. Con los dos métodos que te he explicado (desde el catálogo o manualmente), podrás añadir cualquier procesador de pago que necesites. Recuerda siempre probar en modo pruebas antes de activar el modo real y mantener tanto PrestaShop como los módulos actualizados para garantizar la seguridad y el correcto funcionamiento.

Si tienes dudas, revisa la documentación del módulo específico o contacta con el soporte de tu hosting. ¡Tu tienda online está cada vez más cerca de recibir sus primeros pedidos!