​
About

iDEAL is a popular payment method in the Netherlands which allows users to pay via their online banking interface. It is covered by all the major Dutch commercial banks.
RegionNetherlands
CurrenciesEUR
RefundsYes, within 365 days
DisputesUsers authenticate directly with their bank, so there is no dispute process and a low risk of unrecognized or fraudulent payments
PreauthorizationNo
Recurring paymentsNo

​
How it works

  • On your app or website, the user selects iDEAL as the payment method during checkout, and selects their bank (if the bank selection functionality is implemented using the Bic)
  • The user is redirected (via RedirectURL) to their bank’s interface to authenticate and complete the payment
  • The user is returned to your platform on the ReturnURL
The transaction is complete when the pay-in status changes from CREATED to SUCCEEDED or FAILED, indicating the outcome. You should also set up hook notifications for the relevant event types:
  • PAYIN_NORMAL_SUCCEEDED
  • PAYIN_NORMAL_FAILED

​
Supported banks

When offering iDEAL to your users, you can prompt them to select their bank at checkout. By doing so, you can redirect the user directly to their banking interface to log in and authenticate the payment. The Bic parameter of the Create an iDEAL PayIn endpoint allows you to submit the bank identifier code (BIC) to Mangopay and receive a bank-specific URL in the RedirectURL. If the Bic is not supplied, a generic RedirectURL is provided at which the user must select their bank to continue. Providing a BIC allows you to remove this step of the user experience and thereby facilitate conversion.
Best practice - Allow the user to choose their bank When the user chooses iDEAL, present the list of bank names in a dropdown menu for the user to select. Send the corresponding BIC value in the Bic parameter to take the user straight to their banking interface via the RedirectURL.
Allowed values for the Bic are listed below. The BankName parameter is returned in its place.
BICBank name
ABNANL2AABN AMRO
ASNBNL21ASN
BITSNL2AYoursafe
BUNQNL2ABunq
BUUTNL2ABuut
FVLBNL22Van Lanschot Baniers
INGBNL2AING Bank
KNABNL2HKnab
RABONL2URabobank
RBRBNL21RegioBank
REVOLT21Revolut
SNSBNL2ASNS Bank
TRIONL2UTriodos Bank

Endpoint

The iDEAL PayIn object

Testing

Learn about testing iDEAL