Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in
OverviewUpgrade your integration
Online payments
OverviewFind your use caseUse Managed Payments
In-person payments
Payment methods
Payment scenarios
Beyond 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.

Caution

Stripe can automatically present the relevant payment methods to your customers by evaluating currency, payment method restrictions, and other parameters.

  • Follow the Accept a payment guide to build a Checkout integration that uses dynamic payment methods.
  • If you don’t want to use dynamic payment methods, follow the steps below to manually configure the payment methods in your Checkout integration.

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.

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:

  • Add mb_way to the list of payment_method_types.
  • Make sure all line_items use the eur currency.
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'mb_way'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `mb_way`, all line items must have currency: eur
      currency: 'eur',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

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 15 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 number>The PaymentIntent status immediately transitions from requires_action to succeeded.

See also

Was this page helpful?
YesNo