Skip to main content

Online-banking in Netherlands (IDEAL)

Online banking in the Netherlands is processed through direct payment requests.

ParameterTypeRequiredDescription
pos_idUUIDMerchant's identifier (POS_ID)
modeMODEdirect
methodMETHODPayment method (purchase)
amountNumberTransaction amount. Must be a positive number
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
properties.instrument_typeStringInstrument type (online_banking)
properties.instrument_methodStringInstrument method alias (BANK_IDEAL)
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": 15,
"method": "purchase",
"currency": "EUR",
"payway": "banking",
"customer_fname": "Jane",
"customer_lname": "Doe",
"customer_email": "viktoria@gmail.com",
"properties": {
"instrument_type": "online_banking",
"instrument_method": "BANK_IDEAL"
},
"description": "test",
"order_id": "1234567890",
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://google.com"
}