Adobe Commerce (Magento 2)

MONEI Payments para Adobe Commerce (Magento 2) te permite integrar de forma sencilla las capacidades de procesamiento de pagos de MONEI en tu tienda Magento. Este módulo oficial proporciona una experiencia de pago segura, fiable y fácil de usar para tus clientes.

Demo en vivo

Requisitos

Componente	Mínimo
Magento	2.4.4 (2.4.0–2.4.3 están en EOL)
PHP	8.1
MONEI PHP SDK	^2.6 (instalado automáticamente vía Composer)

También necesitas una cuenta MONEI.

El módulo está publicado en el Magento Marketplace y en Packagist.

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

Usando composer (recomendado)

Ve al directorio raíz de tu Adobe Commerce (Magento 2) y ejecuta los siguientes comandos:

1. Añade el paquete a tu instalación de Magento:

composer require monei/module-monei-payment

2. Activa el módulo:

bin/magento module:enable Monei_MoneiPayment

3. Ejecuta los siguientes comandos para actualizar y compilar el módulo:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:clean

El MONEI PHP SDK es instalado como dependencia transitiva por Composer.

Desde el paquete zip

Ve al directorio raíz de tu Adobe Commerce (Magento 2).

1. Descarga la última versión desde el repositorio de GitHub
2. Extrae el contenido en tu directorio app/code/Monei/MoneiPayment
3. Instala el MONEI PHP SDK:

composer require monei/monei-php-sdk:^2.6

4. Ve al directorio raíz de tu Adobe Commerce (Magento 2) y ejecuta:

bin/magento module:enable Monei_MoneiPayment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:clean

Stacks de Bitnami

En imágenes Bitnami de Magento, usa bin/magento-cli (en lugar de bin/magento) y precede cada comando con sudo; de lo contrario, los comandos fallan con errores de permisos.

Configurar

Para configurar la extensión, ve a Stores → Configuration → Sales → Payment Methods → MONEI.

Introduce tu clave de API. Puedes encontrar tu clave de API en MONEI Dashboard → Configuración → Acceso a API. Establece el Mode en Test o Production para elegir qué par de clave de API + Account ID se utiliza.

Desde la pantalla de configuración puedes:

• Establecer la Payment Action en Sale (autorización + ) o Authorize (captura posterior mediante la creación de una factura). La no está disponible para MB Way ni Multibanco y se reduce silenciosamente a captura para esos métodos.
• Activar o desactivar cada método de pago individualmente (Tarjeta, Card Vault, Bizum, Apple Pay / Google Pay, PayPal, Multibanco, MB Way y el método de redirección genérico).
• Activar la de tarjeta para que los clientes recurrentes puedan pagar con una tarjeta guardada a través de Magento Vault.

Para más información sobre cómo configurar la extensión, consulta la documentación de la extensión MONEI para Adobe Commerce.

Diseño de los campos de tarjeta

En MONEI Card Insite, Card Field Layout decide el aspecto del formulario de tarjeta.

Separate fields (por defecto) — el número, la caducidad y el CVC tienen cada uno su propio campo, con el mismo estilo que los campos del tema. El foco pasa del número a la caducidad y al CVC a medida que el cliente escribe.

Single field — los tres comparten un solo campo, lo que encaja en un checkout compacto.

Json style aplica el tema a ambos diseños desde el mismo JSON, así que cambiar de diseño mantiene tu estilo.

Los campos separados son el valor por defecto desde la v2.3.0

Hasta la v2.2.4 el formulario de tarjeta era un solo campo. Si nunca elegiste un diseño, tu checkout pasa a campos separados al actualizar — elige Single field en MONEI Card Insite para mantener el formulario anterior. Si ya habías elegido un diseño, se conserva.

Elijas el que elijas, los datos de la tarjeta van directos a MONEI y tu alcance de PCI DSS se mantiene en SAQ A.

Métodos de pago admitidos

• Tarjeta (Visa, Mastercard y más) — con tokenización de Magento Vault para tarjetas guardadas
• Apple Pay (el registro de dominio se realiza automáticamente al activar el método)
• Google Pay
• Bizum (España — se oculta automáticamente para clientes no españoles)
• PayPal
• Multibanco (Portugal — solo redirección, sin preautorización)
• MB Way (Portugal — solo redirección, sin preautorización)

Express checkout

Express checkout coloca botones de Apple Pay, Google Pay y PayPal en la página del carrito, en el minicarrito y en la página de producto. 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. Los métodos de envío y el total de la hoja son los de tu tienda: el módulo los recalcula para la dirección que elige el cliente.

Requiere el módulo v2.4.0

Express checkout en las tres superficies está disponible a partir de la versión 2.4.0 del módulo. Las versiones 2.3.x traían una forma anterior en el carrito, el minicarrito y la página de checkout.

Para activarlo, ve a Stores → Configuration → Sales → Payment Methods → MONEI → Express Checkout y configura:

Ajuste	Qué hace
Enable Express Checkout	Activa los botones. Desactivado por defecto.
Show on Product Page	Botón debajo de Add to Cart.
Show on Cart Page	Botones debajo de Proceed to Checkout en el resumen del carrito.
Show in Mini Cart	Botones debajo de Proceed to Checkout en el minicarrito.
PayPal Express Checkout	Añade el botón de PayPal junto al botón de la wallet. Necesita el método de pago PayPal activado. Activado por defecto.
Json style	Aplica el tema a los botones en JSON — por ejemplo {"height":"45px"}.

Se aplican las mismas condiciones que a los métodos de pago normales. 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. Un pedido con wallet aparece en Sales → Orders con el método de pago express; un pedido con PayPal express, con el método PayPal.

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

Antes de pasar a producción

• Cambia el Mode a Production y confirma que la clave de API de producción + Account ID están introducidos.
• 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, sin que Varnish cachee la ruta de callback).
• Confirma que cron está en ejecución (bin/magento cron:status) — el trabajo por horas es la red de seguridad para los webhooks perdidos.
• Para Apple Pay, verifica que tu dominio aparece en MONEI Dashboard → Configuración → Métodos de pago.