Payment Methods
Providers
Direct iDEAL
{
"id": "7bb6f1f3-d280-4b0c-a74f-90471ea69426", // Auto-generated UUID
"paymentMethod": "ideal",
"returnUrl": "http://example.com", // URL to return after payment completion.
"webhookUrl": "https://example.com", // URL to receive webhook notification.
"transaction":{
"reference": "test-1111", // Max 20 characters
"currency": "EUR", // ISO4217 format
"amount": 2000, // The amount is in cents, 2000 = 20 EUR. Has to be sum of amounts * quantity in lines.
"description": "test-1444",
"lines":[
{
"name": "Some Voucher - 20 EUR", // Max 100 characters. Name of product.
"category": "PREPAID-VOUCHER", // Max 100 characters.
"brand": "alphacomm", // Max 100 characters.
"quantity": 1, // Number of items
"amount": 2000 // The amount is in cents, 2000 = 20 EUR
}
]
}
}
Direct iDEAL Sandbox - Banks
Since 2025 april all itegration of select banks will be optional since select of the bank
will be done on providers sides.
List with available ids can be viewed in call "api/v1/get-methods"
"ideal": {
"issuerId": "RABONL2U"
},
For sandbox payments use next amounts in request to trigger specific response
- 100 - Success
- 200 - Canceled
- 300 - Expired
- 400 - Open
- 500 - Fail
- 600 - Success
- 500 - Exception trigger: Fail
Merchant Configuration
- privateKey - sha256 key generated and set in config in dashboard and bank
- publicKey - sha256 key generated and set in config in dashboard and bank
- certificate - sha256 key generated and set in config in dashboard and bank
- acquirerUrl - Provided by bank provider
- MerchantId - Set in iDEAL config on bank side
- subId - Usually 0 unless defined in iDEAL as subset