Introducing the Chargebee CLI
chargebee docs

iDEAL via Stripe

iDEAL is a Netherlands-based payment method that allows customers to complete transactions online using their credentials. It is the most preferred online payment method in the Netherlands, with a share of online transactions close to 55%.

In this documentation, we explain how to configure iDEAL via Stripe. Chargebee allows you to configure and process iDEAL payments with Stripe seamlessly. This enhances your business opportunity in the Netherlands.

To configure iDEAL via Stripe, you must have an account with Stripe and should have configured Stripe SEPA. This is because iDEAL is generally used to make one-time payments. In a subscription business, you will be charging your customers on a recurring basis. Therefore, Chargebee handles recurring scenarios by converting all recurring transactions after the first payment to Direct Debit SEPA payments.

See also

Configuring iDEAL via Stripe

  1. Configure Stripe Payment Gateway. If you have already configured it, open the settings page. You can do this by clicking Settings > Configure Chargebee > Payment Gateway > Stripe.
  2. Enable Direct Debit (SEPA). Refer to this document to learn how.
  3. Enable iDEAL (Recurring via SEPA Direct Debit). You have now enabled iDEAL via Stripe.
  4. You need to configure webhooks to get the status of SEPA payments. Learn more about configuring webhooks.
  • You can display iDEAL via Stripe as a payment method using in-app checkout or access it using Chargebee APIs.
  • This integration will not work if you are using in-app browsers.

Email Notifications

To receive Direct Debit emails for this integration, enable Enable Direct Debit emails for Chargebee on the Configure Stripe page.

It is a regulatory compliance of the SEPA scheme to send emails to customers regarding mandate creation and payment pre-notification. You can send this email either from Chargebee or Stripe. The advantage of sending this email from Chargebee is that it allows you to configure elements such as your company logo and signature. If this option is not enabled, Chargebee requests Stripe to send direct-debit emails. Contact Chargebee Support if you want to stop sending direct-debit emails from Stripe. Learn more.

  • For a seamless customer experience, disable Stripe's direct debit notifications and enable them in Chargebee if you prefer Chargebee to manage them. Enabling notifications in both systems will now result in duplicate emails being sent to customers.

Workflow

Here is a sample workflow that you can build in your checkout.

Handling Recurring Payments

iDEAL via Stripe can be used to make the payment only once. Chargebee handles recurring scenarios by converting all the recurring transactions as Direct Debit SEPA payments. Therefore, it is important that you inform this to your customers during Checkout.

Checkout Flow

  1. During Checkout, the customer selects iDEAL as the payment method.

  2. Customer enters the Name and Email, reviews the terms of agreement, and clicks Next.

  3. The customer reviews the details of the order and clicks Pay and subscribe.

  4. After the payment is made, they are redirected to Chargebee's confirmation screen. A subscription is created and all future renewals will be charged using SEPA Direct Debit.