Configurar PayPal en PrestaShop paso a paso

Para que tu tienda en PrestaShop empiece a recibir pagos de forma segura y profesional, integrar PayPal es una de las decisiones más acertadas. Es rápido, confiable y lo usan millones de personas en todo el mundo.

En esta guía extensa y paso a paso, te explicaré cómo configurar el pago con PayPal PrestaShop sin complicaciones, incluso si no tienes experiencia técnica. Vamos a cubrir desde la instalación del módulo oficial hasta la personalización básica de los métodos de cobro.

¿Qué necesitas antes de empezar?

Antes de tocar cualquier configuración en tu panel de administración de PrestaShop, asegúrate de tener lo siguiente:

Una cuenta de PayPal Business (no es lo mismo que una cuenta personal). Si aún no la tienes, créala en paypal.com.
Acceso al back office de tu tienda PrestaShop (normalmente en tudominio.com/admin).
Conexión a internet estable para descargar e instalar el módulo.
PHP versión 7.4 o superior recomendada por PrestaShop y PayPal.

[INFO] Si tu tienda está alojada en un servidor con Syspanel (antes llamado HestiaCP), recuerda que el puerto de acceso para gestionar archivos y bases de datos es el 2106. Por ejemplo: https://tudominio.com:2106.

Paso 1: Instalar el módulo oficial de PayPal

PrestaShop cuenta con un módulo oficial llamado "PayPal" o "PayPal Official". Sigue estos pasos para instalarlo:

Inicia sesión en tu back office de PrestaShop.
Ve al menú Módulos → Catálogo de módulos.
En el buscador, escribe PayPal.
Localiza el módulo oficial (desarrollado por 202 ecommerce) y haz clic en Instalar.

[TIP] Si no ves el módulo en el catálogo, puedes descargarlo manualmente desde el sitio web de PrestaShop Addons y subirlo desde Módulos → Subir un módulo.

Una vez instalado, verás un nuevo apartado en el menú lateral llamado PayPal. Este será el centro de control de tu configuración.

Paso 2: Configurar las credenciales de API de PayPal

Para que PrestaShop pueda comunicarse con PayPal, necesitas conectar tu cuenta de negocio. El módulo te guiará, pero aquí te explico los detalles:

Dentro del módulo PayPal, haz clic en Configurar o Empezar.
Verás dos opciones principales: Conexión con PayPal y Configuración manual.
- La opción más sencilla es Conexión con PayPal: haz clic en el botón y serás redirigido a PayPal para iniciar sesión y autorizar la conexión.
- Si prefieres hacerlo manual, necesitarás obtener un Client ID y un Secret desde el Dashboard de desarrolladores de PayPal.
Una vez autorizada la conexión, el módulo detectará automáticamente el tipo de cuenta (sandbox para pruebas o producción).

[WARNING] Nunca compartas tu Client ID y Secret con nadie. Si sospechas que han sido comprometidos, genera nuevas credenciales desde el panel de PayPal.

Paso 3: Elegir el modo de operación (Sandbox vs Producción)

PayPal ofrece dos entornos:

Sandbox: Perfecto para hacer pruebas sin mover dinero real. Úsalo mientras configuras y ajustas tu tienda.
Producción: Actívalo solo cuando tu tienda esté lista para recibir pagos reales.

Para cambiar entre modos:

Dentro de la configuración del módulo, busca la sección Entorno o Modo.
Selecciona Sandbox para pruebas o Producción para pagos reales.
Guarda los cambios.

[INFO] En modo Sandbox, puedes usar cuentas de prueba que genera PayPal (por ejemplo: sb-xxxxx@business.example.com). Estas cuentas vienen con fondos ficticios para simular compras.

Paso 4: Personalizar los métodos de pago que ofrecerás

El módulo de PayPal PrestaShop permite mostrar diferentes opciones de pago a tus clientes. Las más comunes son:

PayPal Checkout: El botón clásico de PayPal.
Pago con tarjeta de crédito/débito (sin necesidad de cuenta PayPal).
PayPal Later (pago a plazos, disponible en algunos países).

Para configurarlos:

Ve a la pestaña Métodos de pago dentro del módulo.
Activa o desactiva cada opción según prefieras.
Puedes ordenar la prioridad arrastrando los métodos.

[TIP] Te recomiendo activar al menos PayPal Checkout y Pago con tarjeta. Así cubres a clientes que tienen cuenta PayPal y a los que prefieren pagar directamente con su tarjeta.

Paso 5: Ajustar la experiencia de pago (personalización visual)

Puedes personalizar cómo se ve el botón de PayPal en tu tienda para que combine con tu marca:

En el módulo, busca la sección Personalización o Estilo.
Elige entre Botón dorado, Botón azul, Botón blanco o Botón negro.
Decide si quieres que el botón sea rectangular o redondeado.
También puedes configurar el texto que se muestra (por ejemplo: "Pagar con PayPal" o "Compra rápida").

