Description
“Pagamento de Serviços” (payment of services) on Multibanco (Portuguese ATM network), and MB WAY (using the customer’s mobile phone number), are the most popular ways to pay for services and (online) purchases in Portugal.
Portuguese consumers trust the “Multibanco” and “MB WAY” payment methods more than any other.
This plugin generates a “Multibanco” Payment Reference that customers can use to pay for their FluentCart orders at an ATM or via home banking, or an “MB WAY” payment request which will send a push notification to the customer’s mobile phone for payment approval.
Soon, this plugin will also have support for Credit card, Apple Pay, Google Pay, Payshop, Cofidis, and PIX.
This is the official ifthenpay plugin, and a contract with this company is required. Technical support is provided by Naked Cat Plugins (by Webdados) on the WordPress.org support forums.
Features
- Generates a Multibanco Reference for simple payment on the Portuguese ATM network or home banking service;
- Allows the customer to pay using MB WAY using their mobile phone;
- Possibility of setting an expiration date for Multibanco references;
- Automatically changes the order status to “Processing” (or “Completed” if the order only contains digital products) and notifies both the customer and the store owner if the automatic “Webhook/Callback” upon payment is activated;
- Automatic “Webhook/Callback” can be activated via the plugin settings screen for each payment method;
External services
This plugin connects to the ifthenpay API to request payments and to activate the payment notification “Webhook/Callback”.
When a customer places an order using Multibanco, we send your MB Key, the order number, the amount to be paid, and your website name.
When a customer places an order using MB WAY, we send the same information, plus the mobile phone number the customer typed at checkout, because that is the number that receives the payment request. No other customer information is sent: not their name, e-mail address, or billing address.
When you activate the “Webhook/Callback” from the settings screen, we send your ifthenpay Backoffice Key, the payment method key, the address ifthenpay should notify when a payment is made, and the antiphishing key that protects it.
This service is provided by ifthenpay: end-user license agreement, privacy policy.
Installation
- Make sure you already have a contract with ifthenpay;
- Use the included automatic install feature on your WordPress admin panel and search for “ifthenpay fluentcart”;
- Multibanco: Go to FluentCart > Settings > Payment Settings > Multibanco and fill in the MB Key provided by ifthenpay;
- MB WAY: Go to FluentCart > Settings > Payment Settings > MB WAY and fill in the MB WAY Key provided by ifthenpay;
- On all payment methods, after saving the settings: Activate the “Webhook/Callback” to enable automatic payment notification from ifthenpay to your website (the Backoffice Key provided when signing the contract is needed);
- Start receiving payments 🙂
FAQ
-
Can I start receiving payments right away? Show me the money!
-
You have to sign a contract with ifthenpay to activate this service. Go to ifthenpay.com for more information and to sign up.
-
I’m an individual and not a registered business. Can I use this plugin?
-
ifthenpay only provides this service to registered businesses and equivalents (such as tax-registered freelancers).
You should contact ifthenpay if you need additional details on this matter. -
Can I use this plugin and the ifthenpay service on more than one website?
-
Yes, but not with the same payment method keys.
Ask ifthenpay for different credentials for each website, and payment method, you need the service to be available.
There are no extra costs, and you can even route payments to separate bank accounts. -
Why is the payment method not showing at checkout?
-
Both payment methods hide themselves when they cannot be used, so a customer is never offered a payment that would fail. Check, in this order:
- The payment method is enabled on its own settings screen;
- Your store currency is set to EUR, which is the only currency ifthenpay supports;
- The MB Key, or MB WAY Key, is filled in and is in the AAA-000000 format (three letters, a hyphen, six digits);
- If you enabled “Only for Portuguese customers”, the customer’s billing or shipping country has to be Portugal;
- If you set “Only for orders from” or “Only for orders up to”, the order total has to be inside that range;
- The order does not include a subscription product. Multibanco and MB WAY need the customer to act on every single payment, so they cannot renew a subscription and are not offered for one.
-
Does the customer get an email with the payment details?
-
Multibanco orders send FluentCart’s “Order confirmation to customer (Offline Payment)” email, and its admin counterpart, as soon as the reference is created. MB WAY orders do not: the payment has to be approved in the app within 4 minutes, and FluentCart’s “Order paid” email goes out once it is.
FluentCart does not yet let payment methods add content to its default emails, so the reference is not included automatically. With FluentCart Pro, which lets you edit the content of each email, you can edit it in FluentCart > Settings > Email Configuration > Notifications: add a “Custom HTML” block where you want the payment details to appear, containing only the
{{ifthenpay.payment_instructions}}smartcode. Use a “Custom HTML” block rather than a paragraph, because the payment details are a table, which email clients do not always display correctly inside a paragraph. The smartcode shows the Multibanco entity, reference, value and expiration (or the MB WAY details) while the order is waiting for payment, and nothing in any other situation, so it is safe to add to any email. -
Is this plugin compliant with the European Union General Data Protection Regulation (GDPR)?
-
This plugin does not send any private data of the website where it’s installed, its customers, or the orders, to Naked Cat Plugins / Webdados (the plugin author).
In the MB WAY payment method, the customer’s mobile phone number is collected and sent to ifthenpay (the payment processor) to request the payment authorization, and it can be legitimately processed based on Article 6 (1) (b) of the GDPR.
ifthenpay’s privacy policy can be found at https://ifthenpay.com/privacy-policy/?lang=en -
Where do I report security vulnerabilities found in this plugin?
-
Please report security bugs found in the source code of this plugin through the Patchstack Vulnerability Disclosure Program. The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Payment Multibanco and MB WAY for FluentCart via ifthenpay” is open source software. The following people have contributed to this plugin.
Contributors“Payment Multibanco and MB WAY for FluentCart via ifthenpay” has been translated into 2 locales. Thank you to the translators for their contributions.
Translate “Payment Multibanco and MB WAY for FluentCart via ifthenpay” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2 – 2026-10-09
- [NEW] Multibanco orders send FluentCart’s offline payment confirmation emails when the reference is created
- [NEW] Multibanco and MB WAY payment details panel on the FluentCart order screen
- [NEW]
{{ifthenpay.payment_instructions}}smartcode adds the payment details to any FluentCart Pro custom email - [TWEAK] The Multibanco reference is shown in groups of three digits, easier to type at the ATM
- [TWEAK] Expiration dates follow the store’s date and time format
- [TWEAK] Debug “Enabled” now only logs, and error alert emails are sent only with “Enabled (and send important events to email)”
- [TWEAK] Debug logs mask the MB WAY mobile number (91*****89) and the antiphishing key, when correct
- [FIX] Some paid orders stayed pending because the amount ifthenpay reported was matched one cent short, for values such as 19,99 €
- [FIX] FluentCart actions that run when an order is paid, such as recording order bumps, now also run for Multibanco and MB WAY
- [DEV] The
ifthenpay_fluentcart_payment_completedaction now actually fires, before the response to ifthenpay ends the request - [DEV] The Callback/Webhook activation button uses the same permission FluentCart requires to manage payment methods
- [DEV] Multibanco and MB WAY now share a common base class and settings class, so new payment methods only add what is specific to them
- [DEV] Tested up to WordPress 7.2-alpha-64042 and FluentCart 1.7.1
1.1 – 2026-09-05
- [TWEAK] Update the “External services” information, and add a GDPR entry to the FAQ, detailing that MB WAY payment requests include the mobile phone number the customer types at checkout, because that is the number that receives the payment request
- [TWEAK] Refuse to activate a payment method when the store currency is not EUR, or when the ifthenpay key is not in the AAA-000000 format, and explain why, instead of saving settings that would silently never work
- [TWEAK] Record the date and time ifthenpay reports for the payment, in Lisbon time, instead of the moment the payment notification reached your website
- [TWEAK] Add an “MB WAY settings” shortcut to the plugin’s entry on the plugins list
- [FIX] Multibanco and MB WAY are no longer offered for subscription products, which they have no way of renewing
- [DEV] Load the MB WAY checkout styles only when MB WAY is being shown, and stop loading an unused script on the checkout and receipt pages
- [DEV] Tested up to WordPress 7.2-alpha-63482 and FluentCart 1.6.3
1.0.1 – 2025-11-20
- [NEW] New payment method: MB WAY
- [TWEAK] Add Patchstack VDP information to readme.txt
- [DEV] Stronger validation of Webhook parameters
- [DEV] Requires FluentCart 1.3.0
- [DEV] Fix version on readme.txt
- [DEV] Tested up to WordPress 6.9-RC2-61266 and FluentCart 1.3.0
1.0.0 – 2025-11-20
- [DEV] Wrong version on readme.txt 🤷♂️
0.1.0 – 2025-10-31
- [NEW] First release
- [DEV] Tested up to WordPress 6.9-beta2-61099 and FluentCart 1.2.5
