Skip to main content
You can use a Kaching Bundles widget on your Shopify storefront while Firmhouse manages the subscriptions and recurring discounts. The integration requires some additional setup. You need to enable the Firmhouse theme app embeds, show only Firmhouse selling plans in the Kaching widget, and keep the discount configuration in Kaching and Firmhouse aligned.

​
Before you begin

Make sure that:
  • Firmhouse is connected to your Shopify store.
  • Your subscription products and selling plans have been synced to Shopify.
  • The Kaching widget is configured wherever you want it to appear on your storefront.
  • You have completed the local payment method setup if you offer subscription payments through iDEAL/Wero, Bancontact, or another supported local payment method.

​
1. Enable the Firmhouse app embeds

In Shopify Admin:
  1. Go to Online Store > Themes.
  2. Click Customize for the theme you want to update.
  3. Open App embeds.
  4. Enable SEPA Plan Support.
  5. If your store is not on Shopify Plus, enable Checkout Button Injector.
  6. Click Save.
The SEPA Plan Support app embed creates the additional selling-plan mapping needed for local payment method subscriptions. The Checkout Button Injector adds the local-payment checkout route to non-Shopify Plus storefronts. See Configure the Checkout Button Injector for its settings and troubleshooting guidance.

​
2. Confirm only Firmhouse selling plans are shown

The SEPA Plan Support app embed automatically hides non-Firmhouse selling plans from the Kaching subscription selector. You do not need to add custom Liquid or JavaScript to the page. This works automatically when:
  • The Kaching app embed is enabled.
  • The Kaching subscription selector is displayed on the storefront.
  • The selector contains Firmhouse selling plans.
Only Firmhouse selling plans remain available in Kaching. Firmhouse can then map the selected plan to the correct local-payment plan during checkout. The app embed also watches the Kaching widget for re-renders and hides any non-Firmhouse plans that are added again.

​
3. Match the discount configuration

Configure the same quantity thresholds and percentage discounts in both Kaching and Firmhouse:
  • Kaching controls the offer displayed in the widget and its matching Shopify checkout discount.
  • Firmhouse controls the matching discount on the subscription and its recurring orders.
Firmhouse tiered discounts are percentage-based. Fixed-price offers configured in Kaching are not supported. Change any fixed-price tier in Kaching to Full price, or replace it with a percentage-based offer that can be configured identically in Firmhouse. Percentage discounts must use whole numbers, such as 10% or 15%. Floating-point percentages, such as 10.5%, are not supported because Shopify does not allow them for discounts applied to subscription contracts after checkout. A full-price quantity tier can include an additional free unit. For example, buy 2 at full price and get 1 free is supported. An additional free unit cannot be combined with a percentage discount in the same Kaching offer, so buy 2 with 10% off and get 1 free is not supported. Kaching A/B tests that use different discount amounts for each variant are also not supported. If you run an A/B test, configure the same discount amount for both variants so the Kaching widget, Shopify Checkout, and recurring subscription orders remain consistent. When you create the matching Firmhouse discount, set Limit discount per customer to to Unlimited. After saving, activate the Firmhouse discount so it applies to recurring orders. Firmhouse uses the discount amount and this unlimited recurring-cycle limit to match the Kaching discount to the correct Firmhouse discount.

​
Supported discount examples

  • Percentage discount: Buy 2 and save 10%. Configure the same quantity threshold and percentage in Firmhouse.
  • Multiple percentage tiers: Buy 1 at full price, buy 2 and save 5%, or buy 3 and save 10%. Configure every tier identically in Firmhouse.
  • Full price: Buy 2 at the regular unit price. Select Full price in Kaching and do not configure a discount for that tier in Firmhouse.
  • Full price with a free unit: Buy 2 at full price and get 1 free. In Firmhouse, set the minimum quantity to 3 (2 purchased units plus 1 free unit) and apply a 100% discount to 1 unit. Configure the same offer in Kaching.
  • A/B variants with the same discount: Variant A and Variant B both offer 10% off when buying 2. The presentation can differ, but the discount amount must remain the same.

​
Unsupported discount examples

  • Fixed total price: Buy 2 for €30. Replace this with Full price or an equivalent percentage discount.
  • Fixed monetary reduction: Get €5 off when buying 2. Firmhouse tiered discounts use percentages rather than fixed amounts.
  • Floating-point percentage: Buy 2 and save 10.5%. Use a whole-number percentage because Shopify does not allow floating-point percentages for discounts applied to subscription contracts after checkout.
  • Percentage discount with a free unit: Buy 2 with 10% off and get 1 additional unit free. Use either the percentage discount or a full-price tier with the additional free unit.
  • A/B variants with different discounts: Variant A offers 10% off and Variant B offers 15% off. Both variants must use the same discount amount.
Whenever you update the tiers or percentages in Kaching, make the corresponding change to the tiered discount in Firmhouse. Otherwise, the price shown in the widget can differ from the price charged at checkout or on recurring orders. For a complete two-tier example with screenshots, follow Configure a Kaching BXGY bundle and matching Firmhouse discount.

​
Test the setup

Test changes on an unpublished copy of your live theme before publishing it.
  1. Open a storefront page with the Kaching widget.
  2. Confirm that each subscription option appears only once.
  3. Select each quantity tier and confirm that the widget shows the expected percentage or full price.
  4. Add a subscription product to the cart and confirm that the correct selling plan is selected.
  5. Check that the expected checkout buttons appear for your payment method setup.
  6. Complete a test order and confirm that the expected Kaching discount is applied at Shopify Checkout.
  7. Open the subscription in Firmhouse and verify that the matching Firmhouse discount will apply to its recurring orders.