DataFirefly Loyalty — Shopware 6 Loyalty Program

Overview

DataFirefly Loyalty adds a complete loyalty program to Shopware 6: your customers earn points on every order, climb tiers with point multipliers and convert their points into vouchers based on Shopware’s native promotions. The extension runs on Shopware 6.5, 6.6 and 6.7 with a single ZIP, with no compilation whatsoever.

Installation

From the administration

1. Go to Extensions > My extensions.
2. Click Upload extension and select the DfLoyalty-1.0.0.zip file.
3. Click Install, then activate the extension.

From the command line

bin/console plugin:refresh
bin/console plugin:install --activate DfLoyalty
bin/console cache:clear

Installation creates two dedicated tables: df_loyalty_account (one row per customer) and df_loyalty_transaction (the ledger of all point operations).

Configuration

Open Extensions > My extensions > DataFirefly Loyalty > Configure. All settings are available per sales channel: you can enable the program on one shop only, or apply different rates per channel.

Point awarding

• Enable the program: master switch. When disabled, the customer account page returns a 404 and no points are awarded.
• Award trigger: Payment captured (transaction state paid, recommended) or Order completed (order state completed).
• Points per currency unit: points earned per unit spent. Default: 1.
• Calculation basis: gross or net order amount.
• Include shipping costs: shipping is excluded from the calculation by default.

Tiers

Three tiers are configurable, each with a name, a threshold and a multiplier. Thresholds apply to lifetime earned points (never decreased by a redemption), and the multiplier applies to all future earnings.

• Tier 1 — default: Bronze, from 0 points, multiplier ×1.0
• Tier 2 — default: Silver, from 500 points, multiplier ×1.25
• Tier 3 — default: Gold, from 2,000 points, multiplier ×1.5

Voucher redemption

• Conversion rate: points needed for 1 unit of voucher value. Default: 100 (100 points = 1.00).
• Redemption minimum: minimum points required to redeem. Default: 200.
• Redemption step: points convert in multiples of this value. Default: 100.
• Voucher validity: voucher lifetime in days. Default: 90.

How it works for customers

A Loyalty programme entry appears in the customer account menu. The /account/loyalty page shows:

• the available points balance and total lifetime earned points;
• the current tier with a progress bar towards the next tier;
• the voucher redemption form;
• the history of the last 50 operations (earnings, redemptions, revocations).

When a customer redeems points, the extension creates a native Shopware promotion: a unique code such as LOYAL-XXXXXXXX, restricted to their account, single use, with a fixed cart discount. The code is applied in the cart like any promo code. All generated promotions can be found under Marketing > Promotions.

Cancellations and refunds

When an order enters the Cancelled state or its payment enters the Refunded state, the points earned on that order are automatically revoked. The operation is traced in the customer’s history under the label “Revoked”. Revocation is idempotent: it can occur at most once per order.

Security and data integrity

• The point debit is atomic at database level: two simultaneous redemptions cannot spend the same balance twice.
• Every operation is written to an append-only ledger, with order reference, type, signed points and the voucher code where applicable.
• Voucher creation and the ledger write run in the same SQL transaction: never a voucher without a debit, never a debit without a voucher.

Troubleshooting

The Loyalty programme link does not appear in the account

The extension injects its link through the page_account_sidebar_link_orders Twig block. If your custom theme removed or renamed this block, add the link manually in the account sidebar template, pointing to the frontend.account.dfloyalty.page route.

Points are not being awarded

1. Check that the program is enabled for the relevant sales channel.
2. Check the configured trigger: with Payment captured, the transaction must reach the paid state; with Order completed, the order must reach completed.
3. Clear the cache after any configuration change: bin/console cache:clear.

Uninstalling

During uninstallation, Shopware offers to keep the data. If you untick this option, the df_loyalty_account and df_loyalty_transaction tables are permanently removed — previously generated vouchers remain in place, as they are standard Shopware promotions.