README

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

magematch / magento2-payment-method-surcharge

Maintainers

Package info

Statistics

Security