Payment Method Properties


Available country codes	PT
Processing (Presentation) currencies	EUR
Settlement currencies	EUR
Consumer currencies	EUR
Channel member tag	mbway
Scheme name in the settlement file	MBWay
Minimum transaction amount	0.01€
Maximum transaction amount	99999€
Session timeout	4 mins
Refund	Full, partial and multiple partial refunds are all available
Refund Validity
Chargeback	No
Integration Type	Asynchronous
Sandbox	PPRO-hosted

Transaction Flow

The consumer needs to register with the MB Way app and add their bank account before they can proceed with using this payment method.

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

Integration

Specific input parameters for the TRANSACTION call

Field Name	M/O/C	Type	Regex	Description
`specin.phonenumber`	O	String	`^\\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 Name	M/O/C	Type	RegEx	Description
`SPECOUT.PAYMENTPURPOSE`	M	String	`*`	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