> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firmhouse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enable SEPA Plan Support

> Enable the Firmhouse SEPA Plan Support app embed when you offer local payment methods for Shopify subscriptions.

Enable **SEPA Plan Support** when you offer local payment methods for Firmhouse subscriptions on Shopify. This includes iDEAL | Wero, Bancontact, Pay by Bank, Trustly, and other supported local payment methods.

## When to enable it

Enable the app embed when your store accepts local payment methods for subscriptions. Keep it enabled whether you use the Checkout Button Injector, the Shopify Plus Local Payment Method Switcher, or a supported custom cart integration.

You do not need SEPA Plan Support when your Shopify subscriptions only use the regular credit card or PayPal subscription checkout.

## Enable the app embed

1. In Shopify Admin, go to **Online Store > Themes**.
2. Click **Customize** for the active theme.
3. Open **App embeds**.
4. Enable **SEPA Plan Support**.
5. Keep the default settings.
6. Click **Save**.

Enable the app embed separately in every published or preview theme that you use for checkout testing.

## Complete the local-payment setup

* On a non-Shopify Plus store, also configure the [Checkout Button Injector](https://docs.firmhouse.com/configure/shopify/checkout-button-injector.md).
* On Shopify Plus, use the Local Payment Method Switcher in the checkout editor.
* If you use a third-party cart drawer, check the [Compatible Shopify plugins](https://docs.firmhouse.com/explained/compatible-shopify-plugins.md) guide for any additional setup.

After saving, test a subscription checkout with a local payment method on the storefront.

## Troubleshooting

### Duplicate gift products when switching plans

If a gift app adds duplicate gift products when customers start local-payment checkout or return to the storefront, enable **Update selling plans one item at a time** in the **SEPA Plan Support** app embed and click **Save**.

This setting changes selling plans on the existing subscription lines instead of clearing the cart and adding its contents back. It can prevent duplicate gifts caused by a gift app updating the cart during that replacement. It applies to storefront plan switching and restoration. When 15 or fewer subscription lines need changing and **Use Ajax Cart API to update cart** is off, plan updates can use redirects, including for discount-split lines and nested items. Redirect updates run from the last subscription line to the first.

If more than 15 subscription lines need a plan change, the whole cart uses bulk replacement. This avoids long redirect chains but can still trigger the gift-app conflict described above. Bulk replacement re-adds items in their existing order and preserves item properties, cart notes and attributes. It preserves parent-child relationships when the parent can be identified uniquely by variant. If multiple parent lines share that variant, or the parent is missing from the supplied cart, the add-on is re-added without a parent attachment. Custom integrations can use generated checkout URLs for discount-split and nested carts.

The setting is off by default. If your average cart contains multiple subscription lines, switching plans will take longer because each line is updated separately. A single subscription line with a quantity greater than one still needs only one plan update. Test checkout and return-to-cart behavior with your gift app after enabling it.

### Local-payment checkout is unavailable

If local-payment checkout is not available:

1. Confirm that **SEPA Plan Support** is enabled on the active theme.
2. Confirm that you clicked **Save** after enabling it.
3. Check that the subscription product and local payment methods are configured by following [Set up local payment methods on Shopify](https://docs.firmhouse.com/shopify/setup-local-payment-methods.md).
4. If you use a cart drawer, follow the [Checkout Button Injector troubleshooting guide](https://docs.firmhouse.com/configure/shopify/checkout-button-injector.md#troubleshooting).

## Related articles

* [Set up local payment methods on Shopify](https://docs.firmhouse.com/shopify/setup-local-payment-methods.md)
* [Configure the Checkout Button Injector](https://docs.firmhouse.com/configure/shopify/checkout-button-injector.md)
* [Compatible Shopify plugins](https://docs.firmhouse.com/explained/compatible-shopify-plugins.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.