Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in
OverviewAccept a paymentUpgrade your integration
Online payments
OverviewFind your use case Recurring payments
In-person payments
Payment methods
Payment operations
Balances and settlement time ReceiptsRefunds and cancellations
Advanced integrations
Beyond payments

Accept an iDEAL | Wero payment

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

Caution

Stripe can automatically present the relevant payment methods to your customers by evaluating currency, payment method restrictions, and other parameters.

  • Follow the Accept a payment guide to build a Checkout integration that uses dynamic payment methods.
  • If you don’t want to use dynamic payment methods, follow the steps below to manually configure the payment methods in your Checkout integration.

iDEAL | Wero (formerly iDEAL) is a single use payment method where customers are required to authenticate their payment. Customers pay with iDEAL | Wero 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 | Wero, you must comply with our iDEAL Terms of Service.

Determine compatibility

A Checkout Session must satisfy all of the following conditions to support iDEAL | Wero 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.

This guides you through enabling iDEAL | Wero and shows the differences between accepting payments using dynamic payment methods and manually configuring payment methods.

Enable iDEAL | Wero 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.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=eur \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=ideal \
  --data-urlencode success_url="https://example.com/success"

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

Test your integration

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

Handle refunds and disputes

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

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

See also

Proxying: stripe.com/docs/payments/checkout/one-time/ideal ✕