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: 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

Frisbii enables secure payments and subscriptions, supports multiple payment methods, and offers recurring billing management.

✅ Tip: Installing through the Shopware Store ensures you always get the latest tested version and automatic update options.

After installation, navigate to Extensions → My Extensions and locate the Frisbii plugin.

Click Configure to open the plugin settings.

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.

⚠️ Important: Webhooks are required to sync events like payment status updates and subscription renewals between Frisbii and Shopware.

Frisbii Payment Configuration

• Send amount only: 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 as order lines: If the Send amount only 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: 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.

Enable only the payment methods that you’ve also activated in your Frisbii account: Frisbii Payment Configuration Dashboard

You can click Edit to customize the payment method name, description, and logo.

✅ 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.

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

⚠️ 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

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.

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.

ℹ️ 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.

✅ 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.

To configure this:

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: 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.

✅ 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.

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.

ℹ️ 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.

Simply:

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: Use limited-time discounts or introductory offers to boost conversions on new subscription products.