--- title: "Frisbii Shopware Extension" slug: "frisbii-shopware-extension" updated: 2025-09-25T14:18:05Z published: 2025-09-25T14:18:05Z canonical: "help.frisbii.com/frisbii-shopware-extension" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.frisbii.com/llms.txt > Use this file to discover all available pages before exploring further. # Frisbii Shopware Extension **Frisbii Shopware Plugin Setup Guide** This guide walks you through the full setup and usage of the Frisbii plugin for Shopware. Frisbii brings powerful recurring billing and payment capabilities into your Shopware store, allowing you to sell subscription-based products, manage renewals, apply discounts, and more. Whether you're just starting or looking to optimize your subscription offerings, this guide will help you: - Install and configure the Frisbii plugin - Enable and customize payment methods - Set up subscription products and rules - Manage add-ons, customer options, and coupons > [!NOTE] > ℹ️ **Note:** Before proceeding, ensure you have a Frisbii account and access to your API keys. You'll need them during the setup process. #### Styling and customization All screenshots in this guide show the default, unstyled version of the Frisbii integration. However, both customer-facing content and layout can be fully customized to match your webshop’s design. Texts and translations can be overridden via **Admin → Settings → Snippets**, and templates can be modified by your developer like any other Shopware template. You can also enrich the customer-facing pages with additional data from the Frisbii API, if needed. --- ### 1. Install the Frisbii plugin Start by installing the official Frisbii plugin from the Shopware Store: [**Frisbii for Shopware**](https://store.shopware.com/en/reepa70150752991f/frisbii.html) Frisbii enables secure payments and subscriptions, supports multiple payment methods, and offers recurring billing management. > [!TIP] > ✅ **Tip:** Installing through the Shopware Store ensures you always get the latest tested version and automatic update options. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.09.41.png) --- ### 2. Locate and configure the plugin After installation, navigate to **Extensions → My Extensions** and locate the Frisbii plugin. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/screencapture-reepaydemo-web08-tigermedia-eu-admin-2025-06-12-20_14_16.png) Click **Configure** to open the plugin settings. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/screencapture-reepaydemo-web08-tigermedia-eu-admin-2025-06-12-20_11_03(1).png) #### Frisbii API Configuration - **Private API Key / Webhook Secret**: Paste your credentials from the Frisbii dashboard. - Click **Install webhooks in Frisbii** to enable real-time updates. > [!WARNING] > ⚠️ **Important:** Webhooks are required to sync events like payment status updates and subscription renewals between Frisbii and Shopware. #### Frisbii Payment Configuration - **Send transactions:** When enabled, the plugin sends only the total order amount to Frisbii, without itemizing the individual order lines. When disabled, all order lines from Shopware are sent to Frisbii. - **Send shipping costs**: If the **Send transactions** setting is disabled, Shopware sends each product as a separate order line to Frisbii. Enabling this setting ensures that shipping costs are included as an additional order line. - **Update Frisbii invoice when changing Shopware payment status**: Keep invoices in sync across systems. Refunds, cancellations, and settlements in Shopware will reflect in Frisbii. #### Frisbii Billing Configuration - **Enable Cancellation of Subscriptions**: Let customers cancel and reactivate subscriptions from "My Account". - **Enable Pausing of Subscriptions**: Adds pause and resume options for customers. - **Enable Creation of Renewal Orders in Shopware**: Essential if you ship physical goods with renewals. - **Enable Sending Shopware Order Mails for Renewal Orders**: Sends Shopware order confirmation on renewals (optional). - **Enable Addons for Subscriptions**: Activates support for Frisbii add-ons. - **Enable Require Login to Buy Subscription Products**: Requires users to be logged in before subscribing. - **Default Order Status for Renewal Orders**: Defines the initial status of renewal orders. > [!NOTE] > ℹ️ **Note:** These settings allow full customization of how subscription behavior integrates into your Shopware store. Adjust according to your business model. --- ### 3. Enable Frisbii payment methods Navigate to **Settings → Payment methods**. Here you will see all the Frisbii-supported methods available. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.27.42.png) Enable only the payment methods that you’ve also activated in your Frisbii account: [Frisbii Payment Configuration Dashboard](https://app.frisbii.com/#/rp/config/payment-methods) You can click **Edit** to customize the payment method name, description, and logo. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.32.31(1).png) > [!TIP] > ✅ **Tip:** Clear and recognizable payment labels in checkout can increase conversion rates. --- ### 4. Make payment methods visible in checkout Head to **Storefront → Payment and Shipping** and scroll to the **Payment Methods** section. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.34.33.png) Use the dropdown to select which methods should appear during checkout. Only methods enabled in both Shopware and Frisbii will work. --- ### 5. Test your setup Before going live, switch your plugin to use the **Frisbii test API key**. Steps: 1. Go to plugin configuration. 2. Insert your test API key. 3. Add a product to cart and proceed to checkout. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/screencapture-reepaydemo-web08-tigermedia-eu-checkout-confirm-2025-06-12-20_37_42(1).png) > [!WARNING] > ⚠️ **Reminder:** Once testing is complete and successful, don’t forget to switch your API key back to your **live Frisbii key**. This ensures that your customers can complete real transactions and subscribe without issues. Once you've verified that transactions complete and subscriptions are created, you can switch to your live API key. --- ### 6. Create a subscription product To convert a product into a subscription: 1. Go to **Catalogues → Products.** 2. Create or open an existing product. 3. Navigate to the **Frisbii Billing** tab. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.43.17.png) #### Plan Options: - **Default Plan**: This is the fallback subscription plan that will apply if no rule-based conditions match. It’s typically used for general cases when you don’t need to differentiate based on customer attributes. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.44.17(2).png) **Rule-Based Plans**: These allow you to dynamically assign subscription plans based on conditions defined in Shopware's Rule Builder. You can use any existing Shopware rules such as specific currencies, customer groups, billing countries, or even custom-defined rules. When a rule matches, the corresponding Frisbii plan is applied instead of the default. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.44.57.png) > [!NOTE] > ℹ️ **Note:** Rule-Based Plans provide advanced flexibility for merchants operating in multiple regions, currencies, or offering customer-specific pricing. Make sure your rules are well-tested and don’t overlap unintentionally. Your Frisbii plans will be auto-loaded. Choose the appropriate one and confirm. You can now change or remove the plan to make the product a regular Shopware product. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.46.05.png) > [!TIP] > ✅ **Tip:** Keep your Frisbii plan prices updated. If you change prices in Frisbii, re-save the product in Shopware to sync. --- ### 6a. Working with product variants If your product has multiple variants (such as size, color, or type), you can assign each variant its own Frisbii subscription plan. This is particularly useful when each variant represents a different subscription tier or price point. 1. Go to **Catalogues → Products** and select your variable product. 2. In the **Variants** tab, open each specific variant. 3. Navigate to the **Frisbii Billing** tab for that variant. 4. Choose the appropriate Frisbii plan for that variant. > [!NOTE] > ℹ️ **Note:** Each variant must be saved individually after assigning a plan. Once done, customers selecting a variant on the storefront will be subscribed to the corresponding plan. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.57.00.png) > [!TIP] > ✅ **Tip:** Use clear plan names and pricing to help customers understand what each variant includes. --- ### 7. Add-ons for subscription products You can enhance subscriptions with optional services (add-ons): 1. Create the add-on in Frisbii. 2. In the **Availability** section, select the relevant plans. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.48.32.png) Save the product again in Shopware to fetch new add-ons. - **On/Off Add-ons**: A simple checkbox to include or exclude the add-on. - **Quantity Add-ons**: Customers can choose how many units to include. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/Screenshot 2025-06-12 at 20.57.00(1).png) ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/screencapture-reepaydemo-web08-tigermedia-eu-checkout-confirm-2025-06-12-21_20_04 (1).png) > [!NOTE] > ℹ️ **Note:** You can use add-ons for premium support, extra features or bundled services. --- ### 8. Discounts and coupons Frisbii coupons and discounts are compatible with Shopware's native coupon field. 1. Create a coupon in Frisbii. 2. Share the code with your customers. 3. Customers apply the code in Shopware’s discount field. → The discount will automatically apply to the subscription at checkout. > [!TIP] > ✅ **Tip:** Use limited-time discounts or introductory offers to boost conversions on new subscription products.