Integrated Loyalty & Referral Program

Enable Loyalty Program

• Enables or disables the complete loyalty program.

• When disabled, loyalty point earning, reward redemption, referral discounts, and most loyalty storefront features are inactive.

• Default: Enabled

Tier Progression Strategy

• Defines how customers progress through VIP tiers.

• Available strategies:

  • Lifetime Points – Based on total lifetime points earned.

  • Yearly Points – Based on points earned during the current calendar year.

  • Lifetime Spend – Based on total spend from paid or completed orders.

  • Yearly Spend – Based on order spend during the current calendar year.

• Default: Lifetime Points

• Switching to a spend-based strategy triggers historic order-spend backfill through the message queue.

• VIP tier thresholds can be configured under Marketing → Loyalty program → VIP tiers.

• Purchase multipliers apply only to order points, not to registration, newsletter, review, birthday, or referral bonuses.

2. Order Earning

Enable Points for Orders

• Awards loyalty points when an order is paid or completed.

• Default: Enabled

Points per €1 Spent

• Defines the base number of loyalty points awarded per €1 spent.

• The VIP tier multiplier is applied to purchase points.

• Default: 1 point per €1

Show Points in Cart, Checkout, and Order Summary

• Displays estimated loyalty points for the current cart or order.

• Points are only credited after the configured earning event occurs.

• Default: Enabled

Show Loyalty Rewards in Cart and Mini Cart

• Allows logged-in customers to redeem eligible rewards directly from the cart or mini cart.

• Default: Enabled

Show Points on Product Detail Page

• Displays estimated loyalty points for purchasing a product.

• Default: Enabled

Send Email When Order Points Are Credited

• Sends an email when order points are credited.

• Requires an active Flow Builder flow.

• Loyalty email consent requirements apply.

• Default: Enabled

Order Points Calculation

• Points are calculated using:

  • floor(Order Total × Points per Euro)

• The customer's VIP tier multiplier is then applied.

• Points and recorded spend are reversed when an applicable order is cancelled, refunded, or charged back.

3. Registration Bonus

Enable Registration Bonus

• Awards loyalty points when a customer successfully registers.

• Default: Enabled

Registration Bonus Points

• Defines the number of points awarded for registration.

• Default: 50 points

Send Email When Registration Bonus Is Credited

• Sends an email when the registration bonus is credited.

• Flow Builder and loyalty email consent settings apply.

• Default: Enabled

4. Newsletter Bonus

Enable Newsletter Signup Bonus

• Awards loyalty points after a newsletter subscription is confirmed.

• Default: Enabled

Newsletter Signup Bonus Points

• Defines the number of points awarded after newsletter confirmation.

• Default: 25 points

Send Email When Newsletter Bonus Is Credited

• Sends an email when newsletter bonus points are credited.

• Flow Builder and consent settings apply.

• Default: Enabled

5. Review Bonus

Enable Review Submission Bonus

• Awards loyalty points when an active product review is submitted.

• Default: Enabled

Review Submission Bonus Points

• Defines the points awarded for each qualifying review.

• Each review is processed only once.

• Default: 25 points

Send Email When Review Bonus Is Credited

• Sends an email when review bonus points are credited.

• Flow Builder and consent settings apply.

• Default: Enabled

6. Birthday Bonus

Enable Birthday Bonus

• Enables the automatic birthday reward.

• The birthday task runs daily.

• Default: Enabled

Birthday Bonus Points

• Defines the number of points awarded for a customer's birthday.

• The bonus can be awarded once per calendar year.

• Default: 100 points

Send Email When Birthday Bonus Is Credited

• Sends an email when the birthday bonus is credited.

• Flow Builder and consent settings apply.

• Default: Enabled

Requirements

• The customer birthday field must be available.

• The Shopware scheduler must be running.

• The asynchronous Messenger must be running.

7. Points Products

Allow Multiple Points Products in Cart

• Controls whether customers can redeem multiple points products in the same cart.

• Disabled: Redeeming another points product replaces the previous one.

• Enabled: Multiple points products can be added to the cart.

• Default: Disabled

Minimum Cart Value for Points Product Redemption

• Defines the minimum cart subtotal required to redeem a points product.

• A value of 0 disables the minimum cart value requirement.

• Default: €0

Points Product Management

• Points products can be managed under:

  • Marketing → Loyalty program → Points products

• Products can also be configured using the relevant product custom fields.

8. Rewards

Grant / Voucher Validity

• Defines how many days an unused reward grant remains valid.

• After expiration, unused points are returned to the customer's spendable balance.

• A value of 0 disables expiration.

• Default: 30 days

Reward Management

• Rewards can be created under:

  • Marketing → Loyalty program → Rewards

