HomeDocumentationAPI Reference
Documentation

iDEAL

About

iDeal Logo

iDEAL is an online payment method in the Netherlands. This payment method allows shoppers to use direct online transfers from their bank account to purchase goods online. Participating banks change from time to time, but may include: ABN AMRO, ASN Bank, bunq, Friesland Bank, ING Bank, Knab, Rabobank, RegioBank, SNS Bank,Triodos Bank and Van Lanschot.

iDEAL holds over 50% of the market share in the Netherlands.

Payment Flow

Video Walkthrough of the iDEAL Shopper Journey

Source: https://www.ideal.nl

Properties

Type of Payment
Online
Chargebacks
Yes, as payments are not guaranteed. However, there is a very **low** risk of chargebacks since it is a real-time transfer.
Consumer Currency
EUR
Consumer Country
Netherlands (see FAQ below)
Expiry Period
URL Expiry - The URL returned for online payment methods is generally only valid for a few minutes.
Recurring Payments
No
Partial Payment
No
Refunds
Yes. This payment method has a refund period of 180 days.

FAQ

  • iDEAL works on all mobile devices with an internet connection and a web browser.
  • iDEAL is supported by all browsers that support online banking. That includes the most frequently-used browsers like Internet Explorer, Google Chrome and Firefox.
  • The Shopper must have a Netherlands-based billing address

Best Practices

The shopper journey should generally follow the guidelines below:

  1. The shopper selects iDEAL as the payment method.
  2. The shopper selects their preferred bank on the merchant site.
  3. The merchant creates a Reach order and returns an iDEAL authentication URL.
  4. Reach creates an iDEAL transaction, which triggers behind-the-scenes communication between an acquiring bank and the shopper's bank.
  5. The Shopper is redirected to her bank to log in and confirm payment.
  6. Reach sees that the iDEAL payment has been completed (the shopper's bank has sent the acquirer's bank a guarantee of payment).
  7. The shopper is redirected back to the merchant confirmation page for receipt of payment. Merchant can proceed to ship goods.

Technical Considerations

  • It's important to remember that there is no pre-authorization on iDEAL transactions.
  • iDEAL does not have 100% uptime. iDEAL availability is accessible on the iDEAL Availability Dashboard
  • The shopper's bank must be specified in the Issuer field of the /checkout request API call. The getPaymentMethods returns a list of acceptable banks.
  • To get the result of the/checkout request, include an IssuerId (getPaymentMethods returns a list of Issuers, and the customer can choose which they would like) and RedirectUrl.
  • The Shopper must have a Netherlands-based billing address

Testing

  • iDEAL requires extra effort to test, but since it is an online payment method, no special values are needed to test the checkout process. Contact Reach's technical team when you're ready to start testing.
  • Include an IssuerId (a list of Issuers is returned by getPaymentMethods and the customer can choose which they would like) and RedirectUrl in the /checkout request in order to get the result of the /checkout request.

Related Information

iDEAL availability is accessible on the iDEAL Availability Dashboard