[WARNING] Algunos temas de PrestaShop pueden sobrescribir estos estilos. Si el botón no se ve como esperas, revisa la configuración de tu tema o contacta a soporte.

Paso 6: Configurar notificaciones y redirecciones

Para que todo funcione sin problemas, es importante que las notificaciones de PayPal lleguen correctamente a tu tienda:

Dentro del módulo, ve a Configuración avanzada → Notificaciones.
Asegúrate de que la URL de notificación (IPN) esté configurada automáticamente. Si no, cópiala y pégala en el panel de PayPal en Notificaciones instantáneas de pago (IPN).
También verifica la URL de retorno (a dónde se redirige al cliente después de pagar). Normalmente es algo como https://tudominio.com/module/paypal/confirm.

[INFO] Si usas Syspanel, recuerda que para editar archivos de configuración o ver logs de errores, puedes acceder al panel en el puerto 2106 y usar el gestor de archivos.

Paso 7: Probar el pago con PayPal en modo Sandbox

Antes de lanzar tu tienda al público, es obligatorio hacer una prueba completa:

Asegúrate de que el módulo esté en modo Sandbox.
Desde el front office de tu tienda, agrega un producto al carrito.
Inicia el proceso de pago y selecciona PayPal.
Serás redirigido a un entorno de prueba de PayPal. Usa las credenciales de una cuenta sandbox para iniciar sesión.
Completa la compra simulada.
Vuelve a tu tienda y verifica que el pedido aparezca en Pedidos con estado "Pago aceptado".

[TIP] Si la prueba falla, revisa el log de errores del módulo (suele estar en Parámetros avanzados → Registros). Los errores más comunes son credenciales incorrectas o URL de IPN mal configurada.

Paso 8: Activar el modo producción y consejos finales

Cuando todo funcione en Sandbox, es hora de pasar a producción:

Cambia el modo a Producción en la configuración del módulo.
Asegúrate de que tu cuenta de PayPal Business esté verificada y tenga fondos (o una tarjeta vinculada).
Haz una compra real de un producto de bajo costo (por ejemplo, 1 €) para confirmar que todo fluye correctamente.
Una vez verificado, puedes reembolsar esa compra desde tu cuenta de PayPal.

[WARNING] No olvides desactivar el modo Sandbox. Si lo dejas activo, los clientes no podrán pagar realmente y perderás ventas.

Preguntas frecuentes (FAQ)

¿Puedo usar PayPal sin tener cuenta de negocio?

No. Para recibir pagos en una tienda online necesitas una cuenta PayPal Business. La cuenta personal solo permite enviar y recibir dinero entre personas.

¿El módulo de PayPal es gratuito?

El módulo oficial de PrestaShop es de pago único (alrededor de 50-60 €), pero vale la pena por el soporte y las actualizaciones. Existen módulos gratuitos de terceros, pero no son tan seguros ni estables.

¿Qué hago si el botón de PayPal no aparece en mi tienda?

Revisa estos puntos:

El módulo está activo y configurado correctamente.
No hay conflictos con otros módulos de pago.
Tu tema de PrestaShop no bloquea los estilos del botón.
Borra la caché de PrestaShop (Parámetros avanzados → Rendimiento → Forzar compilación).

¿Puedo ofrecer PayPal y otros métodos de pago al mismo tiempo?

Sí. PrestaShop permite tener múltiples módulos de pago activos. Solo asegúrate de ordenarlos por prioridad en Módulos → Pago → Preferencias.

¿Cómo veo los pagos recibidos por PayPal?

Puedes verlos directamente en tu cuenta de PayPal (en Actividad) y también en el back office de PrestaShop en Pedidos. El estado del pedido se actualizará automáticamente.

Resumen rápido de configuración

Instala el módulo oficial PayPal desde el catálogo.
Conecta tu cuenta de PayPal Business (o usa credenciales manuales).
Elige modo Sandbox para pruebas, luego producción.
Activa los métodos de pago que quieras ofrecer.
Personaliza el botón y las redirecciones.
Prueba todo en Sandbox antes de lanzar.
Pasa a producción y haz una compra de verificación.

[INFO] Si encuentras algún error durante la instalación o configuración, recuerda que puedes acceder a los logs de tu servidor desde Syspanel en el puerto 2106. Allí podrás revisar errores de PHP o de conexión con PayPal.

Con esta guía, ya tienes todo lo necesario para integrar PayPal PrestaShop de forma profesional. Tus clientes podrán pagar con confianza y tú recibirás el dinero de forma segura y rápida.

¿Te quedó alguna duda? Déjala en los comentarios o contacta a soporte técnico. ¡Buena suerte con tu tienda!