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.
iDEAL is also available for Full Service.
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"
}
}
| Properties | Remarks |
|---|---|
|
redirectPaymentMethodSpecificInput.paymentProductId |
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 omitted, our platform sends your customers to the Hosted Checkout Page instead, allowing them to choose this or any other payment method that is active in your account. paymentProduct809SpecificInput.issuerId: [DEPRECATED] 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. As from July 1st 2024, our platform will ignore this property. |
Find detailed information about this object and its properties in our CreateHostedCheckoutAPI/CreatePaymentAPI.
Process flows
- Your customers finalise an order in your shop and select iDEAL.
- 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. We update the transaction to statusOutput.statusCode=46.
If we do not receive a transaction result within this time frame, we update the transaction to statusOutput.statusCode=2. - Your customers login to their online banking account to confirm the order. If our platform does not receive a final transaction result before the redirection to the Worldline status page (Step 4'.), we update the transaction to statusOutput.statusCode=51.
4'(optional). For CreateHostedCheckout requests: We redirect your customers to the Worldline status page, displaying the transaction result. - We receive the transaction result.
- We redirect your customer to your returnUrl.
- You request the (intermediate) transaction result from our platform via GetPaymentDetails/GetHostedCheckout or receive the result via webhooks.
6'(optional). For transactions in statusOutput.statusCode=51: iDEAL provides us with the final transaction status. We update the transaction to statusOutput.statusCode=2 or 9. - If the transaction was successful (statusOutput.statusCode=9), 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.
To use this option, you need to sign a Full Service contract. There are two options to fully activate the service:
- With Tunz (Worldline Financial Solutions): Contact us, your sales manager or send an e-mail to ecomsalesnl@worldline.com.
- With PASS (Worldline Financial Services Europe) via self-boarding.
iDEAL via Full Service allows you to process refunds via both our API or the Merchant Portal.