---
title: "MBWAY"
slug: "mbway"
updated: 2025-11-06T10:36:02Z
published: 2025-11-06T10:36:02Z
canonical: "docs.apcopay.com/mbway"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apcopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MBWAY

MB WAY is a widely used mobile payment solution in Portugal, developed by SIBS, the country's leading payment processor. Launched in 2015, it enables users to link their bank cards to their mobile numbers, facilitating instant payments, money transfers, and online purchases. With over 5 million users, MB WAY has become integral to daily transactions in Portugal, offering features like QR code payments, contactless transactions via NFC, and the ability to withdraw cash from ATMs without a physical card. Its user-friendly interface and broad acceptance among merchants have solidified its position as a preferred payment method nationwide.

### Supported Transaction Types

- [ ] Authorisation
- [x] Purchase
- [ ] Capture
- [ ] Void
- [ ] Refunds
- [ ] Withdrawals

### Integrations Supported

**Deposit**

- [x] Hosted Payment Page
- [ ] Direct Connect

### Currencies & Countries Supported

| Title | Description |
| --- | --- |
| Currencies Supported | EUR |
| Countries Supported | Portugal |

## Additional attributes to process Cards via Monetix

You must include the following JSON Attributes to the payload. These attributes inform us to proceed with the redirection to finalise the payment process.

| Description | Hosted Payment Page |
| --- | --- |
| **Force Transaction Routing** | "Routing":{ "ForcePayment": "MONETIX” } |
| **Client Details** | "Client": { "FirstName": "Joe", "LastName": "Borg", "Street": "12 Church street", "City": "Valletta", "Email": "[TestEmail@Email.com](mailto:TestEmail@Email.com)", "ClientAccount": "testing", "IPAddress":"1.1.1.1" "MobileNo":"123456789" } |
| **Payment Method Data** | "PaymentMethodData": { "PaymentMethod": "MBWAY" } |
| **Test Indicator** (required in Sandbox Environment only) | "isTest”: true |

Sample request below

```json
{
  "TransactionType": "PURC",
  "Amount": 100.00,
  "Currency": "EUR",
  "OrderReference": "Monetix test",
  "UniqueReference": "4b8da4f0-d3b4-44ae-8019-8c66905ffad7",
  "RedirectionURL": "https://www.yourURLhere.com/technicalsupporttool-fe/Redirect/",
  "CallBackURL": "https://www.yourURLhere.com/technicalsupporttool-fe/Listener",
  "Routing": {
    "ForcePayment": "MONETIX"
  },
  "IsTest": true,
  "Client": {
    "FirstName": "Joe",
    "LastName": "Borg",
    "City": "TestCity",
    "Street": "fakestreet 123",
    "Email": "TestEmail@Email.com",
    "ClientAccount": "testing",
    "IPAddress": "1.1.1.1",
    "MobileNo":"123456789"
  },
  "PaymentMethodData": {
    "PaymentMethod": "MBWAY"
  } 
}
```

##