Skip to main content
All CollectionsUsing with ShopifyNative Shopify Checkout and Subscriptions
Firmhouse with native Shopify Checkout and Subscriptions
Firmhouse with native Shopify Checkout and Subscriptions
Michiel Sikkes avatar
Written by Michiel Sikkes
Updated over a week ago

Introduction

Firmhouse can now be used in combination with Shopify Checkout and Shopify Subscriptions natively. This works with all subscription payment methods that Shopify supports natively, like credit/debit cards, Apple/Google Pay, and PayPal. In addition as Firmhouse we add the option to use local payment methods for subscriptions on Shopify Checkout.

This native Shopify integration is currently in private beta and our support and onboarding team will guide you in integrating your Shopify shop with Firmhouse. This page explains the ins-and-outs of how the integration works, what is and what isn't (yet) supported and explains how to set things up.

How Firmhouse powers Shopify Checkout natively

Firmhouse adds the capability to your Shopify store to sell your products on subscriptions. When the Firmhouse app is installed on your Shopify store, you can use the Firmhouse Portal to create subscription plans and pricing policies for them.

When subscription Plans are set up in your Shopify store via Firmhouse Portal, you can then move onto implementing subscription options user interface into your Shopify theme. When that's done, you're good to sell subscriptions! πŸŽ‰

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 calls the right subscription payment APIs in Shopify, just like other Subscription apps on Shopify. If you want to offer local payment methods like iDeal and Bancontact, then Firmhouse has a special additional layer to support this, built on native Shopify Checkout.

To manage your customer's subscriptions, you can use the Firmhouse Portal. Your customers can also use the Firmhouse Self Service Center to manage their subscriptions. These features include things 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.

Offering local payment methods like iDeal and Bancontact

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 or Adyen 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.

Installation instructions

In this private beta period there are a few steps that have to be performed by the Firmhouse support and onboarding team. See below which steps are performed by Firmhouse and which steps you can do yourself as merchant.

To connect your Firmhouse project and Shopify store:

  1. Firmhouse: Enables the "one frequency for all products in a subscription" setting on your project.

  2. Merchant: Configure the Firmhouse Shopify product and Order sync integration.

  3. Merchant: In Shopify, tag the products you want to offer on subscription and then sync those products to Firmhouse via the Shopify app in the Firmhouse Portal.

  4. Firmhouse: Creates a special Shopify app for your store and configures connection details it in the Shopify Subscriptions app in Firmhouse Portal.

  5. Merchant: Install the Firmhouse Shopify Subscriptions Shopify app on your Shopify store via the installation link provided by Firmhouse.

  6. Merchant: Create a Plan in Firmhouse Portal for every shipping frequency you want to offer on your products.

  7. Merchant: Sync the Plans created in Firmhouse Portal to Shopify so that Firmhouse creates SellingPlans for each product you want to

  8. Merchant: Configure Mollie or Adyen on your Firmhouse project to support local payment methods for subscriptions, such as iDeal and Bancontact.

  9. Merchant: Configure and enable Mollie payment methods for your Shopify Checkout in Shopify settings.

Update your Shopify store template so that customers can add Selling Plans to their cart

In your Shopify store or page builder you need to implement that a Product's Selling Plans are in some way made available to your customers on your storefront to be added to their cart.

This typically happens by implementing a code snippet that presents the available subscription Selling Plans on your Product Detail Page as a dropdown or selection widget.

In addition, Shopify has a general-purpose guide for developers on how you can add SellingPlan choices to your product detail pages and carts: https://shopify.dev/docs/storefronts/themes/pricing-payments/subscriptions/add-subscriptions-to-your-theme

Local payment methods on Checkout

For local payment methods to be visible on Checkout, the cart line items need to be updated to special local payment Selling Plans that Firmhouse will generate for you.

If you're on Shopify Plus:

If you are on Shopify Plus, then the Firmhouse integration will ensure that on Shopify Checkout the right payment methods are shown and that the right Selling Plans are updated in the Shopify cart depending on which payment method gets chosen.

If you're on a regular Shopify plan:

When you're on a regular Shopify plan (not Plus) and you want to offer local payment methods like iDeal and Bancontact, you need to add an additional "Checkout with iDeal/Bancontact" button to your cart page or cart slide-out. This button converts the subscription plan cart line items into special selling plans so that Shopify shows local payment methods on Checkout.

Follow the following section on our Developer Docs to learn how to add a Checkout button to your store that allows customer to pay for their initial subscription order via local payment methods: Customizations for using SEPA based payment methods during checkout

Supported Capabilities and features

Here's an overview of common capabilities, their status (completed, in development, or on the roadmap), and if they work with local payment method checkouts.

βœ… = supported

🚧 = currently in progress

πŸ”œ = next up

πŸ“ = roadmap

Shopify Subscriptions supported payment method (Cards, PayPal, etc.)

Local payment methods such as iDeal and Bancontact

Paying via native Shopify Checkout

βœ…

βœ… Mollie
🚧 Adyen

πŸ“ Stripe

Separate local payment Checkout via "Checkout with iDeal" for merchants not on Shopify Plus.

βœ…

βœ…

Single Checkout button for all payment methods on Shopify Checkout for merchants on Shopify Plus

🚧

🚧

Recurring order plans

βœ…

βœ…

Uses Shopify SellingPlans

βœ…

βœ…

Shopify Subscription APIs and Subscription Contracts

βœ…

Configure Subscribe&Save Pricing Policies (eg: always 20% off compared to one time sales)

🚧

🚧

Shopify Discount Codes

βœ…

βœ…

Coupon application on first order (eg: free shipping or 5% discount)

βœ…

βœ…

Coupon application on subsequent orders (eg: 5% on your 2nd or 3rd order)

βœ…

πŸ“

Managing subscriptions via Firmhouse Self Service Center

βœ…

βœ…

Managing subscriptions via Firmhouse Portal

βœ…

βœ…

Automatic payment retries and payment dunning flows

πŸ”œ

βœ…

Generate an order manually/on-demand via Firmhouse Portal

πŸ“

βœ…

Invoiced revenue and order synchronization between Shopify and Firmhouse

πŸ”œ

βœ…

Varying frequencies based on product group or catalog category.

πŸ“

πŸ“

Try&Buy, Rental: One shipment, multiple recurring charges

πŸ“

πŸ“

Prepaid and separate billing from shipments

πŸ“

πŸ“

Did this answer your question?