Changelog
1.1.2 (2026-11-03)
Fixed
- Setting the surcharge amount to 0 when refunding items on a credit memo now refunds no surcharge, instead of the full remaining surcharge.
- Setting the surcharge amount to 0 when invoicing items now charges no surcharge, instead of the full remaining surcharge.
1.1.1 (2026-10-26)
Fixed
- "Stop further rules processing" had no effect on surcharge rules — Turning the option on for a rule did not prevent lower-priority rules from also applying, so shoppers could be charged every matching surcharge at once. Now, when a rule with this option matches the cart, its fee is applied and any lower-priority rules are skipped.
1.1.0 (2026-10-13)
Features
- Hyvä support now ships with the extension — The companion package
mirasvit/module-surcharge-hyvais gone: the surcharge rows in the Hyvä cart totals and in the Hyvä Checkout price summary are now part of Surcharge itself. There is no second package to find and keep in step, and on a Luma store the Hyvä part simply stays dormant. Composer removes the companion package by itself when you upgrade.
Improvements
- Compatible with Mirasvit Core 2.0 — the module can now be installed alongside both the 1.x and 2.0 versions of the core package
- ⚠️
Hyva_MirasvitSurchargeis gone, not renamed —Hyva_MirasvitSurchargewas the Magento module insidemirasvit/module-surcharge-hyva; its templates and layouts now live insideMirasvit_Surcharge. You only need to act if you referencedHyva_MirasvitSurchargeyourself — in a customdi.xml, a layout file, or a deployment script that enables modules by name. - ⚠️ If you overrode a Hyvä surcharge template in your theme, repoint it —
Hyva_MirasvitSurcharge::checkout/cart/surcharge.phtmlis nowMirasvit_Surcharge::checkout/cart/surcharge-hyva.phtml, andHyva_MirasvitSurcharge::checkout/price-summary/total-segments/surcharge.phtmlis nowMirasvit_Surcharge::checkout/price-summary/total-segments/surcharge-hyva.phtml. Both stay Hyvä-only: Luma draws the same rows with its own Knockout templates, which did not change. An override at the old path is simply not read, with no error to say so. - After upgrading a Hyvä store, run
bin/magento hyva:config:generateand rebuild your theme's Tailwind CSS, so the build picks up the surcharge templates from their new location.
Fixed
- The Hyvä cart showed every surcharge twice — Each applied surcharge appeared under its own name and then again as a second "Surcharge" row with the same amount, so the fees looked doubled even though the grand total was right. The Hyvä cart now lists each surcharge once, the way Luma always has.
- Hyvä Checkout showed no surcharge in the order summary — The fee was included in the grand total but never listed, so shoppers saw a total higher than the rows above it added up to. Each applied surcharge is now listed in the Hyvä Checkout price summary. Luma was unaffected by either issue.
- Hyvä ignored surcharge groups — Rules that share a group label were listed one by one in the Hyvä cart and Hyvä Checkout. They now fold under one row with the group's label and total, which opens to show each rule, as on Luma.
- A long surcharge label ran out of the totals box — A label with no spaces pushed the amount out of the cart and checkout summary. It now wraps, on Luma and on Hyvä.
1.0.41 (2026-10-13)
Fixed
- Fixed an error that could stop the PayPal Express order review page from loading during checkout
1.0.40 (2026-09-30)
Improvements
- Internal compatibility updates for the upcoming Mirasvit core 2.0.
1.0.39 (2026-09-01)
Fixed
- Surcharge details again display correctly on the invoice and credit-memo creation screens for stores running Mage-OS 3.1 / PHP 8.4
Improvements
- Faster cart and checkout — surcharge details are now read once per page update instead of on every totals recalculation
- Deleting an order no longer leaves a leftover surcharge record behind; it is cleaned up by the daily maintenance task
- Upgrade note: this adds a foreign key on the
mst_surcharge_purchasetable'sorder_idcolumn (referencingsales_order), applied automatically duringsetup:upgrade
1.0.38 (2026-08-10)
Improvements
- Faster cart and checkout on stores with a long order history — surcharge lookups now use database indexes instead of scanning the whole surcharge table on every cart update and mini-cart refresh
- A daily background task now clears out leftover surcharge records from abandoned carts, keeping the database lean over time. Records tied to real orders are always kept
- Upgrade note: this adds a
created_atcolumn and two indexes (onquote_idandorder_id) to themst_surcharge_purchasetable. They are applied automatically duringsetup:upgrade
Fixed
- Fixed invoice and credit memo totals being higher than the order total when a taxable surcharge was applied. The surcharge tax was counted twice, so each invoice and credit memo exceeded the order grand total by the surcharge VAT amount. Totals now reconcile exactly to the order. Non-taxable surcharges were unaffected.
- Adds two columns (
amount_excl_tax,base_amount_excl_tax) to the surcharge purchase table viadb_schema.xml— runbin/magento setup:upgradeafter updating. Orders placed before the update keep their original values.
1.0.37 (2026-04-21)
Improvements
- Added i18n support for 15 core locales (ar_SA, cs_CZ, de_DE, es_ES, fr_FR, it_IT, ja_JP, nl_NL, pl_PL, pt_BR, pt_PT, sv_SE, tr_TR, uk_UA, zh_Hans_CN)
1.0.36 (2026-04-10)
Fixed
- Fix surcharge tax calculation for mixed rates in cart totals to prevent duplicate tax
1.0.35 (2026-04-09)
Fixed
- Surcharge tax amount not added to grandTotal if catalog prices Calculation Settings are set to "Excluding Tax"
1.0.34 (2026-02-03)
Improvement
- Passing tax to Kustom checkout for taxable surcharges with the catalog settings "included tax"
1.0.33 (2026-01-14)
Improvement
- Compatibility with Kustom(Klarna) Checkout
1.0.32 (2025-12-16)
Fixed
- Undefined variable $surcharges in Paypal/Review.php
1.0.31 (2025-10-14)
Improvement
- Added system configuration field for surcharge total sort order in "Checkout Totals Sort Order"
Fixed
- Multiple surcharge totals were not displayed in the checkout totals section in some checkout configurations
1.0.30 (2025-09-18)
Fixed
- Added separate surcharge rows in cart totals
1.0.29 (2025-06-04)
Fixed
- Region is not validated on first load in cart and one step checkout
1.0.28 (2025-06-02)
Improvement
- Collected translation phrases for the translation file
1.0.27 (2025-06-02)
Improvement
- Improve WCAG 2.2 AA compliance for Surcharge module form inputs
1.0.26 (2025-04-18)
Improvement
- Compatibility with php8.4
1.0.25 (2025-03-24)
Improvement
- Added surcharges to PDF totals
1.0.23 (2024-08-16)
Fixed
- Wrong tax calculation for multiple surcharges
1.0.22 (2024-07-26)
Improvement
- Made Surcharges taxable
1.0.21 (2024-03-01)
Improvement
- Changed Surcharge displaying in the email template and in customer account
1.0.20 (2024-02-28)
Fixed
- Surcharge Group Label displayed only one Surcharge label in order/invoice emails
1.0.19 (2024-02-01)
Fixed
- Custom attributes are not validated
1.0.18 (2024-01-02)
Improvement
- Added percent type calculation per order subtotal
1.0.17 (2023-12-05)
Improvement
- Added mst_surcharge attribute to the order object
1.0.16 (2023-11-03)
Fixed
- Undefined array key "surcharge" in credit memo grid in admin
1.0.15 (2023-11-02)
Fixed
- Class "Magento\Framework\Currency\Data\Currency" not found in Credit Memo
1.0.14 (2023-10-06)
Fixed
- Rates per item and product applied to the non-valid items
- Surcharges did not validate "Stop further rules processing"
- Surcharge did not save rule actions
1.0.13 (2023-08-23)
Fixed
- Compatibility with m2.4.6 (Class Zend_Currency not found in Surcharge/Block/Adminhtml/Sales/Creditmemo/Create/Surcharge.php)
- Update totals in checkout
1.0.12 (2023-08-02)
Fixed
- Collection::addStoreFilter(): Argument 1 ($storeId) must be of type array, int given
1.0.10 (2023-07-28)
Fixed
- Deprecated Functionality: stripos(): Passing null to parameter 1 ($haystack) of type string is deprecated in module-price-permissions
- Argument 1 ($storeId) must be of type int, array given in Surcharge\Collection::addStoreFilter
1.0.9 (2023-07-21)
Improvement
- Added new option in the rule to calculate extra fee based on the discounted prices
1.0.8 (2023-07-18)
Improvement
- Added surcharge total to the success page
1.0.7 (2023-07-11)
Improvement
- Added actions to surcharge rules
1.0.6 (2023-06-08)
Fixed
- Validation for rate "Rate per applicable Product"
- Compatibility with Amasty Shippng
1.0.5 (2023-05-04)
Improvement
- Added new rate "Rate per one item"
1.0.4 (2023-01-06)
Fixed
- Error during creditmemo saving
1.0.3 (2022-12-15)
Fixed
- Error during invoice saving
1.0.2 (2022-12-07)
Improvement
- Added rate "Rate per applicable Product"
1.0.1 (2022-12-06)
Fixed
- Duplicate rows in admin grid
1.0.0 (2022-08-23)
Features
- Initial release