Skip to main content

​
Local payment methods

This guide explains how to enable local European payment methods like iDeal, 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 and/or Bancontact
    • 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, 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/Bancontact” to your cart. With the 2-button setup, customers will have to decide from the cart page whether to pay with iDeal/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 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 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/Bancontact: Customers checking out subscriptions with local payment methods will be redirected to a Firmhouse-powered checkout flow
  • One-time purchases: Regular one-time purchases will use your standard Shopify checkout configuration

​
In Shopify: Enable Mollie-iDeal and/or Mollie-Bancontact as Additional Payment methods

In your Shopify Payments configuration, you need to add Mollie-iDeal 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 and/or Mollie-Bancontact
  5. Follow the prompts to connect your Mollie account
Enabling these additional payment methods won’t make iDeal and/or Bancontact show twice in your one-time purchase checkout.

​
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

​
Done!

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