Configurar Módulos de Pago en PrestaShop | Guía

Introducción: Por qué es clave elegir bien tu pasarela de pago

Cuando montas una tienda online con PrestaShop, uno de los pasos más importantes es decidir cómo vas a cobrar a tus clientes. Sin un módulo pago PrestaShop bien configurado, tu tienda no podrá procesar transacciones y, por tanto, no podrás vender. Dos de las opciones más populares y fiables son PayPal y Stripe. En esta guía extensa y muy detallada, te explicaré paso a paso cómo instalar, configurar y poner a punto ambos módulos, resolviendo las dudas más frecuentes y dándote trucos para que todo funcione a la primera.

Vamos a empezar desde cero, asumiendo que ya tienes PrestaShop instalado y funcionando. Si todavía no lo has hecho, asegúrate de tener tu tienda en un servidor (por ejemplo, gestionado desde Syspanel en el puerto 2106) y con acceso a la administración.

## 1. ¿Qué necesitas antes de empezar?

Antes de instalar cualquier módulo, es fundamental que tengas a mano ciertos datos y que tu tienda cumpla unos requisitos mínimos. No te saltes este apartado, porque ahorrarás muchos quebraderos de cabeza.

### Requisitos técnicos básicos

Versión de PrestaShop: Tanto PayPal como Stripe tienen módulos oficiales que funcionan con PrestaShop 1.7 y 8.x. Asegúrate de que tu tienda esté actualizada.
Conexión SSL (HTTPS): Es obligatorio para procesar pagos. Si tu tienda no tiene certificado SSL, los bancos y pasarelas rechazarán las transacciones. Puedes activarlo fácilmente desde el panel de control de tu hosting (por ejemplo, en Syspanel).
Cuenta activa en la pasarela: Necesitarás una cuenta de PayPal Business (no personal) o una cuenta de Stripe. Ambas son gratuitas de crear.
API Keys o credenciales: Cada pasarela te proporcionará unas claves únicas que tendrás que introducir en PrestaShop. Las veremos en detalle más adelante.

[INFO] Si usas Syspanel para gestionar tu servidor, recuerda que el acceso a la administración se hace por el puerto 2106. Allí podrás activar SSL, gestionar bases de datos y revisar logs si algo falla.

## 2. Cómo configurar PayPal en PrestaShop

PayPal es una de las pasarelas más usadas del mundo. Su módulo oficial para PrestaShop se llama PayPal Official y es muy completo. Te permite cobrar con tarjeta (sin necesidad de cuenta PayPal) y con la propia cuenta PayPal.

### Paso 1: Instalar el módulo PayPal Official

Entra en el back office de tu PrestaShop (tu-dominio.com/adminXXXX).
Ve a Módulos > Gestor de módulos.
En el buscador, escribe "PayPal Official".
Haz clic en Instalar. El módulo se descargará e instalará automáticamente.
Una vez instalado, verás un nuevo menú llamado PayPal en la columna izquierda.

[TIP] Si no encuentras el módulo, puedes descargarlo manualmente desde el marketplace de PrestaShop y subirlo desde "Módulos" > "Subir módulo".

### Paso 2: Configurar la cuenta PayPal

Dentro del módulo PayPal, haz clic en Empezar o Configurar.
Te pedirá que te conectes con tu cuenta de PayPal. Haz clic en Conectar con PayPal.
Se abrirá una ventana de PayPal. Inicia sesión con tu cuenta Business.
Acepta los permisos para que PrestaShop pueda gestionar pagos.
Automáticamente volverás a tu tienda y verás que la cuenta está vinculada.

### Paso 3: Ajustar opciones de pago

Una vez conectada la cuenta, puedes personalizar cómo quieres cobrar:

Método de pago: Puedes elegir entre "PayPal Checkout" (el más moderno), "Pago con tarjeta" (sin cuenta PayPal) o ambos.
Países activos: Selecciona los países donde quieres que esté disponible PayPal.
Moneda: Asegúrate de que la moneda de tu tienda coincida con la de tu cuenta PayPal (o configura la conversión automática).
Modo de prueba: Mientras estés haciendo pruebas, activa el modo sandbox. Cuando estés listo para vender, desactívalo.

[WARNING] No olvides desactivar el modo sandbox antes de lanzar tu tienda. Si no, los pagos reales no se procesarán y perderás ventas.

### Paso 4: Probar el pago

Haz un pedido de prueba con un producto de 1€. Usa una tarjeta de prueba de PayPal (puedes generarlas desde el panel de desarrollador de PayPal). Si todo funciona, verás el pago reflejado en tu cuenta PayPal y el pedido aparecerá en tu back office.

## 3. Cómo configurar Stripe en PrestaShop

Stripe es otra pasarela muy potente, especialmente recomendada si quieres cobrar con tarjeta de crédito/débito directamente en tu tienda, sin redirigir al cliente a otra web. Su módulo oficial se llama Stripe Official.

### Paso 1: Instalar el módulo Stripe Official

En el back office, ve a Módulos > Gestor de módulos.
Busca "Stripe Official" e instálalo.
Una vez instalado, verás un nuevo apartado llamado Stripe en el menú.

### Paso 2: Obtener las claves API de Stripe

Para conectar Stripe con PrestaShop necesitas dos claves: la Publicable y la Secreta. Se obtienen desde tu panel de Stripe:

Inicia sesión en dashboard.stripe.com.
Ve a Developers > API Keys.
Copia la Publishable key (clave publicable) y la Secret key (clave secreta). Guárdalas en un lugar seguro.