• Rewards can be linked to Shopware promotions.

• Supported promotion types include:

  • Percentage discount

  • Fixed amount discount

  • Free shipping

9. Referral Program

Enable Referral Program

• Enables or disables the referral program.

• Controls referral links, referee discounts, and referrer rewards.

• Default: Enabled

Referee Discount Type

• Defines the type of discount given to the referred customer.

• Available options:

  • Percentage

  • Fixed amount

• Default: Percentage

Referee Discount (%)

• Defines the percentage discount given to the referred customer.

• Used when the discount type is Percentage.

• Default: 10%

Referee Discount (Fixed Amount)

• Defines a fixed discount amount in the shop currency.

• Used when the discount type is Fixed Amount.

• Default: 10

Referral Link Landing Page

• Defines where visitors using a referral link are redirected.

• Available options:

  • Registration – Opens the customer registration page.

  • Homepage – Opens the storefront homepage.

• The ?ref= referral parameter is retained.

• Default: Registration

Referrer Points Reward

• Defines the number of points awarded to the referrer.

• Points are awarded after the referee completes their first qualifying order.

• Default: 100 points

Minimum Order Value for Referral Reward

• Defines the minimum order value required for the referral reward.

• The value is also used when applying the referee discount.

• Default: €0

Send Email When Referral Reward Is Credited

• Sends an email after a referral is successfully completed.

• Flow Builder and consent settings apply.

• Default: Enabled

10. Fraud Protection

Block Same Email Domain Referrals

• Rejects referrals when the referrer and referee use the same email domain.

• Example: both customers use @company.com.

• Default: Disabled

Skipped Email Domains

• Defines email domains that should be excluded from the same-domain check.

• Multiple domains can be entered as comma-separated values.

• Common free email domains can be excluded from this validation.

Block Matching IP Referrals

• Rejects referrals when the referee's IP matches the referrer's last recorded login IP.

• The referrer must have logged in at least once.

• Default: Disabled

Referral Rejection Reasons

Rejected referrals can be viewed under:

Marketing → Loyalty program → Referrals

Possible reasons include:

• same_email_domain – Same email domain as the referrer.

• matching_ip – Matching IP address.

• self_referral – Self-referral attempt.

11. Privacy

Require Explicit Consent for Loyalty Emails

• Ensures loyalty emails are sent only to customers who have provided the required consent.

• Displays the loyalty email consent option during registration and on the loyalty dashboard.

• Default: Enabled

Require Consent During Registration

• Makes loyalty email consent mandatory during customer registration.

• This setting only applies when loyalty email consent is enabled.

• Default: Disabled

Customer Consent Management

• Customers can update their loyalty email preference from:

  • /account/loyalty

12. Data Cleanup

Enable Automatic Data Cleanup

• Enables automatic removal of old loyalty transaction records.

• Cleanup is performed through a scheduled task.

• Default: Enabled

Transaction Retention

• Defines how many days loyalty transaction records should be retained.

• Transactions older than the configured period are removed during cleanup.

• Minimum value: 30 days

• Default: 365 days

13. Default VIP Tiers

The plugin creates the following default VIP tiers:

• Bronze

  • Threshold: 0 lifetime points

  • Purchase multiplier: 1.0×

• Silver

  • Threshold: 500 lifetime points

  • Purchase multiplier: 1.0×

• Gold

  • Threshold: 2,000 lifetime points

  • Purchase multiplier: 1.25×

• Platinum

  • Threshold: 5,000 lifetime points

  • Purchase multiplier: 1.5×

VIP tiers can be modified under:

Marketing → Loyalty program → VIP tiers

14. Additional Administration

The following features are managed outside the main plugin configuration:

• VIP Tiers

  • Marketing → Loyalty program → VIP tiers

  • Manage thresholds, multipliers, and colours.

• Rewards

  • Marketing → Loyalty program → Rewards

  • Create rewards and link them to Shopware promotions.

• Points Products

  • Marketing → Loyalty program → Points products

  • Manage products that can be redeemed with points.

• Referrals

  • Marketing → Loyalty program → Referrals

  • View referral status and fraud rejection reasons.

• Customer Loyalty

  • Customers → Customer → Loyalty

  • View customer loyalty information and manually adjust points.

• Email Templates & Flows

  • Settings → Email templates / Flow Builder

  • Manage loyalty-related emails and automation flows.

15. After Configuration

After changing the plugin configuration:

• Clear the Shopware cache:

• Register scheduled tasks:

• Ensure the Shopware scheduler is running.

• Ensure the asynchronous Messenger worker is running:Test the main storefront functionality:

• • Customer registration and registration bonus

  • Order points

  • Reward redemption

  • Referral link and referee discount

  • Loyalty email consent