We are currently in the pilot phase for this product in Portugal.

If you are interested in participating in the next stage of our pilot, email [email protected]

MB WAY is a popular payment method in Portugal that lets customers make payments, send or request money, and manage funds using their mobile application.

Payment methodsMastercard, Visa, Visa Electron or Multibanco card.
Payment pagesYes (current version only)
Payment componentsYes
RefundsYes: Full and partial

Payment flow

This diagram shows the flow for a successful transaction. Click to magnify.

MBWAY payment flow

Payment statutes

The table below sets out the order status and transaction status for payments and refunds.

DescriptionOrder statusTransaction status
The customer has initiated a transaction. You can no longer cancel.InitializedInitialized
The customer has completed the payment using the reference number.CompletedUncleared
The transaction is settled.CompletedCompleted
The customer didn't complete payment within 4 minutes.ExpiredExpired
The reference number used is invalid.DeclinedDeclined
Refunds: Refund reserved.ReservedReserved
Refunds: Refund complete.CompletedCompleted
Refunds: Refund declined.DeclinedDeclined


  1. Sign in to your MultiSafepay dashboard .
  2. To activate the payment method for:
  • All sites, go to Settings > Payment methods.
  • A specific site, go to Sites, and then click the relevant site.
  1. Select the checkbox for the payment method, and then click Save changes.

💬 Support: If the payment method isn't visible in your dashboard, email [email protected]


  • See API reference – Create order > Wallet order.

    Example requests

    For example requests, on the Create order page, in the black sandbox, see Examples > MB WAY direct/redirect.
    Set gateway to MBWAY, and type to direct or redirect.

  • A phone number is required in the customer object, and must be in a 9-digit number format excluding +351 Portugal calling code .

  • For direct orders, you must provide the customer with payment instructions to proceed with the payment.

  • Transactions expire after 4 minutes.

User guides

Amount limits

  • Minimum order amount: 1 EUR
  • Maximum order amount: 99.999,99 EUR


You can no longer cancel a transaction after the status changes to Initialized.

Payment instructions

Email the customer the following payment details to include when completing the payments.

You can still update the customer's phone number on the payment pages.


You can process refunds in your dashboard or via API.

How to refund an order

In your dashboard

  1. Sign in to your MultiSafepay dashboard .
  2. Go to Transactions > Transaction overview, and then click the relevant transaction.
  3. On the Transaction details page, click Refund order.
  4. In the Reason / Description field, enter the reason for the refund or a description of what happened with the order, and then click Complete.
  5. In the Comment field, enter any additional information.
  6. In the Amount fields, enter the amount to refund.
  7. Click Continue.
  8. Review the Refund confirmation, and then click Confirm.

Via the API

See API reference – Refund order.



Email [email protected]

Top of page