PHPackages                             magematch/magento2-payment-method-surcharge - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. magematch/magento2-payment-method-surcharge

ActiveMagento2-module[Payment Processing](/categories/payments)

magematch/magento2-payment-method-surcharge
===========================================

Magento 2 module for configurable payment-method surcharge fees across cart, checkout, order, invoice, credit memo, PDF, and email totals.

v1.0.1(1mo ago)00MITPHPPHP >=8.1CI passing

Since Apr 16Pushed 1mo agoCompare

[ Source](https://github.com/magematch/magento2-payment-method-surcharge)[ Packagist](https://packagist.org/packages/magematch/magento2-payment-method-surcharge)[ Docs](https://magematch.com)[ RSS](/packages/magematch-magento2-payment-method-surcharge/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (1)Versions (3)Used By (0)

Payment Method Surcharge for Magento 2
======================================

[](#payment-method-surcharge-for-magento-2)

> Free, open-source Magento 2 extension
> by **Arjun Dhiman** — [Adobe Commerce Certified Master](https://magematch.com/developers/arjun-dhiman)
> Part of the [MageMatch](https://magematch.com)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
--------

[](#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
------------

[](#package-name)

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

Configuration
-------------

[](#configuration)

In admin, configure this module in:

`Stores > Configuration > Landofcoder > Advanced Payment Fee`

CI Matrix
---------

[](#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

[](#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
----------------------------------------------

[](#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
------------

[](#installation)

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

Compatibility
-------------

[](#compatibility)

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

Support & Custom Development
--------------------------------

[](#support--custom-development)

Need custom Magento development?
Find vetted Adobe Commerce developers at
**[magematch.com](https://magematch.com)**

License
-------

[](#license)

MIT License — free to use commercially

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance91

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~9 days

Total

2

Last Release

45d ago

PHP version history (2 changes)v1.0.0PHP ^8.1 || ^8.2 || ^8.3 || ^8.4

v1.0.1PHP >=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/25de70104e0bb9357f7dc83de70315741d4b04931f7104e96f48e0b0e7b32ee8?d=identicon)[arjundhi](/maintainers/arjundhi)

---

Top Contributors

[![aiopsgroup](https://avatars.githubusercontent.com/u/131590932?v=4)](https://github.com/aiopsgroup "aiopsgroup (6 commits)")

### Embed Badge

![Health badge](/badges/magematch-magento2-payment-method-surcharge/health.svg)

```
[![Health](https://phpackages.com/badges/magematch-magento2-payment-method-surcharge/health.svg)](https://phpackages.com/packages/magematch-magento2-payment-method-surcharge)
```

###  Alternatives

[adyen/module-payment

Official Magento2 Plugin to connect to Payment Service Provider Adyen.

1673.1M10](/packages/adyen-module-payment)[checkoutcom/magento2

Checkout.com Payment Gateway for Magento 2

34272.1k1](/packages/checkoutcom-magento2)[mollie/magento2-hyva-checkout

Hyvä Themes Checkout module for Mollie Payments

11221.9k](/packages/mollie-magento2-hyva-checkout)[vipps/module-payment

Vipps MobilePay Payment Module for Magento 2

1097.3k](/packages/vipps-module-payment)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)