A Shopware 6 plugin that automatically adds configurable surcharges to the shopping cart, including logistic fees and cash on delivery charges with dynamic payment method detection.
- Automatic logistic surcharge for all orders
- Cash on delivery (COD) fee based on payment method selection
- Dynamic surcharge calculation with proper tax handling
- Automatic cart cleanup when items are removed
- Payment method change detection and fee adjustment
- Configurable surcharge amounts through admin panel
- Multi-language support (German & English)
- Compatible with Shopware 6.7
- Shopware 6.7 or higher
- PHP 8.4 or higher
composer require actualizer/order-surcharges
bin/console plugin:refresh
bin/console plugin:install --activate ActOrderSurcharges
bin/console cache:clear- Download or clone this plugin into your
custom/plugins/directory - Install and activate the plugin via CLI:
bin/console plugin:refresh bin/console plugin:install --activate ActOrderSurcharges bin/console cache:clear
- Go to Admin Panel → Settings → System → Plugins
- Find "Actualize: Order Surcharges" and click on the three dots
- Click "Config" to access plugin settings
- Active: Enable/disable the logistic surcharge
- Logistic Surcharge Amount: Fixed amount added to all orders (default: 4.95 €)
- Active: Enable/disable COD fees
- COD Fee Amount: Fee amount for cash on delivery payments (default: 5.95 €)
- Default Tax Rate: Tax rate used when no other rate can be determined (default: 19.0%)
- Automatic Addition: Added to cart when at least one regular product is present
- Cart Cleanup: Automatically removed when cart becomes empty
- Tax Calculation: Uses appropriate tax rate based on cart contents or configuration
- Payment Detection: Monitors payment method selection for COD variants
- Dynamic Addition: Fee added when COD payment method is selected
- Automatic Removal: Fee removed when different payment method is chosen
- Language Support: Detects various COD payment method names (Nachnahme, Cash on Delivery, COD)
- Inherits tax rate from existing cart products
- Falls back to context tax rules
- Uses configured default tax rate as final fallback
- Proper tax calculation with Shopware's tax system
- Uses
CartProcessorInterfacefor clean cart integration SalesChannelContextSwitchEventfor payment method change detection- Line items with unique IDs (
logistic-surcharge,cod-fee) - Proper price definitions with tax calculations
Detects COD payments by checking payment method names for:
nachnahme(German)cash on delivery(English)cod(abbreviation)
After making changes:
bin/console cache:clear
bin/console theme:compile- Check cart contents in browser developer tools
- Monitor Shopware logs for surcharge-related events
- Test payment method changes in checkout process
- Customer adds products to cart
- Logistic surcharge automatically added
- Total price includes surcharge + tax
- Customer proceeds to checkout
- Selects COD payment method
- COD fee automatically added to cart
- Changes to different payment → COD fee removed
- Customer removes all products
- All surcharges automatically removed
- Clean cart state maintained
- Shopware Version: 6.7
- PHP Version: 8.4+
- Payment Methods: Compatible with all standard Shopware payment providers
- Tax Systems: Works with all Shopware tax configurations
For issues and feature requests, please use the GitHub issue tracker.
This plugin is licensed under the MIT License - see the LICENSE file for details.
Developed by Actualize
Made with ❤️ for the Shopware Community