Guía para instalar módulos de pago en PrestaShop (PayPal, Stripe)
¿Por qué es importante instalar correctamente los módulos de pago en PrestaShop?
Cuando montas una tienda online con PrestaShop, uno de los pasos más críticos es configurar la pasarela de pago. Sin ella, tus clientes no pueden comprar, y sin una buena experiencia de pago, las tasas de abandono del carrito se disparan. Los módulos pago prestashop son la pieza que conecta tu tienda con los procesadores financieros, permitiendo cobrar de forma segura con tarjeta, PayPal o incluso métodos locales.
En esta guía extensa, te voy a explicar paso a paso cómo instalar y configurar los dos módulos más populares: PrestaShop PayPal y PrestaShop Stripe. No necesitas ser un experto en programación; solo seguir las instrucciones con calma. Al final, también resolveremos dudas frecuentes que suelen tener los comerciantes noveles.
Antes de empezar: requisitos previos y preparación
Antes de lanzarte a instalar cualquier módulo, asegúrate de tener todo en orden. Esto te ahorrará dolores de cabeza.
Requisitos técnicos mínimos
- Versión de PrestaShop: tanto PayPal como Stripe tienen versiones para PrestaShop 1.7 y 8.x. Verifica tu versión en el panel de administración (Parámetros avanzados > Información).
- PHP: necesitas al menos PHP 7.2, aunque se recomienda PHP 8.0 o superior para mejor rendimiento y seguridad.
- Conexión HTTPS: es obligatorio tener un certificado SSL activo en tu dominio. Sin HTTPS, las pasarelas de pago bloquean las transacciones.
- Cuenta de comercio: debes tener una cuenta verificada en PayPal Business o en Stripe. Si aún no la tienes, créala antes de empezar.
¿De dónde descargo los módulos?
Existen dos vías principales:
- Desde el marketplace oficial de PrestaShop: es la opción más segura, ya que los módulos pasan controles de calidad. Busca "PayPal" o "Stripe" en el catálogo.
- Desde la web del proveedor: PayPal y Stripe ofrecen sus módulos oficiales en sus sitios. Asegúrate de descargar la versión compatible con tu PrestaShop.
[WARNING]
Nunca descargues módulos de pago de sitios piratas o foros no oficiales. Podrían contener código malicioso que robe los datos de tus clientes o comprometa tu tienda.
Instalar un módulo de pago en PrestaShop: el proceso general
Aunque cada módulo tiene sus particularidades, la instalación base es siempre igual. Vamos a verla.
Paso 1: Subir el módulo al servidor
- Ve a tu panel de administración de PrestaShop.
- En el menú lateral, entra en Módulos > Módulos y servicios.
- Haz clic en el botón Subir un módulo (arriba a la derecha).
- Selecciona el archivo ZIP que descargaste y súbelo.
- PrestaShop lo instalará automáticamente y te mostrará un mensaje de éxito o error.
Paso 2: Activar y configurar
- Una vez subido, busca el módulo en la lista (puedes usar el buscador).
- Haz clic en Configurar para acceder a sus ajustes.
- Cada módulo te pedirá credenciales (API keys, tokens, etc.) que obtendrás de tu cuenta en PayPal o Stripe.
Paso 3: Probar con un pedido real
- Activa el modo sandbox o de pruebas si está disponible.
- Realiza una compra de prueba con una tarjeta ficticia.
- Si todo funciona, desactiva el modo de pruebas y haz un pedido real pequeño.
[TIP]
Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel de gestión se hace por el puerto 2106. Allí podrás revisar los logs de PHP o reiniciar servicios si algo falla.
Configurar PrestaShop PayPal paso a paso
El módulo oficial de PayPal es el más usado del mundo. Permite cobros con cuenta PayPal, tarjeta de crédito directa y métodos locales como Venmo o iDeal (según el país).
Instalación específica del módulo PayPal
- Descarga el módulo desde el marketplace de PrestaShop (búscalo como "PayPal Official").
- Súbelo siguiendo los pasos generales que vimos antes.
- Una vez instalado, ve a Módulos > Módulos y servicios > PayPal.
Configuración de credenciales
- El módulo te pedirá que te conectes con tu cuenta de PayPal Business.
- Haz clic en Conectar con PayPal y serás redirigido a PayPal.
- Inicia sesión y autoriza la conexión. Es posible que necesites generar un API Client ID y un API Secret desde el panel de desarrollador de PayPal (developer.paypal.com).
- Copia esas claves y pégalas en los campos correspondientes del módulo.
Opciones de pago que ofrece el módulo
- PayPal Checkout: el cliente paga con su cuenta PayPal.
- Tarjeta de crédito/débito: se muestra un formulario para pagar sin necesidad de cuenta PayPal.
- Pago en 3 plazos (solo en algunos países): permite fraccionar el pago.
Configuración de la pasarela en producción
- Activa la opción Modo producción cuando hayas probado todo en sandbox.
- Elige el tipo de experiencia de pago: redirigir al sitio de PayPal o pago integrado.
- Configura los estados de pedido: por ejemplo, "Pago aceptado" y "Pago pendiente".
[INFO]
El módulo de PayPal oficial se actualiza automáticamente si tienes activadas las notificaciones. Mantén siempre la última versión para evitar problemas de compatibilidad con nuevas versiones de PrestaShop.
Configurar PrestaShop Stripe paso a paso
Stripe es una pasarela moderna, muy flexible y con excelentes herramientas de desarrollo. Su módulo oficial para PrestaShop es muy completo.
Instalación del módulo Stripe
- Descarga el módulo "Stripe" desde el marketplace de PrestaShop o desde stripe.com.
- Súbelo e instálalo como hemos visto.
- Ve a Módulos > Módulos y servicios > Stripe.
Obtener las claves API de Stripe
- Inicia sesión en tu panel de Stripe (dashboard.stripe.com).
- Ve a Desarrolladores > Claves API.
- Copia la Publicable key y la Secreta key. Estas son tus credenciales.
- En PrestaShop, pega ambas claves en los campos correspondientes.
Configuración avanzada del módulo
- Métodos de pago: Stripe permite tarjetas, Apple Pay, Google Pay, y otros métodos según el país.
- Pago en una sola página: activa la opción para que el cliente no salga de tu tienda.
- Captura de fondos: puedes elegir entre captura automática (se cobra al hacer el pedido) o manual (se reserva y capturas tú más tarde).
- Webhooks: es crucial configurar los webhooks para recibir notificaciones de pago. En Stripe, ve a Desarrolladores > Webhooks y añade la URL que te indica el módulo (normalmente algo como
https://tudominio.com/module/stripe/webhook).
Probar Stripe en modo test
- Stripe te da claves de prueba automáticamente. Úsalas para hacer pedidos ficticios con tarjeta
4242 4242 4242 4242. - Verifica que el pedido aparece como "Pagado" en tu PrestaShop.
- Cuando todo funcione, cambia a las claves de producción.
[WARNING]
Si tu tienda usa Syspanel y tienes problemas con los webhooks de Stripe, revisa que el puerto 2106 no esté bloqueado por el firewall. A veces hay que abrir puertos para que las notificaciones lleguen correctamente.
Solución de problemas comunes al instalar pasarelas de pago
Aunque sigas los pasos al pie de la letra, pueden surgir errores. Aquí tienes los más habituales y cómo resolverlos.
Error: "No se pudo conectar con PayPal/Stripe"
- Verifica que las claves API están bien copiadas (sin espacios).
- Comprueba que tu cuenta está verificada.
- Revisa que el SSL está activo en todo el dominio.
- Mira los logs del servidor en Syspanel (puerto 2106) para ver errores de PHP.
Error: "El pago no se confirma"
- Revisa los webhooks en Stripe: deben estar activados y apuntando a la URL correcta.
- En PayPal, comprueba que has marcado la casilla de "Notificación IPN".
- Asegúrate de que la zona horaria de tu servidor es correcta, ya que puede afectar a la validación de transacciones.
El módulo no aparece en el listado
- Puede que tengas una versión de PrestaShop incompatible. Actualiza el módulo o la tienda.
- Desinstala y vuelve a instalar el módulo.
- Limpia la caché de PrestaShop en Parámetros avanzados > Rendimiento.
[TIP]
Si usas una plantilla personalizada, a veces el CSS del botón de pago se rompe. Prueba con la plantilla por defecto para descartar conflictos.
Preguntas frecuentes (FAQ)
¿Cuánto tarda en activarse una pasarela de pago?
- PayPal: la conexión es inmediata si tu cuenta está verificada.
- Stripe: la activación puede tardar entre 1 y 3 días si necesitan revisar tu negocio.
¿Puedo tener PayPal y Stripe a la vez?
Sí, perfectamente. De hecho, es recomendable ofrecer varias opciones de pago para aumentar la conversión. Los módulos no entran en conflicto.
¿Qué comisiones cobran?
- PayPal: suele ser un 2,9% + 0,30€ por transacción (varía según país).
- Stripe: similar, alrededor del 1,4% + 0,25€ para tarjetas europeas.
¿Necesito ser una empresa para usar Stripe?
No necesariamente. Stripe permite operar como autónomo. Solo te pedirán datos fiscales y una cuenta bancaria.
¿Qué hago si mi hosting es muy básico?
- Asegúrate de que el servidor cumple los requisitos mínimos de PHP y memoria.
- Si tu plan es muy limitado, considera cambiar de hosting. Los módulos de pago requieren cierta potencia.
¿Puedo probar sin dinero real?
Sí, ambos módulos tienen modo sandbox. Es obligatorio probarlo antes de lanzar la tienda.
Consejos finales para optimizar tus pasarelas de pago
- Ofrece varios métodos: no te limites a uno. PayPal y Stripe cubren el 90% de las preferencias.
- Activa el pago exprés: en PayPal, el botón "Pagar con PayPal" en el carrito reduce la fricción.
- Configura bien los estados: define claramente qué pasa con el stock cuando un pago está pendiente.
- Monitoriza los logs: revisa semanalmente los registros de errores de pago en tu servidor.
- Mantén todo actualizado: PrestaShop, módulos y PHP. Las versiones antiguas son vulnerables.
[INFO]
Si tu tienda está alojada en un servidor que usa Syspanel, recuerda que puedes programar tareas cron desde el panel (puerto 2106) para que los webhooks y las notificaciones de pago se procesen sin retrasos.
Conclusión
Instalar módulos pago prestashop como PayPal y Stripe no es complicado si sigues una buena guía. Lo más importante es preparar bien el entorno, usar siempre módulos oficiales y probar en modo sandbox antes de lanzarte a producción.
Recuerda: una pasarela de pago bien configurada no solo te permite cobrar, sino que genera confianza en tus clientes. Un proceso de pago fluido reduce el abandono del carrito y aumenta tus ventas.
Ahora ya tienes todo lo necesario para instalar pasarela pago prestashop con éxito. Tómate tu tiempo, sigue cada paso y no dudes en consultar la documentación oficial de cada proveedor si te atascas.
¡Buena suerte con tu tienda online!
