About MB Way

General information about MB Way

Logo

Info

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.

Type

Payments by Online Bank Transfer

Further information can be found on the webpage of MB Way (https://www.mbway.pt/).

Process flow chart

MB Way process flow

interface

Payment with MB Way via form interface

To make a MB Way payment via PPRO over a form, please use the following URL:

mbway.aspx

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of delivered products, services etc.	Beschreibung der gelieferten Waren, Dienstleistungen usw.

Key	Format	CND	Description	Beschreibung
Language	a2	O	2-letter language code (e.g. de) that should be preferred when presenting payment pages to the consumer	2-stelliger Sprachcode (z. B. de), der bei der Darstellung von Zahlungsseiten für den Kunden bevorzugt werden sollte
AccOwner	ans3..50	M	Name of account holder	Name des Kontoinhabers
Phone	ns..100	O	Customer’s phone number. Country code followed by hash symbol # followed by rest of number. Only digits and hash allowed.	Telefonnummer des Kunden. Ländercode gefolgt von einem Rautenzeichen #, gefolgt vom Rest der Zahl. Nur Ziffern und Rautenzeichen erlaubt.
AddrCountryCode	a2	O	Country code for the account holder’s invoicing address, 2 characters according to ISO 3166. Only PT allowed, defined within the code.	Ländercode der Rechnungsadresse des Kontoinhabers zweistellig gemäß ISO 3166. Nur PT zulässig, im Code festgelegt.

Parameters for payments with MB Way

Return parameters for URLSuccess, URLFailure and URLNotify with MB Way

Credit with reference

credit.aspx

Parameters for credits via socket connections

Response parameters for credits with MB Way via socket connections

Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing a refund for MB Way and which information can be found within the response file about the payment status.

Following table gives an overview of all batch versions that are possible for a specific action an their specialities:

Action	Version	Description	Beschreibung
Credit	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)

Description of the possible batch versions

The structure for MB Way within a Batch file to be submitted is the following:

HEAD,<MerchantID>,<Date>,<Version>
MBWAY,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>  
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Key	Format	CND	Description	Beschreibung
Type	a..11	M	HEAD for Header, FOOT for Footer, MBWAY for MB Way	HEAD für Header, FOOT für Footer, MBWAY für MB Way
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks the following way:

HEAD,<MerchantID>,<Date>,<Version>
MBWAY,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Description of result parameters within the record for Batch files