Online-banking in Netherlands (IDEAL)
Online banking in the Netherlands is processed through direct payment requests.
| Parameter | Type | Required | Description |
|---|---|---|---|
pos_id | UUID | ✅ | Merchant's identifier (POS_ID) |
mode | MODE | ✅ | direct |
method | METHOD | ✅ | Payment method (purchase) |
amount | Number | ✅ | Transaction amount. Must be a positive number |
currency | CURRENCY | ✅ | Transaction currency (ISO_4217) |
order_3ds_bypass | String | ✅ | 3-D Secure flow option |
order_id | String | ✅ | Unique identifier of order |
description | String | ✅ | Payment description |
payway | String | ✅ | banking |
customer_fname | String | ✅ | Customer's first name |
customer_lname | String | ✅ | Customer's last name |
customer_email | String | ✅ | Customer's email |
properties.instrument_type | String | ✅ | Instrument type (online_banking) |
properties.instrument_method | String | ✅ | Instrument method alias (BANK_IDEAL) |
server_url | URL | Webhook notification will be sent to this URL | |
result_url | URL | Customer will be redirected to this URL after payment | |
browser_fingerprint | JSON | Browser fingerprint. These parameters could be used in 3DS 2.0 verification. |
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",
"customer_phone": "900000000",
"customer_country": "FR",
"customer_city": "Paris",
"customer_birthday": "1990-01-01",
"order_3ds_bypass": "supported",
"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",
"browser_fingerprint": {
"browserScreenHeight": "860",
"browserScreenWidth": "1600",
"browserJavaEnabled": "false",
"browserLanguage": "fr-FR",
"browserTimeZone": "Europe/Paris",
"browserTimeZoneOffset": "-120",
"browserAcceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
"browserIpAddress": "127.0.0.1",
"browserUserAgent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.146 Safari/537.36"
}
}