Extra Fee & Surcharge for Magento 2 Checkout

What you get

Panth Extra Fee — Configurable Extra Fees & Surcharges for Magento 2

Add configurable extra fees and surcharges to your Magento 2 checkout — payment method fees, small order fees, customer group surcharges, country-based fees, product-specific handling charges, and more. Each fee shows as its own line item in cart, checkout, order view, invoices, credit memos, and emails. Full tax and refund support built in.

Stop losing margin on small orders, COD payments, and international shipping. Panth Extra Fee gives store owners complete control over additional charges with a powerful rule engine, 11 condition types, 4 calculation methods, and a clean admin UI with product/category browse popups.

Preview

Fee Rules Management

Manage all your fee rules from a single grid — filter by type, status, amount, and more.

Fee Rule Editor with Product & Category Browse

Full rule editor with conditions, product/category browse popups, schedule, and tax settings.

Admin Configuration

Granular control: display settings, small order fee, tax display, fee breakdown, and advanced options.

Order Fees Tracking

Track every fee charged — linked to orders with amounts, tax, invoiced, and refunded totals.

Admin Order View — Fee Breakdown

Individual fee lines in Order Totals with per-item Extra Fee column in Items Ordered table.

Customer Order View — Frontend

Customers see fee breakdown in their My Orders page — fully transparent.

Cart Page — Fee Line Items

Each fee shows as its own row in cart totals — works on both Hyva and Luma themes.

Luma Checkout — Fee in Order Summary

Fee lines visible in checkout order summary — updates dynamically based on payment method and address.

Key Features

• Rule-Based Fee Engine — create unlimited fee rules with conditions and priorities
• 4 Calculation Types — Fixed, Percentage, Combined (Fixed + Percent), Percentage with Fixed Minimum
• 3 Apply Modes — Per Order, Per Product (unique line items), Per Quantity (per unit)
• 11 Condition Types — store, website, date, customer group, payment method, country, subtotal, quantity, product IDs, product SKUs, category IDs
• Individual Fee Line Items — each fee shows as its own row in cart/checkout/order (not lumped together)
• Browse Products & Categories Popup — visual product/category chooser with search, select all, and selected items preview
• Tax on Fees — assign tax class to any fee, 3 display modes (Excl/Incl/Both)
• Full Invoice & Credit Memo Support — fees carry to invoices and are refundable
• Small Order Fee — config-based fee for orders below minimum with customer-facing message
• Admin Order Control — toggle "Apply Fees to Admin Orders" (default: No)
• Order Fees Grid — dedicated admin grid tracking all fees with order links, export support
• Per-Item Fee Column — "Extra Fee" column in admin order Items Ordered table
• Sales Order Grid Column — optional Extra Fee column in the main order grid
• Multi-Store & Multi-Website — per-store/website fee rules and configuration
• Stop Further Rules — priority-based rule processing with stop flag
• Fee Breakdown or Aggregated — show individual fee names or single "Additional Fees" total
• Email Integration — fees in order confirmation, invoice, and credit memo emails
• Hyva + Luma Compatible — works on both themes, cart and checkout
• 8 Sample Fee Rules — install via CLI for quick testing
• MEQP Compliant — no ObjectManager, strict types, clean DI
• Zero Frontend Performance Impact — all calculation server-side

Fee Calculation Types

Apply Modes

Condition Types

Every rule can combine multiple conditions — all must match for the fee to apply:

Fee Rules

Navigate to Panth Infotech > Extra Fee > Fee Rules.

Creating a Fee Rule

1. Click Add New Fee Rule
2. General Settings: Name, description, active status, sort order, stop further rules
3. Fee Calculation: Label, type (fixed/percent/combined/min), amount, apply per (order/product/qty), min/max caps
4. Tax Settings: Tax class, refundable toggle
5. Conditions: Store views, websites, customer groups, payment methods, countries, subtotal/qty ranges
6. Product & Category Selection: Browse popup with search, select all, preview table
7. Schedule: Optional from/to dates
8. Click Save

Product & Category Browse Popup

The rule editor includes "Browse Products..." and "Browse Categories..." buttons that open full-featured popup dialogs:

• Product popup: Searchable grid with ID, name, SKU, type, price. Checkbox selection with "Select All" and pills preview.
• Category popup: Expandable category tree with checkboxes and level indicators.
• Selected items table: Shows selected products/categories below the field with Edit/View/Remove actions.

How It Works

Checkout Flow

1. Customer adds products to cart
2. Quote total collector runs fee calculation engine
3. Engine loads active rules ordered by sort_order
4. For each rule: validates all 11 conditions against the quote
5. Matching rules: calculates fee based on type and apply mode
6. Applies min/max fee constraints and global maximum cap
7. Each fee saved to panth_extra_fee_quote table
8. Individual fee segments returned to cart/checkout for display
9. On order placement: observer transfers quote fees to panth_extra_fee_order
10. Fees carry through to invoices, credit memos, and emails

Admin Order Flow

• By default, admin-created orders skip all extra fees
• Toggle "Apply Fees to Admin Orders" to enable
• All fee rules apply identically to frontend orders when enabled

Where Fees Display

Order Fees Grid

Navigate to Panth Infotech > Extra Fee > Order Fees.

Tracks every fee charged with:

Supports CSV export for accounting.

Sample Data

The CLI command creates 8 production-realistic fee rules:

Install: bin/magento panth:extrafee:install-sample-data

Troubleshooting

Compatibility

Installation

Composer (Recommended)

composer require mage2kishan/module-extra-fee
bin/magento module:enable Panth_Core Panth_ExtraFee
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Install Sample Data (Optional)

bin/magento panth:extrafee:install-sample-data

Creates 8 ready-to-use fee rules for testing.

Verify

bin/magento module:status Panth_ExtraFee
# Module is enabled

Configuration

Navigate to Stores > Configuration > Panth Extensions > Extra Fee.

General Settings

Display Settings

Small Order Fee

Advanced

License

Proprietary — see LICENSE.txt. One license per Magento production installation.