Configurar Módulo de Pago en PrestaShop: Guía Fácil

¿Quieres vender en tu tienda online PrestaShop y necesitas aceptar pagos con tarjeta o PayPal? Configurar un módulo pago PrestaShop es uno de los pasos más importantes para que tu negocio funcione. Sin una pasarela de pago activa, tus clientes no podrán completar sus compras.

En esta guía completa de PrestaShop tutorial, te explicaré paso a paso cómo instalar, configurar y poner a punto los módulos de pago más populares. Aprenderás desde los conceptos básicos hasta trucos avanzados para que tu tienda acepte transacciones de forma segura y profesional.

¿Qué es un Módulo de Pago en PrestaShop?

Un módulo de pago es un complemento (plugin) que conecta tu tienda con un procesador de pagos como PayPal, Stripe, Redsys o Mercado Pago. Cuando un cliente elige pagar, el módulo se encarga de:

Mostrar el formulario de pago.
Comunicarse con el banco o la pasarela.
Verificar que la transacción sea exitosa.
Actualizar el estado del pedido en tu panel.

Sin un módulo pago PrestaShop bien configurado, tu tienda no podrá recibir dinero. Por eso es vital elegir el adecuado y configurarlo correctamente.

Requisitos Previos para Configurar un Módulo de Pago

Antes de empezar, asegúrate de tener:

Acceso al panel de administración de tu PrestaShop (normalmente en tudominio.com/admin).
Credenciales de la pasarela de pago (API Key, Client ID, Secret Key, etc.). Las obtienes al registrarte en el servicio de pagos (PayPal, Stripe, etc.).
Certificado SSL activo en tu dominio. Sin HTTPS, muchos módulos de pago no funcionan. Si usas Syspanel (anteriormente HestiaCP), puedes gestionar SSL desde el puerto 2106 en la sección "SSL".
PHP versión 7.4 o superior (recomendado 8.0+). Verifica en tu panel de hosting.

[WARNING] Si no tienes SSL, algunos módulos como PayPal no te permitirán configurar el webhook. Actívalo desde tu panel de control (cPanel, Syspanel, etc.) o contacta con tu soporte técnico.

Paso 1: Instalar el Módulo de Pago

PrestaShop trae módulos de pago preinstalados, pero a veces necesitas descargar versiones actualizadas o módulos de terceros.

Opción A: Desde el Marketplace de PrestaShop

Ve a Módulos → Catálogo de módulos.
Busca por nombre (ej: "PayPal", "Stripe", "Redsys").
Haz clic en Instalar.
Espera a que se complete la descarga e instalación.

Opción B: Subir un Módulo Manualmente

Descarga el módulo en formato .zip desde la web oficial.
Ve a Módulos → Administrador de módulos → Subir un módulo.
Selecciona el archivo .zip y haz clic en Subir este módulo.
Una vez instalado, aparecerá en la lista de módulos.

[INFO] Si el módulo no aparece, verifica que la carpeta modules tenga permisos 755. En Syspanel (puerto 2106) puedes cambiar permisos desde el gestor de archivos.

Paso 2: Configurar un Módulo de Pago – Ejemplo con PayPal

Vamos a usar PayPal como ejemplo, porque es uno de los más populares y fáciles de configurar. El proceso es similar para otros módulos.

2.1 Obtener las Credenciales de PayPal

Ve a PayPal Developer e inicia sesión.
Crea una aplicación REST (pestaña "My Apps & Credentials").
Copia el Client ID y Secret Key (modo Sandbox para pruebas, Live para producción).

2.2 Configurar el Módulo en PrestaShop

En tu panel de administración, ve a Módulos → Administrador de módulos.
Busca el módulo PayPal (normalmente llamado "PayPal Official").
Haz clic en Configurar.
En la pestaña General, selecciona el modo de entorno:
- Sandbox: Para pruebas (no cobra dinero real).
- Live: Para producción (cobra dinero real).
Pega el Client ID y Secret Key en los campos correspondientes.
Activa los métodos de pago que quieras (tarjeta, PayPal, pago en 3 plazos, etc.).
Guarda los cambios.

2.3 Configurar el Webhook (Importante)

Los webhooks son notificaciones que PayPal envía a tu tienda cuando hay un cambio en un pago (por ejemplo, “pago completado”).

