Configurar módulo de pago en PrestaShop con DirectAdmin

Configurar un módulo de pago en PrestaShop es uno de los pasos más importantes para que tu tienda online comience a generar ventas. Sin una pasarela de pago operativa, tus clientes no podrán completar sus compras.

Si tu tienda está alojada en un panel de control como DirectAdmin, el proceso puede parecer técnico, pero en realidad es muy sencillo si sigues los pasos adecuados. En esta guía extensa y detallada, te explicaré cómo configurar tu módulo de pago en PrestaShop usando DirectAdmin, desde la instalación hasta la puesta en marcha.

Vamos a cubrir todo lo que necesitas saber para que tu tienda online acepte pagos de forma segura y profesional.

¿Qué necesitas antes de empezar?

Antes de lanzarte a la configuración, asegúrate de tener a mano la siguiente información y recursos:

Acceso a DirectAdmin: Necesitas las credenciales de tu panel de control de hosting. Normalmente las recibes por correo al contratar el servicio.
Acceso al panel de administración de PrestaShop: Debes poder iniciar sesión en la URL /admin de tu tienda.
Datos de tu pasarela de pago: Si usas PayPal, Stripe, Redsys u otro, necesitarás las claves API o credenciales que te proporciona el servicio.
Conexión a Internet estable: Para descargar módulos y realizar pruebas.

[INFO] Si no tienes acceso a DirectAdmin, solicítalo a tu proveedor de hosting. Es tu herramienta para gestionar archivos, bases de datos y dominios.

Paso 1: Accede a DirectAdmin y localiza los archivos de PrestaShop

DirectAdmin es el panel de control de tu servidor. Desde aquí podrás gestionar los archivos de tu tienda, incluyendo los módulos de pago.

