WooCommerce
To accept payments through MONEI in your WooCommerce store you simply need to install and configure MONEI WooCommerce Plugin.
Live demo
Requirements
| Component | Minimum | Tested up to |
|---|---|---|
| WordPress | 5.0 | 6.8 |
| WooCommerce | 3.0 | 9.8 |
| PHP | 8.0 | 8.3 |
:::caution PHP 8.0 required since plugin v7.0.1 Plugin versions 7.0.1 and newer require PHP 8.0+. If you are still on PHP 7.4, upgrade PHP before updating the plugin — WordPress itself no longer supports PHP 7.4 either. :::
The plugin is compatible with:
- WooCommerce Blocks (Cart + Checkout) — see the migration section below
- High-Performance Order Storage (HPOS)
- WooCommerce Subscriptions and YITH WooCommerce Subscription for recurring billing with saved cards
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
The recommended path is wp-admin → Plugins → Add new → search for MONEI → Install → Activate. WordPress will automatically update the plugin going forward.
For a pre-release or a specific tag, download the ZIP from the GitHub releases page and upload it via Plugins → Add new → Upload Plugin.
Configure
Go to WooCommerce → Settings → MONEI Settings
Enter your Account ID and API Key. You can find your Account ID and API Key in MONEI Dashboard → Settings → API Access. Test and live credentials have separate fields — the Mode toggle decides which pair is active.
Go to WooCommerce → Settings → Payments
Configure payment methods that you want to accept in your store. Each MONEI method has its own settings panel where you can switch between component (inline form) and redirect (hosted page) mode, customize the title and description, and theme the embedded form via JSON.
Supported payment methods
- Card (Visa, Mastercard, and more) — with tokenization for saved cards
- Apple Pay
- Google Pay
- Bizum (Spain — automatically hidden for non-Spanish customers)
- PayPal
- Multibanco (Portugal — hidden for non-Portuguese customers, redirect only)
- MB Way (Portugal — hidden for non-Portuguese customers, redirect only)
Migration to WooCommerce Blocks
Starting from version 6.0, the plugin supports WooCommerce Blocks. To enable the modern checkout experience, replace the legacy shortcodes with the Cart and Checkout blocks.
Go to Pages and find the Checkout page. Remove the old shortcode and add the Checkout block to the page.
Go to Pages and find the Cart page. Remove the old shortcode and add the Cart block to the page.
Before you go live
- Make sure that you are using live (production) mode API Key.
- Make sure that you have at least one active payment method.
- Verify the IPN URL
https://<your-store>/wc-api/monei_ipn/is reachable from MONEI (no IP allowlist, no Cloudflare bot block, permalinks saved). - For Apple Pay, register your domain in MONEI Dashboard → Apple Pay.
- If you use Blocks checkout, confirm the Cart and Checkout pages use blocks (not shortcodes).