Skip to main content

iDEAL

iDEAL is the most popular online payment method in the Netherlands, allowing users to pay directly from their bank account through a secure, real-time transfer. It's fast and offers immediate payment confirmation.

NetworksFeaturesIntegrationspayment_type
Dutch banks
  • Payment
  • Authorize
  • Capture
  • Refund
  • Partial refund
  • Reverse
  • Register
  • Server-to-Server
  • Checkout Page
  • Pay by Link
  • Payment Page Redirect
ideal

Payment workflow​

The following diagram explains the iDEAL payment workflow for the Payment Page Redirect integration.

iDEAL — Payment Page Redirect
Payer (Consumer)
Merchant (Acceptor)
OneAPI
Bank (iDEAL)
1. Initiates payment and selects iDEAL
2. Create iDEAL payment (Payment API)
3. Returns redirect instructions
4. Redirect to iDEAL bank experience
5. Selects bank and authenticates
6. Displays payment result
7. Redirect to merchant return URL
Payment processing occurs asynchronously — use the postback as the source of truth
8. Postback notification (payment status update)
9. Shows final order confirmation

Scroll horizontally if the diagram is wider than your screen.

  1. 1
    Payer (Consumer)Merchant (Acceptor)

    1. Initiates payment and selects iDEAL

  2. 2
    Merchant (Acceptor)OneAPI

    2. Create iDEAL payment (Payment API)

  3. 3
    OneAPIMerchant (Acceptor)

    3. Returns redirect instructions

  4. 4
    Merchant (Acceptor)Payer (Consumer)

    4. Redirect to iDEAL bank experience

  5. 5
    Payer (Consumer)Bank (iDEAL)

    5. Selects bank and authenticates

  6. 6
    Bank (iDEAL)Payer (Consumer)

    6. Displays payment result

  7. 7
    Bank (iDEAL)Payer (Consumer)

    7. Redirect to merchant return URL

  8. OneAPI

    Payment processing occurs asynchronously — use the postback as the source of truth

  9. 8
    OneAPIMerchant (Acceptor)

    8. Postback notification (payment status update)

  10. 9
    Merchant (Acceptor)Payer (Consumer)

    9. Shows final order confirmation

Integration options​

Choose how you want to accept iDEAL:

Payment Page Redirect

Create a payment via the Payment API and redirect the customer to the iDEAL bank experience to authenticate and authorise.
Start integrating

Checkout Page

Create a checkout session and redirect customers to the hosted checkout. iDEAL is available among the configured payment methods.
Start integrating

Pay by Link

Share a Pay by Link with your customer. When enabled on the channel, they can pay with iDEAL on the checkout.
Start integrating
Last updated on