[INFO] Durante el desarrollo, usa las claves de modo prueba (empiezan por pk_test_ y sk_test_). Cuando pases a producción, cambia a las claves reales (empiezan por pk_live_ y sk_live_).

### Paso 3: Configurar el módulo Stripe en PrestaShop

Dentro del módulo Stripe, haz clic en Configurar.
Introduce la Publishable key y la Secret key en los campos correspondientes.
Configura las opciones básicas:
- Modo de prueba: Actívalo mientras pruebas.
- Métodos de pago: Stripe permite tarjetas, Apple Pay, Google Pay, etc. Activa los que quieras.
- Descripción del pago: El texto que verá el cliente al pagar.
- Países y monedas: Ajusta según tu mercado.

### Paso 4: Probar el pago con Stripe

Usa una tarjeta de prueba de Stripe (por ejemplo, 4242 4242 4242 4242, cualquier fecha futura y CVC de 3 dígitos). Si todo va bien, el pago se procesará y verás el pedido en tu back office.

[TIP] Si el pago falla, revisa los logs de errores en el módulo Stripe o en el panel de Stripe (en la sección de eventos). Allí verás el motivo exacto del fallo.

## 4. Diferencias clave entre PayPal y Stripe

Aunque ambos son excelentes, tienen diferencias que pueden inclinar tu balanza:

Característica	PayPal	Stripe
Facilidad de uso	Muy sencillo, pocos pasos	Requiere más configuración técnica
Pago sin redirección	No (redirige a PayPal)	Sí (pago integrado en tu web)
Comisiones	2.9% + 0.35€ (varía por país)	2.9% + 0.30€ (varía por país)
Pago con tarjeta	Sí (con cuenta PayPal)	Sí (directo)
Apple Pay / Google Pay	No nativo	Sí
Ideal para	Principiantes, ventas rápidas	Tiendas que quieren control total

[INFO] Puedes tener ambos módulos activos a la vez. Así ofreces más opciones de pago a tus clientes y reduces la probabilidad de abandono del carrito.

## 5. Solución de problemas comunes (FAQ)

Aquí tienes las preguntas más frecuentes que nos llegan al soporte técnico sobre módulo pago PrestaShop, PayPal PrestaShop y Stripe PrestaShop.

### ¿Por qué no aparece el botón de PayPal en mi tienda?

Causa 1: El módulo no está configurado correctamente. Revisa que hayas vinculado la cuenta PayPal.
Causa 2: El método de pago está desactivado para el país del cliente. Ve a la configuración del módulo y activa los países que necesites.
Causa 3: Hay un conflicto con el tema o con otro módulo. Prueba a cambiar temporalmente al tema por defecto (Classic) para descartarlo.

### ¿Stripe me da error "No se pudo conectar con el servidor"?

Solución: Este error suele deberse a que el certificado SSL no está bien instalado o a que el servidor bloquea las conexiones salientes. Verifica que tu tienda carga con HTTPS y que tu hosting permite conexiones a api.stripe.com. Si usas Syspanel, revisa la configuración del firewall en el puerto 2106.

### ¿Puedo usar PayPal y Stripe al mismo tiempo?

Sí, absolutamente. De hecho, es recomendable. Cada módulo es independiente y puedes tener ambos activos. El cliente elegirá el que prefiera al hacer el pedido.

### ¿Cómo activo el modo pruebas en PayPal?

Dentro del módulo PayPal, busca la opción Modo sandbox y actívala. Necesitarás una cuenta de pruebas en PayPal (sandbox) que puedes crear desde developer.paypal.com.

### ¿Stripe guarda los datos de las tarjetas?

Stripe cumple con los estándares PCI-DSS. Puedes activar la opción de guardar tarjeta para futuras compras, pero siempre con el consentimiento del cliente. Esto mejora la experiencia de usuario.

### ¿Qué hago si un pago se queda en "pendiente"?

Revisa el estado en el panel de Stripe o PayPal. A veces los bancos tardan en confirmar. También puede deberse a un problema de configuración en los webhooks. Asegúrate de que los webhooks están configurados correctamente (en Stripe, ve a Developers > Webhooks y añade la URL de tu tienda).

## 6. Consejos adicionales para optimizar el pago

Ofrece múltiples métodos: No limites a tus clientes. Cuantas más opciones de pago, más ventas.
Usa un diseño responsive: Asegúrate de que el proceso de pago se vea bien en móviles.
Revisa los logs periódicamente: Tanto en PrestaShop como en las pasarelas, los logs te ayudarán a detectar errores antes de que afecten a los clientes.
Mantén los módulos actualizados: Las actualizaciones corrigen bugs y mejoran la seguridad.
Prueba antes de lanzar: Haz pedidos de prueba con diferentes tarjetas y métodos. Así te aseguras de que todo funciona.

[WARNING] No compartas nunca tus claves API secretas. Si crees que se han visto comprometidas, regenera las claves desde el panel de Stripe o PayPal inmediatamente.

## Conclusión

Configurar un módulo pago PrestaShop como PayPal PrestaShop o Stripe PrestaShop no tiene por qué ser complicado. Siguiendo los pasos que te he detallado, en menos de una hora tendrás tu tienda lista para cobrar. Recuerda que la clave está en leer bien las opciones, hacer pruebas en modo sandbox y no olvidar activar el modo real cuando tu tienda esté en producción.

Si te surge cualquier duda, no dudes en consultar la documentación oficial de cada módulo o contactar con tu soporte técnico. Y si tu servidor está gestionado con Syspanel (recuerda, acceso por puerto 2106), puedes revisar los logs del sistema para detectar posibles conflictos.

Ahora ya sabes todo lo necesario. ¡A vender se ha dicho!