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	5000€
Session timeout	4 mins
Refund	Full, partial and multiple partial refunds are all available
Refund Validity	120 days
Chargeback	YES
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.
- If consumer is using a desktop device to checkout ,they receive a payment request notification on their mobile device.
- If consumer is using a mobile device to checkout(either via the merchant app or website) ,they are redirected to the MB WAY app, provided it is installed.
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 upon successful payment.
The payment is confirmed on the merchant's side and if the consumer is checking out on a mobile device, they are redirected back to the merchant app or 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.
`specin.inapp`	O	String	N/A	Consumer journey on mobile with seamless redirection.
`specin.merchantredirecturi`	O	String	N/A	Merchant app deeplink where consumer will be redirected after authorising the payment, this is applicable only if specin.app="true"

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.
`SPECOUT.APPINTENT`	C	String	`*`	MB WAY AppIntent URI that has callback parameter , that helps to navigate to merchant website/app once payment is successful

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
&specin.inapp=true //to enable consumer journey on mobile device with seamless redirection//
&specin.merchantredirecturi=amzn://apps/orderID=AS4f?p=PQRE//applicable only if specin.inapp=true//
&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
&SPECOUT.APPINTENT=mbway-qly://ACTDT?c=00100000000003416120&u=amzn://apps/orderID=AS4f?p=PQRE//consumer journey on mobile device with seamless redirection//