M
PackageMaven Submit

The Home for Magento 2 Excellence

Quality-tested Magento 2 modules. Explore. Evaluate. Elevate. #magento2

1090 Modules
617 Ready
473 Need Help
🏆 Leaderboard
Actively Maintained vv1.0.1

MageMatch Payment Method Surcharge

magematch/magento2-payment-method-surcharge

Adds configurable surcharge fees per payment method using fixed, percentage, per-item, or per-row strategies, with optional tax handling. Surcharges display across cart, checkout, order totals, invoices, credit memos, PDFs, sales emails, and admin order creation.

Checkout & Payments Tax & Pricing
1
Downloads
Below average
0
GitHub Stars
2mo ago
Last Release
0
Open Issues
Build Passing
Ready to install

Build Tests

Composer Install
DI Compile
Templates

Code Quality

CS Coding Standard
141 warnings
PHPStan Failed

Tested on Magento 2.4.9

Recent Test History

Each release is tested against the latest Magento version at that time.

vv1.0.1 on Magento 2.4.9
Jun 1, 2026
GitHub Repository
Source code & docs
Packagist
Version history
Issues & Support
Get help or report bugs

Share This Module's Status

MageMatch Payment Method Surcharge Magento compatibility status badge

README

Loaded from GitHub

Payment Method Surcharge for Magento 2

Free, open-source Magento 2 extension
by Arjun Dhiman — Adobe Commerce Certified Master
Part of the MageMatch developer ecosystem

MageMatch_PaymentMethodSurcharge adds configurable surcharge fees by payment method and displays them across cart, checkout, order totals, invoice, credit memo, PDF, and sales email outputs.

Features

  • Configure payment surcharge by payment method.
  • Supports fixed, percentage, per-item, and per-row calculation strategies.
  • Supports optional tax handling for surcharge totals.
  • Displays surcharge in storefront and admin sales totals.
  • Includes invoice/credit memo/PDF/email total integrations.
  • Includes admin order-create support.

Package Name

  • Packagist package: magematch/magento2-payment-method-surcharge
  • Module name (backward compatible): MageMatch_PaymentMethodSurcharge

Configuration

In admin, configure this module in:

Stores > Configuration > Landofcoder > Advanced Payment Fee

CI Matrix

This repository includes a GitHub Actions workflow at .github/workflows/ci.yml.

Validation runs on:

  • PHP 8.2
  • PHP 8.4

It validates Composer metadata, PHP syntax, and XML well-formedness.

Install commands by environment

Stable production install:

composer require magematch/magento2-payment-method-surcharge:^1.0

Staging/dev install (before first stable tag is visible):

composer require magematch/magento2-payment-method-surcharge:"dev-main@dev"

Troubleshooting: duplicate module registration

If you see duplicate module registration errors, verify you do not have both paths at the same time:

  • app/code/MageMatch/PaymentMethodSurcharge
  • vendor/magematch/magento2-payment-method-surcharge

Fix (Composer-based install):

rm -rf app/code/MageMatch/PaymentMethodSurcharge
composer install
php bin/magento setup:upgrade
php bin/magento cache:flush

Installation

composer require magematch/magento2-payment-method-surcharge
bin/magento module:enable MageMatch_PaymentMethodSurcharge
bin/magento setup:upgrade
bin/magento cache:clean

Compatibility

  • Magento Open Source 2.4.x
  • Adobe Commerce 2.4.x
  • PHP 8.1, 8.2, 8.3

Support & Custom Development

Need custom Magento development?
Find vetted Adobe Commerce developers at
magematch.com

License

MIT License — free to use commercially

This content is fetched directly from the module's GitHub repository. We are not the authors of this content and take no responsibility for its accuracy, completeness, or any consequences arising from its use.

Back to All Modules