--- updatedAt: 2026-08-24T18:17:23.000Z agentTools: siteIndex: https://developerhub.ppro.com/llms.txt projectIndex: https://developerhub.ppro.com/global-api/llms.txt --- # MB WAY MB WAY is the leading e-wallet in Portugal, with over 5 million users. The user base continues to grow steadily each quarter, and now 50% of Portuguese bank customers are using MB WAY. Learn more about MB WAY. # Payment method properties | | | | :----------------------------------------- | :------------------------------- | | Markets (consumer) | `PT` | | Processing currencies | `EUR` | | Consumer currencies | `EUR` | | Authentication methods | `REDIRECT` `APP_NOTIFICATION` | | Authentication timeout | 4 mins | | Minimum payment amount | 0.01 EUR | | Maximum payment amount | 10,000.00 EUR | | Payment instrument | `PASSTHROUGH_WALLET` | | Recurring payments | Yes (Subscription and One-Click) | | Separate captures | No | | Refund | Full - Partial - Multiple | | Refund validity | 120 days | | Disputes | Yes | | Settlement risk | No | # Make an MB WAY payment MB WAY payments follow our standardized `REDIRECT`and `APP_NOTIFICATION`payment flows. Enabling you to offer a seamless desktop or mobile handoff experience. We recommend including all relevant settings for any authentication methods you support. To create an MB WAY payment, you'll need to provide the following data at minimum when calling our [payment charges endpoint](https://developerhub.ppro.com/global-api/reference/createpaymentcharge): | Field | Description | | :---------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- | | `paymentMethod` | `MBWAY` | | `amount.value` | The amount to be paid in the smallest units of the currency used. | | `amount.currency` | `EUR` | | `consumer.country` | The country of residence of the consumer. | | authenticationSettings: REDIRECT `settings.returnUrl` | Specify the URL to which the consumer should be redirected after completing the payment. This is required for the `REDIRECT` payment flow. | ### **Guidance** To improve the consumer experience and payment traceability, consider including the following fields. See the [API Reference](https://developerhub.ppro.com/global-api/reference/createpaymentcharge) for full details. | Fields | Description | | :------------------ | :---------------------------------------------------------- | | `paymentDescriptor` | A short descriptor that appears on the page during payment. | ### Request `POST /v1/payment-charges` ```json REDIRECT { "paymentMethod": "MBWAY", "amount": { "value": 1000, "currency": "EUR" }, "consumer": { "country": "PT", }, "authenticationSettings": [ { "settings": { "returnUrl": "https://www.webshop.com/order-results-page" }, "type": "REDIRECT" } ] } ``` ```json APP_NOTIFICATION { "paymentMethod": "MBWAY", "amount": { "value": 1000, "currency": "EUR" }, "consumer": { "country": "PT" }, "authenticationSettings": [ { "type": "APP_NOTIFICATION", "settings": { "instrumentProviderIdentity": "+351000000000" } } ] } ``` ### Response You'll receive our standard payment charge response: ```json REDIRECT { "id": "charge_Y3JVzvEaJpvG53xd2R2Zt", "paymentMethod": "MBWAY", "paymentMedium": "ECOMMERCE", "scheduleType": "UNSCHEDULED", "instrumentId": "instr_Asu0ig2PXXZSiNrhY44A5", "currency": "EUR", "country": "PT", "status": "AUTHENTICATION_PENDING", "consumer": { "country": "PT" }, "authenticationMethods": [ { "details": { "requestUrl": "https://redirection-target.ppro.com", "requestMethod": "GET" }, "type": "REDIRECT" }, { "type": "APP_NOTIFICATION" } ], "authorizations": [ { "id": "authz_aPobet0FNZNU1bYqfexFd", "amount": 1000, "status": "AUTHENTICATION_PENDING", "createdAt": "2025-12-21T08:34:20.766Z", "updatedAt": "2025-12-21T08:34:20.766Z" } ], "captures": [], "refunds": [], "discards": [], "voids": [], "createdAt": "2025-12-21T08:34:20.114Z", "updatedAt": "2025-12-21T08:34:20.766Z", "_links": { "authorizations": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/authorizations" }, "captures": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/captures" }, "refunds": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/refunds" }, "discards": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/discards" }, "voids": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/voids" } } } ``` ```json APP_NOTIFICATION { "id": "charge_Y3JVzvEaJpvG53xd2R2Zt", "paymentMethod": "MBWAY", "paymentMedium": "ECOMMERCE", "scheduleType": "UNSCHEDULED", "instrumentId": "instr_Asu0ig2PXXZSiNrhY44A5", "currency": "EUR", "country": "PT", "status": "AUTHENTICATION_PENDING", "consumer": { "country": "PT" }, "authenticationMethods": [ { "type": "APP_NOTIFICATION" } ], "authorizations": [ { "id": "authz_aPobet0FNZNU1bYqfexFd", "amount": 1000, "status": "AUTHENTICATION_PENDING", "createdAt": "2025-12-21T08:34:20.766Z", "updatedAt": "2025-12-21T08:34:20.766Z" } ], "captures": [], "refunds": [], "discards": [], "voids": [], "createdAt": "2025-12-21T08:34:20.114Z", "updatedAt": "2025-12-21T08:34:20.766Z", "_links": { "authorizations": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/authorizations" }, "captures": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/captures" }, "refunds": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/refunds" }, "discards": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/discards" }, "voids": { "href": "/v1/payment-charges/charge_Y3JVzvEaJpvG53xd2R2Zt/voids" } } } ``` # Pick the desired authentication method **REDIRECT** Redirect your consumer to the returned `$.authenticationMethods[?(@.type == "REDIRECT")].details.requestUrl`.\ For example, with the value of `https://redirection-target.ppro.com/` using the returned `$.authenticationMethods[?(@.type == "REDIRECT")].details.requestMethod` HTTP method.
**APP\_NOTIFICATION** 1. Ask your consumer for the required identifier needed to initiate the push notification, often a phone or bank account number. For MBWAY payments, provide the consumer's phone number. 2. The consumer will receive a push notification to complete the payment process. # Handling the payment result **REDIRECT** 1. After the consumer completes the payment, they are redirected to the `returnUrl` specified in the payment charge creation request. 2. Upon redirect back to your site, retrieve the latest payment status by performing a **GET** [/v1/payment-charges/\{paymentChargeId}](https://developerhub.ppro.com/global-api/reference/getpaymentcharge`). Use the returned `status` field to determine and display the final payment outcome to the consumer. 3. Additionally, [webhooks](https://developerhub.ppro.com/global-api/docs/webhooks) are triggered to notify you of the payment result. This ensures you receive the outcome even if the consumer closes their browser or fails to return to your website.
**APP\_NOTIFICATION** 1. The payment charge will remain in the `AUTHENTICATION_PENDING` state until the consumer confirms the payment. 2. [Webhooks](https://developerhub.ppro.com/global-api/docs/webhooks) are sent to inform you of the payment outcome. 3. Alternatively, check the payment status by making a **GET** [/v1/payment-charges/\{paymentChargeId}](https://developerhub.ppro.com/global-api/reference/getpaymentcharge`). Use the `Status` that you received to display the payment outcome to the consumer. # Payment instrument A `PASSTHROUGH_WALLET` instrument will be created for MBWAY, with no additional data provided. ### Request `GET /v1/payment-instruments/{instrument-id}` ### Response ```json { "id": "instr_Asu0ig2PXXZSiNrhY44A5", "type": "PASSTHROUGH_WALLET" } ``` # Sandbox testing MB Way uses PPRO's mock authenticator in sandbox. [Learn more](https://developerhub.ppro.com/global-api/docs/mock-authenticator). # Sub pages * [Recurring](https://developerhub.ppro.com/global-api/docs/mbway-recurring.md) # Sibling pages * [Alipay](https://developerhub.ppro.com/global-api/docs/alipay.md) * [Amazon Pay](https://developerhub.ppro.com/global-api/docs/amazonpay.md) * [BANCOMAT Pay](https://developerhub.ppro.com/global-api/docs/bancomatpay.md) * [Cash App Pay](https://developerhub.ppro.com/global-api/docs/cashapppay.md) * [DOKU Wallet](https://developerhub.ppro.com/global-api/docs/dokuwallet.md) * [GoPay](https://developerhub.ppro.com/global-api/docs/gopay.md) * [Jenius Pay](https://developerhub.ppro.com/global-api/docs/jeniuspay.md) * [LinkAja](https://developerhub.ppro.com/global-api/docs/linkaja.md) * [NuPay](https://developerhub.ppro.com/global-api/docs/nupay.md) * [OVO](https://developerhub.ppro.com/global-api/docs/ovo.md) * [PayPal](https://developerhub.ppro.com/global-api/docs/paypal.md) * [Satispay](https://developerhub.ppro.com/global-api/docs/satispay.md) * [Skrill](https://developerhub.ppro.com/global-api/docs/skrill.md) * [Stablecoins](https://developerhub.ppro.com/global-api/docs/stablecoins.md) * [Swish](https://developerhub.ppro.com/global-api/docs/swish.md) * [TWINT](https://developerhub.ppro.com/global-api/docs/twint.md) * [WeChat Pay](https://developerhub.ppro.com/global-api/docs/wechatpay.md) * [Wero](https://developerhub.ppro.com/global-api/docs/wero.md)