Configuración de módulos de pago en PrestaShop en DirectAdmin

Configurar los módulos de pago en tu tienda PrestaShop es uno de los pasos más importantes para empezar a vender online. Sin una pasarela de pago bien configurada, tus clientes no podrán completar sus compras, y eso se traduce en pérdida de ventas.

Si tu tienda está alojada en un panel de control como DirectAdmin, el proceso puede ser muy sencillo si sigues los pasos adecuados. En esta guía extensa, te explicaré todo lo que necesitas saber para instalar, configurar y solucionar problemas comunes con los módulos de pago en PrestaShop usando DirectAdmin.

Vamos a ir paso a paso, desde los requisitos previos hasta las configuraciones más avanzadas, para que incluso si no tienes experiencia técnica, puedas hacerlo sin problemas.

¿Qué necesitas antes de empezar?

Antes de tocar cualquier configuración, asegúrate de tener lo siguiente a mano:

Acceso a DirectAdmin: Necesitas tu usuario y contraseña para ingresar al panel de control de tu hosting.
Acceso al Back Office de PrestaShop: Las credenciales de administrador de tu tienda.
Credenciales de la pasarela de pago: Por ejemplo, las claves API de Stripe, PayPal, Redsys, etc. Estas las obtienes al registrarte en el servicio.
PHP configurado correctamente: Muchos módulos requieren extensiones específicas como cURL, JSON o OpenSSL. DirectAdmin suele tenerlas activadas por defecto, pero conviene verificarlo.

[INFO] Si no sabes si tu hosting soporta las extensiones necesarias, puedes revisarlo desde el Back Office de PrestaShop: ve a Parámetros Avanzados > Información y busca la sección de configuración del servidor.

Paso 1: Accede a DirectAdmin y localiza tu tienda

DirectAdmin organiza los sitios web en cuentas de usuario. Cada cuenta puede tener varios dominios y subdominios.

Ingresa a DirectAdmin con tus credenciales.
Busca la sección Administrador de archivos o File Manager. Es donde podrás ver todos los archivos de tu hosting.
Navega hasta la carpeta donde está instalado PrestaShop. Normalmente se encuentra en /domains/tudominio.com/public_html/ o en /home/usuario/domains/tudominio.com/public_html/.

[WARNING] No modifiques archivos del core de PrestaShop si no sabes lo que haces. Siempre es mejor trabajar con módulos oficiales o de confianza.

Paso 2: Instala el módulo de pago desde el Back Office

La forma más segura y recomendada de instalar un módulo de pago es desde el propio PrestaShop.

Inicia sesión en tu Back Office de PrestaShop.
Ve al menú Módulos > Gestor de módulos.
En la barra de búsqueda, escribe el nombre del módulo que deseas instalar (por ejemplo, "PayPal", "Stripe", "Redsys").
Haz clic en Instalar en el módulo correspondiente. PrestaShop descargará e instalará el módulo automáticamente.

Si el módulo no aparece en el catálogo oficial, puedes subirlo manualmente:

Descarga el archivo .zip del módulo desde la web del desarrollador.
En el Gestor de módulos, haz clic en Subir un módulo.
Selecciona el archivo .zip desde tu ordenador y súbelo. DirectAdmin y PrestaShop se encargarán del resto.

[TIP] Siempre elige módulos oficiales o de desarrolladores reconocidos. Los módulos gratuitos de fuentes desconocidas pueden contener código malicioso o ser incompatibles con tu versión de PrestaShop.

Paso 3: Configura los parámetros básicos del módulo

Una vez instalado, toca configurarlo. Cada módulo tiene su propia interfaz, pero los pasos generales son muy similares.

Ve a Módulos > Gestor de módulos y busca el módulo que acabas de instalar.
Haz clic en Configurar.
Se abrirá una página con campos para ingresar tus credenciales de la pasarela de pago.

Los campos más comunes son:

Modo de operación: Selecciona "Producción" o "Live" cuando estés listo para vender. Durante las pruebas, usa "Sandbox" o "Pruebas".
Clave pública / API Key: Cópiala desde tu cuenta en la pasarela de pago.
Clave secreta / Secret Key: Ídem.
Moneda predeterminada: Asegúrate de que coincida con la moneda de tu tienda.

[WARNING] Nunca compartas tus claves secretas. Si alguien las obtiene, podría realizar cargos no autorizados. Guárdalas en un lugar seguro.

Paso 4: Configuración avanzada desde DirectAdmin (si es necesario)

A veces, los módulos de pago requieren modificar archivos de configuración del servidor o habilitar extensiones PHP. Con DirectAdmin puedes hacerlo fácilmente.

Habilitar extensiones PHP

En DirectAdmin, busca la sección PHP Selector o Select PHP Version.
Selecciona la versión de PHP que usa tu PrestaShop (generalmente 7.4 u 8.0+).
Marca las extensiones que necesita el módulo: curl, json, openssl, mbstring, gd, etc.
Guarda los cambios.

Modificar archivos de configuración

