Skip to content

Usage Guide

This guide covers all features and functionality of the WebLa Subscription Plugin.

Table of Contents

Setting Up Products for Subscriptions

What It Does

You can configure individual subscription options for each product. In the storefront, customers will then see a choice between one-time purchase and subscription with various intervals.

How to Set It Up

  1. Navigate to Catalogues → Products → [Your Product]
  2. Switch to the Subscription tab (added by the plugin)
  3. Click Add Subscription Option
  4. Configure for each option:
  5. Interval (Weeks): The delivery interval for this option
  6. Label: The displayed name (e.g., "Every 2 weeks")
  7. Position: Display order
  8. Active: Whether this option is visible
  9. Save the product

Subscription-Only Products

If a product should only be available as a subscription:

  1. Open the product under Catalogues → Products → [Your Product]
  2. Switch to the Specifications tab
  3. Find the custom field Subscription only
  4. Enable the checkbox
  5. Save the product

In the storefront, the one-time purchase option will be hidden and customers can only order the product as a subscription.

Storefront Display

On the product detail page, customers see:

  • One-time / Subscribe: Choice between one-time order and subscription
  • Interval Dropdown: Selection of desired delivery interval (if multiple options are configured)
  • Discount Badge: Display of the subscription discount (e.g., "Save 5%")

Configuring Payment Methods

Supported Payment Methods

The plugin offers four payment methods for subscriptions:

Payment Method Automatic Mollie Required Description
Credit Card Yes Yes Automatic charge via Mollie
SEPA Direct Debit Yes Yes Automatic debit via Mollie
Invoice No No Manual payment, subscription stays active
Prepayment No No Waits for payment receipt before activation

Setting Up Mollie

  1. Navigate to Extensions → My Extensions → WebLa Subscription Plugin → Configure
  2. Scroll to the Mollie API section
  3. Enter your Test API Key (starts with test_)
  4. Click Test API Connection
  5. On successful connection: Also enter the Live API Key
  6. Disable Test Mode only when you are ready for live operation

Assigning Payment Methods

  1. Stay in the plugin configuration
  2. In the Payment Methods section:
  3. Select the Mollie credit card payment method for Credit Card Payment Method
  4. Select the Mollie SEPA payment method for SEPA Payment Method
  5. Select your invoice payment method for Invoice Payment Method (optional)
  6. Select your prepayment method for Prepayment Payment Method (optional)
  7. Select the Renewal Shipping Method (optional, otherwise the sales channel default is used)
  8. Save the configuration

Payment Method Filtering at Checkout

When a customer has subscription items in the cart, only payment methods configured for subscriptions are shown at checkout. Non-subscription payment methods are hidden.

Discounts and Loyalty Tiers

Base Subscription Discount

The percentage set under Configuration → Pricing & Discounts → Subscription Discount (%) is automatically applied to every subscription order.

Loyalty Tiers

In addition to the base discount, you can set up tiered discounts that activate after a certain number of renewals:

  1. Navigate in the admin to Orders → Subscriptions → Dashboard
  2. Discount tiers are managed via the database (table webla_subscription_discount)

Example: | From Renewal | Additional Discount | | ------------ | ------------------- | | 3 | 2% | | 6 | 5% | | 12 | 8% |

Free Items

You can add free products to subscriptions that are automatically included with every renewal.

Free items are managed per subscription in the detail view:

  1. Open a subscription under Orders → Subscriptions → [Subscription]
  2. In the Items section, free items can be added
  3. Specify product and quantity
  4. Save the changes

Email Notifications

The plugin sends four types of emails:

Renewal Reminder

  • When: 3 days before the next renewal
  • Content: Next renewal date, link to subscription management
  • Template Name: webla_subscription.renewal_reminder

Cancellation Confirmation

  • When: Immediately after cancellation by customer or admin
  • Content: Cancellation confirmation, optional reason
  • Template Name: webla_subscription.cancelled

SEPA Payment Failed

  • When: On failed SEPA direct debit
  • Content: Information about failed payment, instructions for updating payment method
  • Template Name: webla_subscription.sepa_failed

Price Change

  • When: When the price of a subscription product changes
  • Content: Old and new price, effective date
  • Template Name: webla_subscription.price_changed

Customising Email Templates

You can edit the email templates under Settings → System → Email Templates. Search for the template names listed above.

Background Tasks

The plugin registers four automatic background tasks that are executed at regular intervals by Shopware:

Subscription Renewal

Checks all active subscriptions for due dates and automatically creates new orders. Takes into account the configured behaviours for out-of-stock or deleted products.

Renewal Reminders

Sends reminder emails 3 days before each upcoming renewal. Each reminder is only sent once per renewal cycle.

Mollie Payment Status Polling

Queries the current payment status from Mollie to update local order statuses. Processes up to 200 transactions per run with a 7-day lookback period.

Prepayment Monitor

Monitors pending prepayment orders and marks them as unpaid if payment is not received within the configured timeframe. Pauses the associated subscription when payment is outstanding.