Important information

The API reference is now available here.
The deprecated API reference is available here.



Learn more about iDeal and payment workflow.

iDEAL is one of the most popular online payment methods in the Netherlands. It generates a SEPA Credit Transfer from within the consumer’s trusted online banking portal. By using iDEAL, consumers are able to pay for their online purchases in a user-friendly, cost-efficient, and safe way. iDEAL supports the SEPA transfers mainly through Dutch banks.

Available inSupported currenciesRedirectRefundPartial RefundReversalChargebackRecurringPayoutPay laterUnzer Secured


  • Payment security: The customer authenticates on their bank site, so there is no confidential data shared between the merchant and the customer.
  • Increased customer confidence: The customer does not need to go to any unknown portal to make the payment, and hence the possibility for a successful transaction is higher.
  • Supported by all banks in the Netherlands

Payment workflow

The following diagram explains workflow for iDEAL payments.

iDEAL workflow

Step 1: Create an ideal payment type resource.

A resource ID is generated in the response and is used in the workflow to complete the payment.

Step 2: Make a charge transaction with the ideal resource that you created.

Step 3: Forward the customer to the redirectUrl that is displayed in the charge response.

Step 4: Once the customer makes the payment on their bank portal, redirect the customer to the returnURL specified in the initial charge call.

Step 5: After the transaction, display the result to the customer in the front end of the online shop.

Integration options

Quickly integrate with Unzer without any programming knowledge

Use pre-built, configurable all-in-one pages with your own mix of payment methods

Use pre-built forms and quickly integrate with minimum work on the client side

Integrate with Unzer using your own payment form