Si el módulo te pide que añadas una línea de código en un archivo específico (por ejemplo, en .htaccess o config/defines.inc.php), puedes hacerlo desde el Administrador de archivos de DirectAdmin.

Navega hasta la carpeta de tu tienda.
Busca el archivo indicado y haz clic derecho > Editar.
Añade la línea de código al final del archivo (o donde te indique la documentación del módulo).
Guarda los cambios.

[INFO] Si no estás seguro de qué archivo modificar, consulta la documentación oficial del módulo. Forzar cambios sin saber puede romper tu tienda.

Paso 5: Prueba el módulo en un entorno de pruebas

Antes de poner en producción tu pasarela de pago, es fundamental hacer pruebas.

En la configuración del módulo, selecciona el modo Sandbox o Pruebas.
Ve a tu tienda como si fueras un cliente y realiza una compra de prueba.
Usa tarjetas de prueba proporcionadas por la pasarela (por ejemplo, para Stripe usa 4242 4242 4242 4242).
Verifica que el pago se procesa correctamente y que el pedido aparece en tu Back Office.

Si todo funciona, cambia el modo a Producción y ya estás listo para vender.

[TIP] Si el pago falla en pruebas, revisa los logs de error en Parámetros Avanzados > Registros o en el propio módulo. Allí encontrarás pistas sobre qué falla.

Solución de problemas comunes

Aquí tienes algunas situaciones típicas y cómo resolverlas.

El módulo no se instala o da error de compatibilidad

Causa: Tu versión de PrestaShop es demasiado antigua o demasiado nueva para el módulo.
Solución: Actualiza PrestaShop a la última versión estable o busca un módulo compatible con tu versión.

El pago se rechaza sin motivo aparente

Causa: Problemas con las claves API, el modo de prueba está activado en producción, o la pasarela bloquea tu IP.
Solución: Verifica las claves, asegúrate de estar en modo producción, y contacta al soporte de la pasarela.

Error de conexión SSL

Causa: Tu tienda no tiene un certificado SSL válido o está mal configurado.
Solución: Instala un certificado SSL desde DirectAdmin (sección SSL Certificates) y asegúrate de que todas las páginas de pago usen HTTPS.

[WARNING] Sin SSL, muchos módulos de pago no funcionarán y los navegadores mostrarán advertencias de seguridad a tus clientes.

Preguntas frecuentes (FAQ)

¿Puedo instalar un módulo de pago manualmente si no aparece en el catálogo de PrestaShop?
Sí, siempre que el módulo esté en formato .zip y sea compatible con tu versión. Súbelo desde el Gestor de módulos.

¿Qué hago si el módulo requiere modificar el archivo .htaccess?
Usa el Administrador de archivos de DirectAdmin para editar el archivo. Añade las líneas necesarias al final, pero ten cuidado de no sobrescribir reglas existentes.

¿Cómo sé si mi hosting soporta las extensiones PHP que necesita el módulo?
En DirectAdmin, usa el PHP Selector para ver las extensiones disponibles. También puedes crear un archivo info.php con <?php phpinfo(); ?> y ejecutarlo desde el navegador.

¿Puedo usar varios módulos de pago a la vez?
Sí, PrestaShop permite tener múltiples módulos activos. Solo asegúrate de que no entren en conflicto y de que cada uno esté correctamente configurado.

¿Qué hago si el módulo de pago no aparece en el Front Office?
Revisa que el módulo esté activo y que esté asignado a las zonas geográficas y grupos de clientes correspondientes. Ve a Módulos > Gestor de módulos y haz clic en Configurar para ver las restricciones.

Consejos finales para una configuración exitosa

Mantén todo actualizado: Tanto PrestaShop como los módulos de pago reciben actualizaciones de seguridad y compatibilidad. No las ignores.
Haz copias de seguridad: Antes de instalar o configurar un módulo, respalda tu base de datos y archivos. DirectAdmin tiene una herramienta en Gestión de copias de seguridad.
Prueba todo en un entorno de pruebas: Nunca configures un módulo de pago directamente en producción sin antes verificar que funciona en modo sandbox.
Lee la documentación del módulo: Cada pasarela tiene sus particularidades. Dedica unos minutos a leer la guía oficial.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar, pero accederás al panel por el puerto 2106. La estructura de archivos es la misma.

Conclusión

Configurar módulos de pago en PrestaShop usando DirectAdmin no tiene por qué ser complicado. Siguiendo estos pasos, podrás tener tu tienda lista para aceptar pagos en menos de una hora.

Recuerda que la clave está en:

Instalar el módulo desde el Back Office o subirlo manualmente.
Configurar las credenciales correctas.
Ajustar las extensiones PHP desde DirectAdmin si es necesario.
Probar en modo sandbox antes de lanzarte.

Si encuentras algún problema, no dudes en consultar la documentación oficial de tu pasarela de pago o contactar con el soporte técnico de tu hosting. Con un poco de paciencia, tu tienda estará lista para recibir pedidos de clientes de todo el mundo.

¡Buena suerte con tu tienda PrestaShop!