iDEAL
Intro
iDEAL is the most popular payment method for eCommerce transactions in the Netherlands. It is an online real-time bank transfer payment product that can be used by consumers with a Dutch bank account. By integrating iDEAL on your website you can offer your customers the option to pay directly from their bank account. Consumers are redirected to their banking page where they are requested to authenticate themselves and complete the transaction. After completion, you are able to release the order in real-time.
Key benefits
- Increase your revenue by accepting iDEAL payments
- Non-reversible payments
- No interchange percentage
- Mobile integration via App or mobile website
Netherlands
Integration
We offer this payment methods for the following integration modes. Learn in our dedicated guides about their individual differences:
Find a high level overview in the "Process flows" chapter.
Hosted Checkout Page/Server-to-server
Add the following properties to a standard CreateHostedCheckout/CreatePayment request:
{
"order": {
"amountOfMoney": {
"currencyCode": "EUR",
"amount": 1000
}
},
"redirectPaymentMethodSpecificInput": {
"paymentProductId": "809",
"paymentProduct809SpecificInput": {
"issuerId": "RABONL2U"
}
}
}
| Properties | Remarks |
|---|---|
|
redirectPaymentMethodSpecificInput |
paymentProductId: The numeric identifier of the payment method on our platform. Find this id in the "Overview" chapter. For payments requested via CreateHostedCheckout, it instructs our platform to send your customers directly to the iDEAL-branded version of our Hosted Checkout Page. If left out, our platform sends your customers to the Hosted Checkout Page instead, allowing them to choose this or any other payment method in your account. paymentProduct809SpecificInput.issuerId: Preselect your customers' desired bank on the Hosted Checkout Page. Get a list of all banks available by sending a GetProductDirectory request to our platform. Use this list to adapt the bank selection step on your checkout page accordingly. |
Find detailed information about this object and its properties in our CreateHostedCheckoutAPI/CreatePaymentAPI.
Process flows
- Your customers finalse an order in your shop and select iDEAL
1'(optional). You request a list of available issuers via a GetProductDirectory request. - You send this CreateHostedCheckout/CreatePayment request to our platform.
- You redirect your customers via the redirectUrl (For CreateHostedCheckout requests) or merchantAction.redirectData.redirectURL (For CreatePayment requests) to their issuer to confirm the order.
- We receive the transaction result.
- We redirect your customer to your returnUrl
- You request the transaction result from our platform via GetPayment or receive the result via webhooks.
- If the transaction was successful, you can deliver the goods / services.
Testing
Refer to our Test cases for test data and detailed instructions.
Make sure to use the right endpoint and switch back to the live URL as soon as you have finished your tests.
Additional information
We offer iDEAL in a Full Service model. This means that we also take care of the collection and reporting of the funds.
Refunds can be processed in two ways:
- Submitting a refund action on the order via Refund API (which you can find in the Full API documentation).
- Via the Merchant Portal.