# 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](https://magento2-demo.monei.com/)

## Requisitos[​](#requisitos "Enlace directo al 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.8.3 (instalado automáticamente vía Composer) |

También necesitas una [cuenta MONEI](https://dashboard.monei.com/signup).

El módulo está publicado en el [Magento Marketplace](https://marketplace.magento.com/monei-module-monei-payment.html) y en [Packagist](https://packagist.org/packages/monei/module-monei-payment).

## Antes de empezar[​](#antes-de-empezar "Enlace directo al Antes de empezar")

Para probar tu integración:

* Usa tu clave de API del [modo de prueba](https://docs.monei.com/es/es/testing/.md). Puedes encontrarla en [MONEI Dashboard → Settings → API Access](https://dashboard.monei.com/settings/api).
* Puedes comprobar el estado de un pago de prueba en [MONEI Dashboard → Payments](https://dashboard.monei.com/payments) (en modo de prueba).

## Instalar[​](#instalar "Enlace directo al Instalar")

<!-- -->

* Usando composer (recomendado)
* Desde el paquete zip

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.

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

1. Descarga la última versión desde el [repositorio de GitHub](https://github.com/MONEI/MONEI-AdobeCommerce-Magento2/releases)
2. Extrae el contenido en tu directorio `app/code/Monei/MoneiPayment`
3. Instala el MONEI PHP SDK:

```
composer require monei/monei-php-sdk:^2.8.3
```

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
```

Alternativamente, puedes usar este comando en una línea para descargar y extraer la última versión:

```
curl -L https://github.com/MONEI/MONEI-AdobeCommerce-Magento2/releases/latest/download/monei-module-monei-payment.zip -o monei.zip && \

mkdir -p app/code/Monei/MoneiPayment && \

unzip monei.zip -d app/code/Monei/MoneiPayment && \

rm monei.zip
```

:::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[​](#configurar "Enlace directo al Configurar")

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

![Configurar MONEI Adobe Commerce](/es/assets/images/configure-magento-0-b412ddb6188c101361e865f26d8e0a75.png)

Introduce tu clave de API. Puedes encontrar tu clave de API en [MONEI Dashboard → Settings → API Access](https://dashboard.monei.com/settings/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 + 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](https://github.com/MONEI/MONEI-AdobeCommerce-Magento2/blob/main/README.md).

## Métodos de pago admitidos[​](#métodos-de-pago-admitidos "Enlace directo al 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[​](#antes-de-pasar-a-producción "Enlace directo al 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](https://dashboard.monei.com/settings/payment-methods) 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](https://dashboard.monei.com/settings/apple-pay).