Skip to content
Create account
 or
Sign in
The Stripe Docs logo
/
Create account
Sign in
OverviewUpgrade your integration
Online payments
OverviewFind your use case
Payment methods
Payment UIs
Payment scenarios
In-person payments
Other Stripe products

Accept an iDEAL payment

Learn how to accept iDEAL, a common payment method in the Netherlands.

Caution

Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.

If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, update your integration to configure payment methods in the Dashboard.

iDEAL is a single use payment method where customers are required to authenticate their payment. Customers pay with iDEAL by redirecting from your website, authorizing the payment, then returning to your website where you get immediate notification on whether the payment succeeded or failed.

Note

To accept iDEAL, you must comply with our iDEAL Terms of Service.

Determine compatibility

A Checkout Session must satisfy all of the following conditions to support iDEAL payments:

  • Prices for all line items must be expressed in Euro (currency code eur).

Accept a payment

Note

This guide builds on the foundational accept a payment Checkout integration.

Use this guide to learn how to enable iDEAL—it shows the differences between accepting a card payment and using iDEAL.

Enable iDEAL as a payment method

When creating a new Checkout Session, you need to:

  1. Add ideal to the list of payment_method_types
  2. Make sure all your line_items use the eur currency
Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'ideal'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `ideal`, all line items must have currency: eur
      currency: 'eur',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

Test your integration

When testing your Checkout integration, select iDEAL as the payment method and click the Pay button.

Handle refunds and disputes

The refund period for iDEAL is up to 180 days after the original payment.

There is no dispute process—customers authenticate with their bank.

See also

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our product changelog.
Questions? Contact Sales.
Powered by Markdoc