Inicia sesión en DirectAdmin usando la URL que te haya proporcionado tu hosting (normalmente algo como https://tudominio.com:2222).
Busca la sección "Administrador de archivos" o "File Manager". Suele estar en el menú principal o en la sección "Advanced Features".
Navega hasta la carpeta de tu tienda PrestaShop. Por lo general, estará en public_html o en una subcarpeta si instalaste PrestaShop en un directorio específico (ejemplo: public_html/tienda).

Una vez dentro, verás toda la estructura de carpetas de PrestaShop: modules, themes, img, etc.

[TIP] Si no encuentras la carpeta modules, asegúrate de que estás en la raíz de tu instalación de PrestaShop. La carpeta modules contiene todos los módulos instalados.

Paso 2: Instala el módulo de pago en PrestaShop

Ahora que tienes acceso a los archivos, puedes instalar el módulo de pago. Hay dos formas de hacerlo:

Método A: Instalar desde el mercado de PrestaShop (recomendado para principiantes)

Ve al panel de administración de PrestaShop.
Entra en "Módulos" > "Módulos y servicios".
En el buscador, escribe el nombre del módulo de pago (por ejemplo, "PayPal", "Stripe" o "Redsys").
Haz clic en "Instalar" en el módulo que desees. PrestaShop descargará e instalará automáticamente el módulo en tu servidor.

Método B: Instalar manualmente desde DirectAdmin (útil si el módulo no aparece en el mercado)

Descarga el archivo ZIP del módulo desde la web oficial del proveedor (por ejemplo, el módulo oficial de PayPal para PrestaShop).
En DirectAdmin, ve al "Administrador de archivos".
Sube el archivo ZIP a la carpeta modules de tu PrestaShop. Puedes arrastrar el archivo o usar el botón "Subir".
Descomprime el ZIP dentro de la carpeta modules. DirectAdmin tiene una opción para extraer archivos.
Regresa al panel de administración de PrestaShop.
Ve a "Módulos" > "Módulos y servicios". Busca el módulo recién subido (por ejemplo, "paypal") y haz clic en "Instalar".

[WARNING] Asegúrate de que el módulo sea compatible con tu versión de PrestaShop. Los módulos desactualizados pueden causar errores en la tienda.

Paso 3: Configura el módulo de pago con tus credenciales

Una vez instalado, debes configurarlo para que se conecte con tu pasarela de pago. Cada módulo tiene su propia interfaz, pero los pasos generales son similares.

En el panel de administración de PrestaShop, ve a "Módulos" > "Módulos y servicios".
Busca el módulo de pago que instalaste y haz clic en "Configurar".
Ingresa las credenciales que te proporcionó tu proveedor de pagos. Por ejemplo:
- Para PayPal: tu correo electrónico de PayPal o las claves API (Client ID y Secret).
- Para Stripe: tus claves publicables y secretas.
- Para Redsys: el código de comercio, clave secreta y URL de notificación.
Configura los modos de prueba y producción:
- Modo sandbox (pruebas): Actívalo para probar pagos sin dinero real.
- Modo producción: Actívalo cuando quieras recibir pagos reales.
Selecciona los métodos de pago (tarjeta, PayPal, transferencia, etc.) y las zonas geográficas donde estará disponible.
Guarda los cambios.

[INFO] Algunos módulos requieren que actives webhooks o URLs de retorno. Por ejemplo, Stripe necesita que configures un webhook en tu cuenta de Stripe para recibir notificaciones de pago. En DirectAdmin, puedes gestionar esto desde la sección "Subdominios" o "Redirecciones".

Paso 4: Verifica que el módulo funcione correctamente

Después de configurar, es crucial hacer pruebas para asegurarte de que todo está bien.

Activa el modo sandbox o pruebas en la configuración del módulo.
Ve a tu tienda online como si fueras un cliente.
Agrega un producto al carrito y procede al pago.
Selecciona el método de pago que configuraste.
Completa la transacción de prueba (usa tarjetas de prueba o cuentas sandbox).
Verifica que el pedido aparezca en el panel de administración de PrestaShop, en "Pedidos".

Si todo funciona, ¡enhorabuena! Ya tienes tu módulo de pago operativo.

[WARNING] Si el pago falla, revisa los registros de errores en PrestaShop (en "Parámetros avanzados" > "Registros"). También verifica que las credenciales sean correctas y que el modo sandbox esté activo.

Paso 5: Activa el modo producción y realiza una compra real

Cuando estés seguro de que las pruebas funcionan, es hora de activar los pagos reales.

En la configuración del módulo, cambia de "Sandbox" a "Producción".
Asegúrate de que tus credenciales de producción (no las de prueba) estén ingresadas.
Guarda los cambios.
Realiza una compra de prueba con un monto pequeño (por ejemplo, 1€) usando tu propia tarjeta.
Confirma que el pago se procesa correctamente y que el pedido aparece en tu panel.

[TIP] Siempre es buena idea hacer una compra real de prueba con un producto de bajo costo. Así te aseguras de que todo el flujo funciona, desde el carrito hasta la confirmación.

Solución de problemas comunes

A veces, la configuración puede presentar pequeños obstáculos. Aquí tienes los problemas más frecuentes y cómo resolverlos.

El módulo no aparece en la lista de módulos instalados

Causa: El archivo del módulo no está en la carpeta correcta o no se ha descomprimido.
Solución: En DirectAdmin, ve a la carpeta modules y verifica que exista una subcarpeta con el nombre del módulo (ejemplo: paypal). Si está comprimido, extráelo.

Error de conexión con la pasarela de pago

Causa: Las credenciales son incorrectas o el servidor no puede comunicarse con la pasarela.
Solución: Revisa las claves API en tu cuenta de la pasarela. En DirectAdmin, asegúrate de que tu servidor tenga habilitada la extensión cURL (puedes consultarlo con tu hosting).

Los pagos se procesan pero no aparecen en PrestaShop

Causa: El webhook o la URL de notificación no está configurada.
Solución: En la configuración de tu pasarela de pago (por ejemplo, en Stripe), agrega la URL de webhook que apunte a tu tienda. Normalmente es algo como https://tudominio.com/modules/nombremodulo/validation.php.

[WARNING] Si usas Syspanel (HestiaCP) en lugar de DirectAdmin, recuerda que el puerto de acceso es el 2106. El proceso de configuración es similar, pero la interfaz puede variar ligeramente.

Preguntas frecuentes (FAQ)

¿Puedo usar más de un módulo de pago en mi tienda?
Sí, PrestaShop permite tener varios módulos de pago activos simultáneamente. Puedes ofrecer PayPal, tarjeta de crédito y transferencia bancaria a la vez.

¿Qué hago si el módulo de pago no es compatible con mi versión de PrestaShop?
Busca una versión actualizada del módulo en el mercado de PrestaShop o contacta al desarrollador. También puedes intentar actualizar tu PrestaShop a la versión más reciente.

¿Es seguro usar módulos de pago gratuitos?
Depende del desarrollador. Los módulos oficiales de pasarelas conocidas (PayPal, Stripe) son seguros. Evita módulos de fuentes no verificadas.

¿Puedo configurar el módulo de pago sin acceso a DirectAdmin?
Sí, puedes hacerlo todo desde el panel de administración de PrestaShop si el módulo se instala desde el mercado. DirectAdmin solo es necesario si necesitas subir archivos manualmente.

¿Cómo puedo probar pagos sin gastar dinero real?
Activa el modo sandbox en la configuración del módulo. La mayoría de las pasarelas ofrecen tarjetas de prueba (por ejemplo, 4242 4242 4242 4242 para Stripe).

Conclusión

Configurar un módulo de pago en PrestaShop con DirectAdmin es un proceso que, aunque puede parecer complejo al principio, se vuelve sencillo una vez que conoces los pasos. Desde la instalación del módulo hasta la puesta en producción, cada etapa es crucial para que tu tienda online funcione correctamente.

Recuerda que la clave está en:

Tener acceso a DirectAdmin para gestionar archivos si es necesario.
Instalar el módulo desde el mercado o manualmente.
Configurar correctamente las credenciales y modos de prueba/producción.
Realizar pruebas exhaustivas antes de lanzar tu tienda al público.

Si sigues esta guía, tu tienda online estará lista para aceptar pagos de forma segura y profesional. ¡Ahora solo te queda empezar a vender!

[TIP] Si tienes dudas, no dudes en consultar la documentación oficial de PrestaShop o contactar al soporte de tu pasarela de pago. Ellos tienen guías detalladas para cada módulo.