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
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.
The module is published on the Magento Marketplace and on Packagist.
Before you begin
To test your integration:
- Use your test mode API Key. You can find it in MONEI Dashboard → Settings → API Access.
- You can check the status of a test payment in your MONEI Dashboard → Payments (in test mode).
Install
- Using composer (recommended)
- From the raw package
Go to your Adobe Commerce (Magento 2) root directory and run the following commands:
- Add the package to your Magento installation:
composer require monei/module-monei-payment
- Enable the module:
bin/magento module:enable Monei_MoneiPayment
- 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.
- Download the latest release from the GitHub repository
- Extract the contents to your
app/code/Monei/MoneiPaymentdirectory - Install the MONEI PHP SDK:
composer require monei/monei-php-sdk:^2.8.3
- 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
To configure the extension you have to go to Stores → Configuration → Sales → Payment Methods → MONEI.
Enter your API Key. You can find your API Key in MONEI Dashboard → Settings → API Access. 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.
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
- 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.
- 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.vclsnippet 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.