Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

MB WAY payments


MB WAY payments

Learn how to accept the MB WAY payment method.

MB WAY is a digital wallet payment method in Portugal. When paying with MB WAY, customers initiate payments using their phone number, and authenticate and approve them using their MB WAY app.

You get immediate notification of whether the payment succeeded or failed.

Note

MB WAY supports international phone numbers, but the majority of customers use a Portuguese phone number starting with +351. You can test your integration in a sandbox using test phone numbers.

Checkout

Elements

Direct API

Determine compatibility

A Checkout Session must satisfy all of the following conditions to support MB WAY:

  • You must express Prices for all line items in Euros (currency code eur ).

Accept a MB WAY payment

Note

Build an integration to accept a payment with Checkout before using this guide.

Enable MB WAY by making the following updates to your integration.

When creating a Checkout Session, you must:

  • Enable MB WAY in your Dashboard. Stripe automatically displays MB WAY to eligible customers using dynamic payment methods . If you currently specify payment _ method _ types , see the migration guide .
  • Make sure all line _ items use the eur currency.

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

Handle refunds

Learn more about MB WAY refunds.

Test your integration

Test your MB WAY integration by using the following test phone numbers. Each set of details reproduces a common live mode scenario.

Phone numberDescription
+351911111112The PaymentIntent status transitions from requires_action to succeeded after approximately 30 seconds.
+351911111113The PaymentIntent status transitions from requires_action to requires_payment_method immediately. Stripe returns the payment_method_not_available error code.
+351911111114The PaymentIntent status transitions from requires_action to requires_payment_method immediately. Stripe returns the payment_method_provider_decline error code.
+351911111115The PaymentIntent status transitions from requires_action to requires_payment_method immediately. Stripe returns the payment_intent_payment_attempt_expired error code.
+351911111116The PaymentIntent status transitions from requires_action to requires_payment_method immediately. Stripe returns the payment_method_customer_decline error code.
Any other phone numberThe PaymentIntent status immediately transitions from requires_action to succeeded.

See also

Last verified 2026-09-24

Is this helpful?