Skip to main content

Online banking in Portugal

Online banking in Portugal is processed through direct payment requests.

ParameterTypeRequiredDescription
pos_idUUIDMerchant's identifier (POS_ID)
modeMODEdirect
methodMETHODPayment method (purchase)
amountNumberTransaction amount. Must be a positive number. Minimum amount is 5 EUR
currencyCURRENCYTransaction currency (ISO_4217)
order_3ds_bypassString3-D Secure flow option
order_idStringUnique identifier of order
descriptionStringPayment description
paywayStringbanking
customer_fnameStringCustomer's first name
customer_lnameStringCustomer's last name
customer_emailStringCustomer's email
customer_phoneStringCustomer's phone
customer_countryStringCustomer's country (ISO 3166-1 alpha-2). For instance, PL for Poland
customer_cityStringCustomer's city
customer_birthdayStringCustomer's birthday (yyyy-MM-dd)
customer_ipStringCustomer's IP address
properties.instrument_typeStringInstrument type (online_banking)
properties.stateStringCustomer's state
properties.post_codeStringCustomer's post code
properties.addressStringCustomer's address
server_urlURLWebhook notification will be sent to this URL
result_urlURLCustomer will be redirected to this URL after payment

Request example:

{
"pos_id": "00000000-0000-0000-0000-000000000000",
"mode": "direct",
"amount": 5,
"method": "purchase",
"currency": "EUR",
"payway": "mbway",
"customer_fname": "Jon",
"customer_lname": "Dou",
"customer_email": "test@gmail.com",
"customer_id": "cust_PT_456",
"customer_country": "PT",
"customer_city": "Lisboa",
"customer_ip": "1.1.1.1",
"customer_phone": "351912345678",
"customer_birthday": "1990-01-01",
"properties": {
"instrument_type": "online_banking",
"address": "test Liberdade 110",
"state": "Lisboa",
"post_code": "1250-146"
},
"order_id": "1234567890",
"description": "payment 231Hehws-1",
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://google.com"
}