PrestaShop
Para aceptar pagos a través de MONEI en tu tienda PrestaShop solo necesitas instalar y configurar el módulo MONEI para PrestaShop.
Demo en vivo
Requisitos
El módulo se distribuye en dos líneas de versiones paralelas desde el mismo repositorio. Elige la que corresponda a tu versión principal de PrestaShop — instalar la línea incorrecta falla silenciosamente con el modal genérico de PrestaShop "no hay detalles adicionales".
| Tu PrestaShop | Línea del módulo | PHP | Descarga |
|---|---|---|---|
| 8.0 y superior | v2.x (latest) | ≥ 7.4 | releases/latest/download/monei.zip |
| 1.7.x | v1.7.x (latest) | ≥ 7.4 | Selecciona la última etiqueta 1.7.x en la página de versiones |
Ambas líneas reciben versiones paralelas. El enlace releases/latest siempre apunta al ZIP de v2.x, por lo que los comercios con PrestaShop 1.7 deben seleccionar una etiqueta de versión 1.7.x explícita.
También necesitas:
- Una cuenta MONEI
- La extensión PHP
curlactivada
Antes de empezar
Para probar tu integración:
- Usa tu clave de API del modo de prueba. Puedes encontrarla en MONEI Dashboard → Settings → API Access.
- Puedes comprobar el estado de un pago de prueba en MONEI Dashboard → Payments (en modo de prueba).
Instalar
- Descarga el
monei.zipcorrecto para tu versión de PrestaShop desde la tabla anterior. - Ve al panel de administración de PrestaShop.
- Navega a Modules → Module Manager.
- Haz clic en Upload a module.
- Selecciona el archivo
monei.zipdescargado.
Si la instalación falla con el error genérico "no hay detalles adicionales", lo más probable es que hayas descargado la versión incorrecta para tu versión principal de PrestaShop. Consulta la tabla anterior y descarga la versión correspondiente.
Configurar
Ve a PrestaShop → Payment → Payment Methods → MONEI → Configure
Introduce tu clave de API. Puedes encontrar tu clave de API en MONEI Dashboard → Settings → API Access.
Desde la pantalla de configuración puedes:
- Alternar entre modo test y live (cada modo tiene su propio campo de clave de API).
- Elegir una acción de pago — Sale (autorización + captura) o Authorize (captura posterior desde el panel de administración).
- Activar o desactivar cada método de pago individualmente (Tarjeta, Apple Pay, Google Pay, Bizum, PayPal, Multibanco, MB Way).
- Para cada método, elegir entre un formulario inline en el checkout o una redirección a la página de pago alojada de MONEI.
- Activar la tokenización de tarjeta para que los clientes recurrentes puedan pagar con una tarjeta guardada.
Métodos de pago admitidos
- Tarjeta (Visa, Mastercard y más)
- Apple Pay
- Google Pay
- Bizum (España)
- PayPal
- Multibanco (Portugal)
- MB Way (Portugal)
La preautorización (Authorize + captura posterior) está disponible para Tarjeta, Apple Pay, Google Pay y PayPal. No está disponible para MB Way y Multibanco.
Antes de pasar a producción
- Asegúrate de usar la clave de API del modo en vivo (producción).
- Asegúrate de tener al menos un método de pago activo.
- Verifica que tu URL de webhook sea accesible desde MONEI (sin lista de IPs permitidas, sin bloqueo de bots de Cloudflare).
- Para Apple Pay, registra tu dominio en MONEI Dashboard → Apple Pay.