Saltar al contenido principal

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​

ComponenteMínimo
Magento2.4.4 (2.4.0–2.4.3 están en EOL)
PHP8.1
MONEI PHP SDK^2.8.3 (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:

Instalar​

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
  1. Activa el módulo:
bin/magento module:enable Monei_MoneiPayment
  1. 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.

:::tip 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.

Configurar MONEI Adobe Commerce

Introduce tu clave de API. Puedes encontrar tu clave de API en MONEI Dashboard → Settings → API Access. 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 + captura) o Authorize (captura posterior mediante la creación de una factura). La preautorización 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 tokenización 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.

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)

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 — el módulo incluye un fragmento etc/varnish-config.vcl para integrarlo en tu VCL).
  • 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 → Apple Pay.