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.x (latest)	≥ 7.4	Selecciona la última etiqueta 1.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.x explícita.

También necesitas:

• Una cuenta MONEI
• La extensión PHP curl activada

Antes de empezar

Para probar tu integración:

• Usa tu clave de API del modo de prueba. Puedes encontrarla en MONEI Dashboard → Configuración → Acceso a API.
• Puedes comprobar el estado de un pago de prueba en MONEI Dashboard → Payments (en modo de prueba).

Instalar

1. Descarga el monei.zip correcto para tu versión de PrestaShop desde la tabla anterior.
2. Ve al panel de administración de PrestaShop.
3. Navega a Modules → Module Manager.
4. Haz clic en Upload a module.
5. Selecciona el archivo monei.zip descargado.

tip

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 → Configuración → Acceso a API.

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 + ) 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 de tarjeta para que los clientes recurrentes puedan pagar con una tarjeta guardada.

Diseño de los campos de tarjeta

En Card field layout, elige cómo se ve el formulario de tarjeta.

Single line (por defecto) — el número, la caducidad y el CVC comparten un solo campo, lo que encaja en un checkout compacto.

Split fields — el número, la caducidad y el CVC tienen cada uno su propio campo. El foco pasa del número a la caducidad y al CVC a medida que el cliente escribe.

Ambos diseños heredan el estilo de los campos de tu propia plantilla, así que la tarjeta encaja con el resto de tu checkout tanto en la plantilla classic como en hummingbird. Los datos de la tarjeta van directos a MONEI en cualquiera de los dos, así que tu alcance de PCI DSS se mantiene en SAQ A.

Tarjetas guardadas

Activa la tokenización de tarjetas para que un cliente pueda reutilizar una tarjeta. En el checkout verá Save Card details for future payments, y cualquier tarjeta que haya guardado aparecerá la próxima vez que pague. Los datos de la tarjeta se almacenan en los servidores de MONEI, nunca en tu base de datos de PrestaShop.

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 (Authorize + captura posterior) está disponible para Tarjeta, Apple Pay, Google Pay y PayPal. No está disponible para MB Way y Multibanco.

Express checkout

Express checkout coloca un botón de Apple Pay, Google Pay o PayPal en tus páginas de producto y de carrito. El cliente paga desde la hoja de la wallet, y la dirección de envío y facturación viene de la wallet, así que nadie rellena el formulario de checkout.

Para activarlo, abre MONEI → Configure → Express Checkout y ajusta:

Ajuste	Qué hace
Enable Express Checkout	Activa los botones. Desactivado por defecto.
Show on	Dónde aparecen los botones: Product page, Cart page.

No se muestra en el paso de pago del checkout: para entonces el comprador ya ha introducido su email, dirección y transportista, así que un botón de wallet ahí solo duplicaría los métodos de pago habituales de Apple Pay, Google Pay y PayPal.

Se aplican las mismas condiciones que al método de pago normal. Apple Pay necesita tu dominio registrado, y el botón de Apple Pay o Google Pay solo aparece para un cliente cuyo dispositivo y navegador puedan pagar con esa wallet. PayPal necesita una cuenta de empresa de PayPal conectada.

Para el equivalente en una integración personalizada, consulta Express checkout.

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 → Configuración → Métodos de pago.