Skip to main content
This guide explains how to enable local European payment methods like iDEAL | Wero, Bancontact, SEPA Direct Debit, Pay by Bank, Pay by invoice, Trustly, and SEPA Bank Transfer for your Shopify subscriptions powered by Firmhouse.

​
Prerequisites

Before you begin, make sure you have:
  • Completed the Quick install on Shopify guide
  • A Mollie account with the following payment methods enabled:
    • iDEAL | Wero and/or Bancontact
    • Pay by Bank if you want to offer Pay by Bank in Shopify checkout
    • SEPA Direct Debit (mandatory for processing recurring payments)

​
Step 1: Enable Subscription Widgets

Enable the two supporting app embeds, which ensure the local payment method checkouts will work as expected:
  • SEPA Plan Support
  • Product Price Sync

​
Step 2: Add a Checkout Button to power Local Payment Methods

Because Shopify doesn’t fully support iDEAL | Wero, Bancontact, and SEPA for subscriptions, you’ll need to adapt your cart and/or checkout to allow customers to take out subscriptions with these payment methods.

​
Option 2.1: For non-Shopify Plus stores

If you’re not on Shopify Plus, you will have to add a second “Go to checkout button with iDEAL | Wero/Bancontact” to your cart. With the 2-button setup, customers will have to decide from the cart page whether to pay with iDEAL | Wero/Bancontact or CC/PayPal when they reach the checkout page. In your Shopify theme editor, enable the Checkout Button Injector. You can configure when to show the SEPA checkout button, the CC/PayPal checkout button and the regular Shopify checkout button. We recommend you use the Button Display Mode “Two buttons for subscriptions”. This will ensure you show 2 buttons for subscription and mixed carts while keeping your existing button and checkout behavior for one-time purchases.

​
Option 2.2: For Shopify Plus stores

If you are on a Shopify Plus plan, you can add a custom checkout widget directly to your cart. This widget, called the “Local Payment Method Switcher,” allows your customers to toggle between two payment options during checkout:
  1. Local Payment Methods like iDEAL | Wero and Bancontact
  2. Regular Payment Methods such as credit cards and PayPal
Follow these steps to integrate the “Local Payment Method Switcher” app block:
  1. From your Shopify admin, go to Settings > Checkout
  2. In the Configurations section, click Customize next to the checkout configuration that you want to edit
  3. In the checkout and accounts editor, ensure that the Checkout page is selected, and click the apps icon to access the Apps sidebar
  4. Click the + Add app block button next to “Local Payment Method Switcher”
  5. In the popup, select Checkout to add it to the page
  6. Customize the widget as needed
  7. Click Save
This allows you to integrate Firmhouse’s subscription options and enable payment methods like iDEAL | Wero and Bancontact directly in your checkout flow.

​
Step 3: Configure your payment service providers for subscriptions

When powering subscriptions with Firmhouse on Shopify, you must make some changes to your Shopify payment settings and Firmhouse payments configuration. Once done, your customers will have three variations of the Shopify checkout that offer different payment methods, depending on what the customer is purchasing. A standard setup will look like this:
  • Subscriptions with PayPal/Credit Card: Customers checking out subscriptions with PayPal or Credit Card will use the standard Shopify checkout
  • Subscriptions with iDEAL | Wero/Bancontact: Customers checking out subscriptions with local payment methods will use the Shopify checkout with Firmhouse-enabled local payment methods through Adyen or Mollie
  • One-time purchases: Regular one-time purchases will use your standard Shopify checkout configuration

​
In Shopify: Enable Mollie-iDEAL | Wero and/or Mollie-Bancontact as Additional Payment methods

In your Shopify Payments configuration, you need to add Mollie-iDEAL | Wero and/or Mollie-Bancontact as Additional Payment methods to support subscription checkouts with these payment methods.
  1. From your Shopify admin, go to Settings > Payments
  2. Scroll down to the Additional payment methods section
  3. Click Add payment methods
  4. Search for and enable Mollie-iDEAL | Wero and/or Mollie-Bancontact
  5. Follow the prompts to connect your Mollie account
  6. When connecting Mollie, make sure you use the same Mollie profile that is configured as the payment provider in Firmhouse
Enabling these additional payment methods won’t make iDEAL | Wero and/or Bancontact show twice in your one-time purchase checkout.

​
In Shopify: Install the Mollie Pay by Bank app

To offer Pay by Bank for subscription checkouts on Shopify, you also need to install the Mollie Pay by Bank Shopify app.
  1. Open the Mollie Pay by Bank app in the Shopify App Store
  2. Install the app in the Shopify store that uses Firmhouse for subscriptions
  3. Follow Mollie’s Shopify app installation guide to complete the setup
  4. When prompted to connect Mollie, select the same Mollie profile that is configured in Firmhouse > Settings > Payments
Using a different Mollie profile in Shopify than the one linked in Firmhouse will break the subscription payment flow, so this matching setup is essential.

​
In Firmhouse: Add Mollie to your Firmhouse project

Configure your Mollie account as a payment provider in Firmhouse:
  1. From the Firmhouse sidebar, under Settings go to Payments
  2. Choose Mollie from the payment provider options
  3. Enter your Mollie live API key that you can copy-paste from your Mollie dashboard under the […] More > Developers menu
  4. Click Save

​
Testing SEPA Direct Debit

To verify that SEPA Direct Debit recurring payments are set up correctly, you don’t have to wait for the next billing cycle. Follow these steps:
  1. Subscribe via the regular checkout flow — go to your store and complete a subscription checkout using iDEAL | Wero or Bancontact.
  2. Check the mandate — open the subscription in the Firmhouse Portal, go to the Mollie payment provider details, and confirm that a SEPA Direct Debit mandate was created.
  3. Trigger an immediate charge — on the subscription’s Active products overview, click Ship now on a product. This generates a charge and order right away using the SEPA Direct Debit mandate, so you can confirm the full recurring flow works without waiting.

​
Done!

Go to your store, add a subscription option to the cart, and enjoy checking out the subscription products with iDEAL | Wero or Bancontact. The subscription should appear in the Customers overview in the Firmhouse Portal shortly after.