Introduction
Firmhouse can now be used in combination with Shopify Checkout and Shopify Subscriptions natively. We support all the payment methods that Shopify Subscriptions supports natively. In addition we allow you to add certain local payment methods like iDeal and Bancontact for paying for subscriptions as well.
This page explains the ins-and-outs of how the integration works, what is supported now, and what we're working on as part of our roadmap.
👉 Our native Shopify Checkout integration is currently in public beta but we're happy to help you get set up and take all your feedback so we can iterate, improve, and prioritize the most important next steps in our integration.
Please review Supported Checkout and Subscription capabilities for an up-to-date list on current and upcoming features and improvements.
How Firmhouse powers Shopify Checkout natively
The Firmhouse Shopify app adds subscription capabilities to your Shopify store. After you install our app, you can define plans and their discount policies with Firmhouse. These plans then become available for your customers to choose from and add to their cart. You can use our standard subscription option theme block to get up&running quickly. Or you can build your own subscription selection widget in your own store.
After subscriptions have been checked out by your customers, Firmhouse's billing logic will kick in and ensure your customers are charged at the right moments. And that failed payment and payment dunning flows are followed.
If customers check out with a payment method natively supported by Shopify Subscriptions (cards, PayPal), then Firmhouse uses Shopify Subscriptions. If you want to offer local payment methods like iDeal and Bancontact, then Firmhouse has a special additional layer to support this, built for native Shopify Checkout.
Your subscribers can use the Firmhouse Customer Portal to manage their subscriptions. The customer portal includes features like pausing, cancelling, modifying products, and more. The Firmhouse Self Service Center can be linked to your storefront so you can provide a seamless experience to your customers.
To manage your customer's subscriptions as a merchant, you can use the Firmhouse Portal. You can access the Firmhouse Portal from your Shopify store. Or you can invite team members to log straight into Firmhouse Portal for performing day-to-day actions like updating address details, changing products, or cancelling/pausing subscriptions.
Support for iDeal and Bancontact for Subscription checkouts
Firmhouse allows your customers to check out your product's subscription plans via local payment methods like iDeal and Bancontact.
This is done by configuring a supported payment provider like Mollie* in your Shopify store and in your Firmhouse project. In your Shopify store you can then activate the supported local payment methods on your Shopify Checkout as payment options. When a subscriptions is checked out via a local payment method, Firmhouse's own subscription engine will take care of billing, order generation, and subscription management.
*We're currently working on supporting Adyen as well.
Installation & setup instructions
If you do not have a project on Firmhouse yet:
Make sure you're logged in to your Shopify store.
Verify that your payment provider in Shopify is set to one of the payment providers that is supported by Shopify for subscriptions: Supported payment gateways for Shopify Subscriptions
Go to the Firmhouse app on the Shopify app store and click Install.
Verify and confirm the installation the Firmhouse app on your store. Once installed you will end up in the Firmhouse Portal.
In the Firmhouse Portal, go to Plans and create plans for the frequencies and discounts you want to sell your products on.
In Shopify from the product or product variant management screen, add products to the Firmhouse subscription options.
In the Shopify theme editor, add the Firmhouse selling options theme block to your Product Detail page. Or optionally, develop your own subscription options widget in your theme.
Optionally: Set up iDeal and Bancontact support for Subscription Checkouts in Shopify and Firmhouse with Mollie.
Start selling subscriptions!
If you're already on Firmhouse:
Get in touch with Firmhouse support so that we can do a sanity check together with you if your current project setup is compatible with subscriptions on Shopify. Then follow the following steps:
In Firmhouse Portal, got to Apps in the sidebar and find the new "Subscriptions using Shopify" app and click Configure.
In the Your Shopify Store Domain enter your store domain
<yourstore>.myshopify.comClick Save
Now follow the instructions above for a store that is not on Firmhouse yet.
Update your Shopify store template so that customers can add Selling Plans to their cart
The easiest and most flexible way to allow customers to select and add Selling Plans (subscription options) to their cart is by using our Shopify theme widgets. These widgets are designed to integrate seamlessly with your storefront—no coding required.
Use Firmhouse Shopify Widgets (Recommended)
We offer two theme blocks that you can add directly from the Shopify theme editor:
1. Subscription Options Widget
This widget displays all available subscription plans for a product and supports three layouts:
Pills – Display all options one under the other.
Dropdown – Display all options in a dropdown menu.
Cards – Show subscription options in cards and the one-time purchase option in a separate card.
This layout also supports:Custom descriptions for each plan
Default selected subcription option
📘 Learn how to configure this layout in the Subscription Options Widget Card Layout Customizations guide.
2. Subscription First Widget
This widget displays subscription plans separately, one-time purchase options together in a dropdown. You can:
Configure which variants are available for one-time purchase or subscription
Set custom descriptions, option titles, pricing, and discounts for each plan
📘 For full setup instructions, visit the Subscription First Widget guide.
Which widget should I use?
Use the Subscription Options Widget if you want to support variant selection (e.g., color, size) on the product detail page.
Use the Subscription First Widget if you have multiple variants which needs to be offered with a different selling plan, but some still need to be available as a one-time purchase.
For example, you may have 4-packs, 8-packs and 16-packs packaging for your product and you can offer 4-packs with every week, 8-packs with every 2 weeks, and 16-packs for every month option, while keep offering all some of the options as one time purchases.
Want more control?
If you prefer to create a custom experience or need something more tailored, you can implement your own subscription widget using custom code. Follow our guide in the Firmhouse Developer Docs to learn how to display Selling Plans on your Product Detail Page:
Developer Guide: Add subscription options to your product detail pages and cart
Local payment methods support on Checkout
For all stores
To support local payment methods like iDeal or Bancontact, start by enabling the SEPA Plan Support App Embed block from Firmhouse in the Shopify theme editor.
If you're not on Shopify Plus:
You must display an additional "Checkout with iDeal/Bancontact" button on your cart page or drawer. This button ensures that subscription plan items in the cart are converted into special selling plans so Shopify can show local payment methods on the checkout page.
Enable the Checkout Button Injector app embed from Firmhouse in the Shopify theme editor to add this button easily. From the widget settings, you can:
Customize the button style and text
Choose which payment method icons to show
Configure when the button should appear via the Button Display Mode setting (e.g., only show if the cart contains subscription items)
If you're on Shopify Plus:
Open the theme editor in Shopify.
Navigate to Checkout and customer accounts.
In the Payment section, click Add app block.
Select the Local Payment Method Switcher block from Firmhouse.