\u201cPagamento de Servi\u00e7os\u201d (payment of services) on Multibanco (Portuguese ATM network), and MB WAY (using the customer\u2019s mobile phone number), are the most popular ways to pay for services and (online) purchases in Portugal.\nPortuguese consumers trust the \u201cMultibanco\u201d and \u201cMB WAY\u201d payment methods more than any other.<\/p>\n\n
This plugin generates a \u201cMultibanco\u201d Payment Reference that customers can use to pay for their WooCommerce orders at an ATM or via home banking, or an \u201cMB WAY\u201d payment request which will send a push notification to the customer\u2019s mobile phone for payment approval.<\/p>\n\n
Credit or debit cards, including Apple Pay and Google Pay, CTT Payshop, and Cofidis Pay payment methods are also available.<\/p>\n\n
Holders of a Brazilian bank account can conveniently pay for WooCommerce orders in Euros, with automatic currency conversion to Brazilian Real, using PIX.<\/p>\n\n
This is the official ifthenpay<\/a> plugin, and a contract with this company is required. Technical support is provided by Naked Cat Plugins<\/a> (by Webdados<\/a>) on the WordPress.org support forums<\/a>.<\/p>\n\n Fully compatible with the new High-Performance Order Storage<\/a> (HPOS) and the WooCommerce block-based checkout<\/a>.<\/strong><\/p>\n\n Get the PRO add-on<\/a> and unlock extra features:<\/p>\n\n The PRO add-on is a product of Naked Cat Plugins<\/a> (by Webdados<\/a>), and is not provided by ifthenpay.<\/p>\n\n Already know our other WooCommerce (premium) plugins?<\/p>\n\n You have to sign a contract with ifthenpay to activate this service. Go to ifthenpay.com<\/a> for more information and to sign up.<\/p><\/dd>\n ifthenpay only provides this service to registered businesses and equivalents (such as tax-registered freelancers).\nYou should contact ifthenpay<\/a> if you need additional details on this matter.<\/p><\/dd>\n ifthenpay will send you an email each time a reference is paid, but the reference does not contain the order number. By design, our plugin does not include the order number in the reference because of the way WooCommerce\/WordPress sets orders\/posts IDs.\nAnyway, you do not need the order number in the reference, because our plugin uses a callback mechanism. ifthenpay automatically notifies WooCommerce when a specific Multibanco reference is used for payment. The order is linked to the reference in the database and will also be automatically set as paid.\nIf you still need to know which order a reference is linked to, use the search box on the WooCommerce Orders administration screen.<\/p><\/dd>\n Edit your wp-config.php file and set Just like in any other WooCommerce payment gateway that supports refunds.\nCheck out the instructions carefully here (Automatic refunds, step 4)<\/a> and here (WooCommerce specific instructions)<\/a>.<\/p><\/dd>\n Yes, but not with the same payment method keys.\nAsk ifthenpay for different credentials for each website, and payment method, you need the service to be available.\nThere are no extra costs, and you can even route payments to separate bank accounts.<\/p><\/dd>\n Yes, you can, but you should know your way around WordPress filters.\nThere are filters for this, and you can find examples in There are also filters for this. See You shouldn\u2019t! To our knowledge, it\u2019s illegal under Portuguese law<\/a> and a European directive<\/a> to charge an extra fee based on the payment method chosen by the customer.\nIf you don\u2019t care about legislation, plugins are available that allow you to set extra fees per payment method. Please, don\u2019t ask us for support on this.<\/p><\/dd>\n The MB WAY payment requests expire after 4 minutes.<\/p><\/dd>\n These payments need to be approved immediately after checking out.\nWooCommerce only sends payment instruction emails for payment methods that require later payment, not immediate payment, like Multibanco, Payshop, and Bank transfer, for example.\nThe customer will still receive an email upon payment if properly configured in WooCommerce (just not before).<\/p><\/dd>\n Not at this time. Apple Pay and Google Pay are processed via the ifthenpay Gateway. Everything related to payment happens there, and the customer is redirected back to the website afterward.\nThis means the checkout addresses are the ones the user entered on the website checkout page, not the ones provided by Apple or Google, which also means any custom field will be collected, which doesn\u2019t happen on Express Checkout.<\/p><\/dd>\n Yes. This plugin is officially WPML compatible.\nYou will need the WPML and WPML String Translation Plugins (alongside WooCommerce Multilingual, which is mandatory for any WooCommerce + WPML install).<\/p><\/dd>\n Go to WPML > String Translation > Search and translate all the strings in the Go to WooCommerce > SMS Notifications and add the Go to WooCommerce > Settings > SMS and add the Go to YITH Plugins > SMS Notifications > SMS Settings and add the Yes, you should use the You shouldn\u2019t but\u2026 yes, you can. Just return WooCommerce only automatically cancels \u201cPending\u201d orders, not \u201cOn Hold\u201d, because these orders are set to be paid by offline methods (like Multibanco or Payshop), and payment can occur at any time, even after the order is canceled. Still, if you want to take that risk, just return You can use the You probably have weird permalink settings (or permalinks not set at all) in your WordPress install.<\/p>\n\n If your permalinks are set as \u201cPlain\u201d, tell them to change the callback URL from This plugin does not collect or send any private data of the website where it\u2019s installed, its customers, or the orders, to Webdados (the plugin author) or ifthenpay (the payment processor).\nIn the MB WAY module, the mobile phone number is collected to request payment authorization and it can be legitimately processed based on Article 6 (1) (b) of the GDPR.\nifthenpay\u2019s privacy policy can be found at https:\/\/ifthenpay.com\/termosCondicoes<\/a><\/p><\/dd>\n Yes. This plugin is fully compatible with HPOS since December 2022.<\/p><\/dd>\n Yes. This plugin is compatible with the Block-Based Checkout since August 2020.<\/p><\/dd>\n Although this is the official ifthenpay WooCommerce plugin, development and support is provided by Webdados<\/a>.\nFor free\/standard support you should use the support forums here at WordPress.org<\/a>\nFor premium, urgent and experimental integrations support or custom developments you should contact Webdados<\/a>. Charges will apply.<\/p>\n\n Any support related to failed payments or credit card authorizations should be directed to ifthenpay<\/a>.<\/p><\/dd>\n You can report any security bugs found in the source code of this plugin through the Patchstack Vulnerability Disclosure Program<\/a>. The Patchstack team will assist you with verification, CVE assignment and take care of notifying the developers of this plugin.<\/p><\/dd>\nFeatures:<\/h4>\n\n
\n
\n
PRO add-on<\/h4>\n\n
\n
\n
\n
Other (premium) plugins<\/h4>\n\n
\n
\n
\n
Can I start receiving payments right away? Show me the money!<\/h3><\/dt>\n
I\u2019m an individual and not a registered business. Can I use this plugin?<\/h3><\/dt>\n
The generated Multibanco reference does not contain the order number. How do I know which order was paid?<\/h3><\/dt>\n
How do I test the callback call to simulate a payment and foresee what happens when a real payment is made by a customer?<\/h3><\/dt>\n
WP_DEBUG<\/code> to true<\/code>.\nThen, place a test order in the frontend using any of the plugin\u2019s payment methods.\nGo to the order edit screen and click the \u201cSimulate callback payment\u201d button.\nDon\u2019t forget to set WP_DEBUG<\/code> to false<\/code> again, as it should not be active on a production website.<\/p><\/dd>\nHow to issue an MB WAY or Credit or debit card refund within WooCommerce?<\/h3><\/dt>\n
Can I use this plugin and the ifthenpay service on more than one website?<\/h3><\/dt>\n
Can I change the look and feel of the payment instructions on the \u201cThank you\u201d page and\/or the new order email, as well as the SMS message format?<\/h3><\/dt>\n
hooks-examples.php<\/code>.<\/p><\/dd>\nCan I change the payment gateway icon on the checkout page?<\/h3><\/dt>\n
hooks-examples.php<\/code>.<\/p><\/dd>\nI want to charge an additional fee for these payment methods. How should I do it?<\/h3><\/dt>\n
How much time does the customer have to pay with MB WAY?<\/h3><\/dt>\n
Why doesn\u2019t the customer receive an email when paying with MB WAY, Credit card, Apple Pay, Google Pay, or PIX?<\/h3><\/dt>\n
Do Apple Pay and Google Pay support Express Checkout?<\/h3><\/dt>\n
[WPML] My website is multilingual. Will I be able to use this plugin?<\/h3><\/dt>\n
[WPML] How can I translate the payment method title and description the customer sees on the checkout page to secondary languages?<\/h3><\/dt>\n
woocommerce<\/code> and multibanco_ifthen_for_woocommerce<\/code> domains containing ifthen_for_woocommerce<\/code> in their name.<\/p><\/dd>\n[SMS] How to include the Multibanco and\/or Payshop payment instructions in the SMS sent by \u201cWooCommerce - APG SMS Notifications\u201d?<\/h3><\/dt>\n
%multibanco_ifthen%<\/code> and\/or %payshop_ifthen%<\/code> variables to \u201cOrder on-hold custom message\u201d.<\/p><\/dd>\n[SMS] How to include the Multibanco and\/or Payshop payment instructions in the SMS sent by \u201cTwilio SMS Notifications\u201d?<\/h3><\/dt>\n
%multibanco_ifthen%<\/code> and\/or %payshop_ifthen%<\/code> variables to \u201cCustomer Notifications\u201c > \u201cOn Hold SMS Message\u201d.<\/p><\/dd>\n[SMS] How to include the Multibanco and\/or Payshop payment instructions in the SMS sent by \u201cYITH WooCommerce SMS Notification\u201d?<\/h3><\/dt>\n
{multibanco_ifthen}<\/code> and\/or {payshop_ifthen}<\/code> variables to \u201cOn hold\u201d.<\/p><\/dd>\n[Advanced] Can I use a specific Multibanco Entity\/Subentity or Key, MB WAY, Credit card, or Payshop Key based on order details?<\/h3><\/dt>\n
multibanco_ifthen_base_ent_subent<\/code> or multibanco_ifthen_base_mbkey<\/code>, multibanco_ifthen_base_mbwaykey<\/code>, multibanco_ifthen_base_creditcardkey<\/code> or multibanco_ifthen_base_payshopkey<\/code> filters. See hooks-examples.php<\/code>.<\/p><\/dd>\n[Advanced] The order is set to \u201cOn Hold\u201d for Multibanco and Payshop, can I make it \u201cPending\u201d by default?<\/h3><\/dt>\n
false<\/code> to the multibanco_ifthen_set_on_hold<\/code> and\/or payshop_ifthen_set_on_hold<\/code> filter.\nBe advised that no \u201cnew order\u201d email, with payment instructions, will be sent to the customer unless you use some plugin or custom code to force it.<\/p><\/dd>\n[Advanced] I\u2019ve set up WooCommerce to cancel unpaid orders after x minutes, why are my Multibanco and\/or Payshop orders not being canceled?<\/h3><\/dt>\n
true<\/code> to the multibanco_ifthen_cancel_unpaid_orders<\/code> and\/or payshop_ifthen_cancel_unpaid_orders<\/code> filter.\nYou can also restore that order\u2019s product stock by returning true<\/code> to the multibanco_ifthen_cancel_unpaid_orders_restore_stock<\/code> and\/or payshop_ifthen_cancel_unpaid_orders_restore_stock<\/code> filter, although the WooCommerce team doesn\u2019t recommend<\/a> it.\nBe advised the Multibanco or Payshop reference will still be active and can be paid later on.<\/p><\/dd>\n[Advanced] Can I prevent the plugin from adding the payment instructions and\/or the payment received message to emails?<\/h3><\/dt>\n
multibanco_ifthen_email_instructions_pending_send<\/code> and\/or mbway_ifthen_email_instructions_pending_send<\/code> filter: return false and the payment instructions won\u2019t be included in the \u201cnew order\u201d email \u2013 we do not recommend you to do it, though.\nYou can use the multibanco_ifthen_email_instructions_payment_received_send<\/code> and\/or mbway_ifthen_email_instructions_payment_received_send<\/code> filter: return false and the payment received message won\u2019t be included in the \u201cProcessing\u201d or \u201cCompleted\u201d email.<\/p><\/dd>\nifthenpay says my callback URL is returning a 404 error. Is there a solution?<\/h3><\/dt>\n
https:\/\/yourwebsite\/wc-api\/WC_Multibanco_IfThen_Webdados\/?chave=[CHAVE_ANTI_PHISHING]...<\/code> to https:\/\/yourwebsite\/?wc-api=WC_Multibanco_IfThen_Webdados&chave=[CHAVE_ANTI_PHISHING]...<\/code>.\nIf your permalinks are set as \u201cCustom structure\u201d: \/index.php\/%postname%\/<\/code> tell them to set the callback to https:\/\/yourwebsite\/index.php\/wc-api\/WC_Multibanco_IfThen_Webdados\/?chave=[CHAVE_ANTI_PHISHING]...<\/code><\/p><\/dd>\nIs this plugin compliant with the European Union General Data Protection Regulation (GDPR)?<\/h3><\/dt>\n
Is this plugin compatible with the new WooCommerce High-Performance Order Storage?<\/h3><\/dt>\n
Is this plugin compatible with the WooCommerce Cart and Checkout Blocks?<\/h3><\/dt>\n
I need technical support. Who should I contact, ifthenpay or Webdados?<\/h3><\/dt>\n
Where do I report security vulnerabilities found in this plugin?<\/h3><\/dt>\n
Can I contribute with a translation?<\/h3><\/dt>\n