Skip to main content

Firmhouse Shopify App Setup Guide

All the steps you need to follow to integrate Firmhouse with your Shopify store. 🚀

Michiel Sikkes avatar
Written by Michiel Sikkes
Updated this week

This guide explains all the steps that you as a merchant (in combination with your agency/developer) need to do, to get started with selling subscriptions via Shopify Native Checkout powered by Firmhouse.

Prerequisites

  • A Shopify store (could still be under development).

  • For local payment methods: a Mollie account with the following payment methods enabled:

    • iDeal and/or Bancontact

    • SEPA Direct Debit (mandatory for processing recurring payments)

Let's get started with installing the Firmhouse App in your Shopify store!

Step 1: Install the Firmhouse App in Your Shopify Store

  • Ensure you're logged into your Shopify store.

  • Go to the Firmhouse app on the Shopify app store and click Install.

  • Verify and confirm the installation of the Firmhouse app on your store. Once installed, you will end up in the Firmhouse Portal, and you can continue with the next steps.

In your Firmhouse project, you have a Getting Started menu with a video guide. The guide follows the same steps as this article, so you can also follow the video if that format works better for you. 🤗

Step 2: Sync Your Products from Shopify to Firmhouse

You control which products and variants you want to offer for subscription. To sync your catalog, simply tag your products in Shopify.

  • Tag subscription products with FIRMHOUSE_SUBSCRIPTION.

  • If you also want to offer one-time subscription add-ons in the Firmhouse Self Service Center, tag these products with FIRMHOUSE_ONE_TIME.

When tagged, your products will automatically show up in the Products tab of the Firmhouse portal.

Step 3: Create Your Subscription Plans in Firmhouse

In Firmhouse, go to Plans from the sidebar. Here, you can set up different shipping frequencies for your subscribers — for example, “Every 2 weeks” or “Every 2 months.” These plans will appear to customers when they add products to their cart or manage their subscriptions on the My Account page.

You can also set a discount percentage for each plan. This percentage determines the final product price for customers who subscribe to it.

If you want to offer the same selling plans for all your subscription products, you may create your plans in the Ungrouped plans section:


However, if you want to have specific plans apply to specific products (collections), we advise you to create Selling plan groups first and then create plans for each selling plan group.

🛍️ How to work with selling plans and selling plan groups

Once your plans are created, from the Firmhouse sidebar, go to Apps.

  1. Find the Shopify app and click Configure.

  2. In the app configuration page, go to the Subscriptions tab.

  3. Click Sync now.

The plans are now created in your Shopify store, and you can proceed with adding the "Add subscription to cart" interface on your product detail pages in the next steps.

Step 4: Add or Build Subscription Options on Your Product Detail Pages

Now it's time to add the subscription options to your product detail pages, so your customers can add them to their cart. There are two ways to do this:

  1. Use one of the standard Firmhouse Subscription Options widgets. (for Shopify 2.0 supported themes)

  2. Build or modify your existing custom subscription widget.

4.1: Add the standard Firmhouse Subscription Options widget (recommended)

  1. In the Shopify theme editor, select the Product template page you want to edit.
    For example: Products > Default product

  2. In the sidebar under Template in the Product information, click Add block.

  3. Switch to the Apps tab in the Add block section and click Subscription Options or Subscription First widgets.

  4. If you want, customize your widget to match your branding.

4.2: Build a custom subscription widget

If you have specific wishes for your subscription widget that the Firmhouse standard widget does not cover, you can also build your own. The article below covers the general guidelines to get you started.

Step 5: 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 6: 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.

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.

If you are on Shopify Plus, you can add a checkout widget that enables customers to switch between SEPA and Card payments directly in the checkout.

6.1: (non-Shopify Plus) Enable the Checkout Button Injector app embed

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.

💡 Checkout Button app embed settings explained

6.2: (Shopify Plus) Add the Checkout Widget and Enable SEPA Support App Block

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 7: 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 and CC: powered by Shopify Payments

  • Subscriptions with iDeal and Bancontact: powered by Mollie

  • Standard one-time purchases: powered through the setup you currently have on your store

In Shopify: Configure a payment provider to support subscriptions with PayPal and CC

The default and easiest option to power PayPal and CC subscriptions is via Shopify Payments. If that is not a viable option for your company, Shopify offers some alternatives: Supported payment gateways for Shopify Subscriptions

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

In your Shopify Payments configuration, you will have to add Mollie-iDeal and/or Mollie-Bancontact as Additional Payment methods to support subscription checkouts with these payment methods.


Don't worry! 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 and site profile 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 Credit Card, PayPal, iDeal, or Bancontact. The subscription should appear in the Customers overview in the Firmhouse Portal shortly after.

Recommended next steps

This guide has taken you through all the steps to successfully get Firmhouse and Shopify linked. To ensure your Firmhous project is also fully configured and ready to support recurring order generation without a hitch, we recommend you also follow the guide: ⚙️ Configuring your Firmhouse project settings (with Shopify native)

Did this answer your question?