# Adobe Commerce (Magento 2)

MONEI Payments for Adobe Commerce (Magento 2) allows you to seamlessly integrate MONEI's payment processing capabilities into your Magento store. This official module provides a secure, reliable, and user-friendly payment experience for your customers.

[Live demo](https://magento2-demo.monei.com/)

## Requirements[​](#requirements "Direct link to Requirements")

| Component     | Minimum                                       |
| ------------- | --------------------------------------------- |
| Magento       | 2.4.4 (2.4.0–2.4.3 are EOL)                   |
| PHP           | 8.1                                           |
| MONEI PHP SDK | ^2.8.3 (installed automatically via Composer) |

You also need a [MONEI account](https://dashboard.monei.com/signup).

The module is published on the [Magento Marketplace](https://marketplace.magento.com/monei-module-monei-payment.html) and on [Packagist](https://packagist.org/packages/monei/module-monei-payment).

## Before you begin[​](#before-you-begin "Direct link to Before you begin")

To test your integration:

* Use your [test mode](https://docs.monei.com/testing/.md) API Key. You can find it in [MONEI Dashboard → Settings → API Access](https://dashboard.monei.com/settings/api).
* You can check the status of a test payment in your [MONEI Dashboard → Payments](https://dashboard.monei.com/payments) (in test mode).

## Install[​](#install "Direct link to Install")

<!-- -->

* Using composer (recommended)
* From the raw package

Go to your Adobe Commerce (Magento 2) root directory and run the following commands:

1. Add the package to your Magento installation:

```
composer require monei/module-monei-payment
```

2. Enable the module:

```
bin/magento module:enable Monei_MoneiPayment
```

3. Run the following commands to upgrade and compile the module:

```
bin/magento setup:upgrade

bin/magento setup:di:compile

bin/magento setup:static-content:deploy

bin/magento cache:clean
```

The MONEI PHP SDK is pulled in transitively by Composer.

Go to your Adobe Commerce (Magento 2) root directory.

1. Download the latest release from the [GitHub repository](https://github.com/MONEI/MONEI-AdobeCommerce-Magento2/releases)
2. Extract the contents to your `app/code/Monei/MoneiPayment` directory
3. Install the MONEI PHP SDK:

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

4. Go to your Adobe Commerce (Magento 2) root directory and run:

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

Alternatively, you can use this one-line command to download and extract the latest release:

```
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 Bitnami stacks On Bitnami Magento images, use `bin/magento-cli` (instead of `bin/magento`) and prefix each command with `sudo`, otherwise the commands fail with permission errors. :::

## Configure[​](#configure "Direct link to Configure")

To configure the extension you have to go to **Stores → Configuration → Sales → Payment Methods → MONEI**.

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

Enter your API Key. You can find your API Key in [MONEI Dashboard → Settings → API Access](https://dashboard.monei.com/settings/api). Set **Mode** to **Test** or **Production** to choose which API Key + Account ID pair is used.

From the configuration screen you can:

* Set **Payment Action** to **Sale** (auth + capture) or **Authorize** (capture later by creating an invoice). Pre-authorization is not supported for MB Way or Multibanco and is silently downgraded to capture for those methods.
* Enable or disable each payment method individually (Card, Card Vault, Bizum, Apple Pay / Google Pay, PayPal, Multibanco, MB Way, and the generic redirect method).
* Enable **card tokenization** to let returning customers pay with a stored card via Magento Vault.

For more information on how to configure the extension, please refer to the [MONEI Adobe Commerce Extension documentation](https://github.com/MONEI/MONEI-AdobeCommerce-Magento2/blob/main/README.md).

## Supported payment methods[​](#supported-payment-methods "Direct link to Supported payment methods")

* Card (Visa, Mastercard, and more) — with Magento Vault tokenization for saved cards
* Apple Pay (domain registration is performed automatically when the method is enabled)
* Google Pay
* Bizum (Spain — automatically hidden for non-Spanish customers)
* PayPal
* Multibanco (Portugal — redirect only, no pre-auth)
* MB Way (Portugal — redirect only, no pre-auth)

## Before you go live[​](#before-you-go-live "Direct link to Before you go live")

* Switch **Mode** to **Production** and confirm the production API Key + Account ID are filled.
* Make sure that you have at least one active [payment method](https://dashboard.monei.com/settings/payment-methods).
* Verify your webhook URL is reachable from MONEI (no IP allowlist, no Cloudflare bot block, no Varnish caching the callback path — the module ships an `etc/varnish-config.vcl` snippet to merge into your VCL).
* Confirm cron is running (`bin/magento cron:status`) — the hourly job is the safety net for any missed webhooks.
* For Apple Pay, verify your domain shows in [MONEI Dashboard → Apple Pay](https://dashboard.monei.com/settings/apple-pay).