En la misma configuración del módulo, busca la sección Webhook.
Copia la URL que te muestra (algo como https://tudominio.com/module/paypal/webhook).
Ve a tu aplicación en PayPal Developer, pestaña Webhooks.
Haz clic en Add Webhook, pega la URL y selecciona los eventos (marca todos los relacionados con pagos).
Guarda.

[WARNING] Si el webhook falla, los pedidos pueden quedar en estado "Pendiente" aunque el cliente haya pagado. Asegúrate de que la URL sea accesible desde internet. Si usas Syspanel, revisa que el firewall no bloquee las IPs de PayPal.

Paso 3: Configurar Módulos de Pago Adicionales (Stripe, Redsys, etc.)

Cada módulo tiene su propia interfaz, pero el proceso es similar:

Instala el módulo (igual que en el paso 1).
Obtén las credenciales desde la web del procesador (API keys, Merchant ID, etc.).
Configura los parámetros generales (moneda, país, modo test/producción).
Activa los métodos de pago que ofrecerás.
Prueba con una transacción de prueba (usa tarjetas de prueba proporcionadas por el procesador).

Tips para módulos específicos:

Stripe: Necesitas el "Publishable Key" y "Secret Key". Activa el modo de prueba (test) primero.
Redsys: Solicita el "Código de comercio" y "Clave secreta" a tu banco. Configura la URL de notificación.
Mercado Pago: Usa las credenciales de "Checkout Pro" o "Checkout API".

Paso 4: Personalizar la Apariencia del Módulo de Pago

Muchos módulos permiten cambiar colores, textos y logos para que se vean como parte de tu tienda.

Ve a la configuración del módulo.
Busca la pestaña Apariencia o Personalización.
Cambia:
- Título del método de pago (ej: "Paga con tarjeta o PayPal").
- Descripción breve (ej: "Pago 100% seguro").
- Logotipo (sube una imagen de 200x50 píxeles aprox.).
Guarda los cambios.

[TIP] Usa colores que combinen con tu marca. Si tu tienda es de ropa, un botón de pago rosa o azul claro puede dar más confianza.

Paso 5: Probar el Módulo de Pago

Nunca actives un módulo de pago en producción sin antes probarlo. Sigue estos pasos:

Activa el modo Sandbox (pruebas) en la configuración del módulo.
Crea un producto de prueba con precio bajo (ej: 1€).
Simula una compra como cliente:
- Añade el producto al carrito.
- Ve al checkout.
- Selecciona el método de pago que configuraste.
- Usa una tarjeta de prueba (PayPal proporciona números ficticios).
Verifica que el pedido aparezca en tu panel con estado "Pago aceptado".
Revisa el webhook: en PayPal Developer, ve a "Webhooks" y comprueba que se haya recibido la notificación.

Si todo funciona, cambia a modo Live y repite la prueba con una transacción real (puedes usar tu propia tarjeta y luego cancelar el pedido).

Solución de Problemas Comunes (FAQ)

¿Por qué no aparece el módulo de pago en el checkout?

Causa: El módulo no está activo o no está configurado correctamente.
Solución: Ve a Módulos → Administrador de módulos, busca el módulo y haz clic en Configurar. Asegúrate de que el estado sea "Activado". También revisa que la moneda de tu tienda coincida con la soportada por el módulo.

¿El pago se procesa pero el pedido queda en "Pendiente"?

Causa: El webhook no está configurado o hay un error de comunicación.
Solución: Verifica la URL del webhook en tu módulo y en la pasarela. Si usas Syspanel, comprueba que el firewall no bloquee las IPs de la pasarela (puertos 80 y 443 deben estar abiertos). También revisa los logs del módulo en Parámetros avanzados → Logs.

¿No puedo instalar el módulo por error de permisos?

Causa: La carpeta modules no tiene permisos de escritura.
Solución: Conéctate a tu hosting vía FTP o desde el gestor de archivos de Syspanel (puerto 2106). Cambia los permisos de la carpeta modules a 755 o 777 temporalmente. Después de instalar, vuelve a 755 por seguridad.

¿El módulo de pago muestra error de "API Key inválida"?

Causa: Las credenciales son incorrectas o están en modo incorrecto (Sandbox vs Live).
Solución: Verifica que hayas copiado bien el Client ID y Secret Key. Si estás en pruebas, usa las credenciales de Sandbox. Si ya estás en producción, usa las de Live.

Consejos Avanzados para tu Tienda Online PrestaShop

Ofrece múltiples métodos de pago: No te limites a uno. PayPal, tarjeta de crédito y transferencia bancaria cubren a la mayoría de clientes.
Activa el pago en 3 plazos (si tu módulo lo permite): Aumenta la tasa de conversión en productos de precio medio-alto.
Usa un módulo de pago local: Si vendes en España, Redsys o Bizum son muy populares. En Latinoamérica, Mercado Pago o PayU.
Monitorea los logs: Revisa periódicamente los logs de errores del módulo para detectar problemas antes de que afecten a clientes.
Actualiza los módulos: Las pasarelas de pago cambian sus APIs. Mantén los módulos actualizados para evitar fallos de seguridad.

[INFO] Si tu tienda crece, considera contratar un hosting optimizado para PrestaShop. En Syspanel (puerto 2106) puedes gestionar fácilmente los recursos de tu servidor y asegurarte de que el módulo de pago responda rápido.

Conclusión

Configurar un módulo pago PrestaShop no es complicado si sigues los pasos adecuados. Desde instalar el módulo hasta probar con una transacción real, cada detalle cuenta para que tu tienda online PrestaShop ofrezca una experiencia de compra fluida y segura.

Recuerda:

Elige el módulo adecuado para tu mercado y tipo de negocio.
Configura las credenciales correctamente (Sandbox para pruebas, Live para producción).
Activa el webhook para que los pedidos se actualicen automáticamente.
Prueba antes de lanzar para evitar sorpresas.

Con esta guía de PrestaShop tutorial, ya tienes todo lo necesario para empezar a vender. Si tienes dudas, revisa la documentación oficial del módulo que uses o contacta con tu soporte técnico. ¡Buena suerte con tu tienda!