MB Way

MB Way is the leading e-wallet product in Portugal.In May 2021 there were over 3.5 million MB Way users, with the amount steadily growing each quarter. 50% of Portuguese bank customers have MB Way.

Payment Method Properties

Available country codesPT
Processing (Presentation) currenciesEUR
Settlement currenciesEUR
Consumer currenciesEUR
Channel member tagmbway
Scheme name in the settlement fileMBWay
Minimum transaction amountEUR 1
Maximum transaction amountEUR 5,000
Session timeout4 mins
RefundFull, partial and multiple partial refunds are all available
Refund Validity
ChargebackNo
Integration TypeAsynchronous
SandboxPPRO-hosted

Transaction Flow

  1. At the online checkout, the consumer chooses MB WAY as their preferred payment method.
  2. The consumer enters their Portuguese registered mobile phone number.
  3. The consumer receives a payment request notification on their mobile device.
  4. The consumer selects their payment card, and accepts or rejects the payment details and amount.
  5. The consumer enters their PIN and then authorises the payment.
  6. A "payment authorised" message appears on the mobile device.
  7. The payment is confirmed on the merchant's website.

Integration

Specific input parameters for the TRANSACTION call

Field NameM/O/CTypeRegexDescription
specin.phonenumberOString^\\d{1,5}#\\d{4,11}$The phone number of the consumer. Country code followed by hash symbol (#) followed by rest of number. Only digits and hash allowed.

For standard input parameters, see Input parameters for the TRANSACTION call.

Specific output parameters for the TRANSACTION call

Field NameM/O/CTypeRegExDescription
SPECOUT.PAYMENTPURPOSEMString*What the consumer sees on the proof of payment. For example, a bank statement record or similar.

See Well-known SPECOUT parameters for details of the general specific output parameters.

For standard output parameters, see Output parameters for the TRANSACTION call.

TRANSACTION call input

tag=mbway
&txtype=TRANSACTION
&countrycode=PT
&currency=EUR
&amount=1055
&merchanttxid=JKJhPbQQyYq9
&login=johndoe
&password=wXBrpVporFVjGO4R
&contractid=JOHNDOECONTRACT
&channel=channelname
&merchantredirecturl=https://merchant.com/work/ppro2/landing.php
&notificationurl=https://merchant.com/work/ppro2/notification.php
&accountholdername=John Doe
&returnmode=urlencodeext

TRANSACTION call output

REQUESTSTATUS=SUCCEEDED
&STATUS=SUCCEEDED
&TXID=622261966&ERRMSG=
&CHANNEL=testchannel
&TAG=mbway&PAYMENTGUARANTEE=NONE
&REDIRECTSECRET=WAiUGCNGdBdzYI4OIr2jh611D37PsT3U
&SPECOUT.PAYMENTPURPOSE=999999964