PHPackages                             mageprince/magento2-paymentfee - 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. mageprince/magento2-paymentfee

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

mageprince/magento2-paymentfee
==============================

Magento 2 Add Payment Fee To Order

2.1.6(1y ago)38111.0k—5.2%26[4 issues](https://github.com/mageprince/magento2-paymentfee/issues)1GPL-3.0-or-laterPHP

Since Jun 28Pushed 1y ago3 watchersCompare

[ Source](https://github.com/mageprince/magento2-paymentfee)[ Packagist](https://packagist.org/packages/mageprince/magento2-paymentfee)[ Docs](https://github.com/mageprince/magento2-paymentfee)[ RSS](/packages/mageprince-magento2-paymentfee/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)DependenciesVersions (7)Used By (1)

Magento 2 Payment Fee
=====================

[](#magento-2-payment-fee)

The Magento 2 Payment Fee extension by MagePrince allows store owners to add extra charges for specific payment methods. These fees are shown throughout the customer journey — on the cart, checkout, order summary, invoice, credit memo, and sales emails. Admins can configure different types of fees, control visibility based on customer groups or store views, and even apply rules like disabling fees over a certain order amount. The extension also supports tax and refund settings for complete flexibility.

[![Latest Stable Version](https://camo.githubusercontent.com/4528866101ebd016f590906a9b395c5c6c2947ee437b50c9f895014997e9dfc8/68747470733a2f2f706f7365722e707567782e6f72672f6d6167657072696e63652f6d6167656e746f322d7061796d656e746665652f76)](//packagist.org/packages/mageprince/magento2-paymentfee)[![Total Downloads](https://camo.githubusercontent.com/f47632d16e6793965393afd047a54401e7dbebd4d4ef51db814e249bef761b45/68747470733a2f2f706f7365722e707567782e6f72672f6d6167657072696e63652f6d6167656e746f322d7061796d656e746665652f646f776e6c6f616473)](//packagist.org/packages/mageprince/magento2-paymentfee)[![Monthly Downloads](https://camo.githubusercontent.com/14dba18741b58a8c6e07e14da64a7bbbe34598181e39fd9f0b23f391813a0955/68747470733a2f2f706f7365722e707567782e6f72672f6d6167657072696e63652f6d6167656e746f322d7061796d656e746665652f642f6d6f6e74686c79)](//packagist.org/packages/mageprince/magento2-paymentfee)[![License](https://camo.githubusercontent.com/fc7d4eb62955b81b9ff9ae72ab04d2bcbc75907dafd138b7ca3695519902934c/68747470733a2f2f706f7365722e707567782e6f72672f6d6167657072696e63652f6d6167656e746f322d7061796d656e746665652f6c6963656e7365)](//packagist.org/packages/mageprince/magento2-paymentfee)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/73fd3ee957e6fcb5f983a0d24dc950444d6cea78881fc1a32175ec1b7ff98661/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6d6167657072696e63652f6d6167656e746f322d4641512f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/mageprince/magento2-FAQ/?branch=master)[![Code Intelligence Status](https://camo.githubusercontent.com/514449237a668f6be07b98d0db86840aaa5c0f194d387eaa7e709d07f56c67de/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6d6167657072696e63652f6d6167656e746f322d4641512f6261646765732f636f64652d696e74656c6c6967656e63652e7376673f623d6d6173746572)](https://scrutinizer-ci.com/code-intelligence)

✨ Features
----------

[](#-features)

- Enable or disable the extension from admin configuration
- Add payment fees for specific payment methods (e.g., COD, PayPal)
- Fee types supported:
    - Fixed Price
    - Percentage of Order
    - Per Item
    - Per Row
- Display fees on:
    - Checkout Page
    - Order Summary
    - Sales Emails (Order, Invoice, Credit Memo)
    - Admin Order View
- Set custom titles for fees
- Refundable fee option in credit memo
- Disable fees for orders exceeding a maximum amount
- Customer group restrictions
- Store view restrictions
- Set sort order for fee display
- Supports tax calculation on the fee
    - Assign tax class
    - Choose display type: Incl., Excl., or Both
- Multi-store and multi-currency support
- Option to include discount/shipping in subtotal for calculation

💡 Payment Fee Types Explained
-----------------------------

[](#-payment-fee-types-explained)

**1. Fixed Price**

A flat fee is added to the order, no matter what’s in the cart.

Example: Fee = 10 → You pay 10 extra.

**2. Percentage Price**

The fee is a percentage of the cart subtotal.

- If “Include shipping in subtotal” is Yes:
    - Subtotal = Products + Shipping
- If “Include discount in subtotal” is Yes:
    - Subtotal = Subtotal - Discount

Example: Fee = 10%, Subtotal = 36 → Extra = 3.60

**3. Per Row**

Fee is added based on the number of products (rows) in the cart.

Example: Fee = 10, Cart = 2 products → Extra = 20

**4. Per Item**

Fee is based on the total quantity of all products in the cart.

Example: Fee = 10, Cart = 3 items total → Extra = 30

🧪 Demo
------

[](#-demo)

**[Frontend](http://demo.mageprince.com/) | [Backend](http://demo.mageprince.com/admin)**

🚀 Installation Instructions
---------------------------

[](#-installation-instructions)

### Option 1: Install via Composer (recommended)

[](#option-1-install-via-composer-recommended)

```
composer require mageprince/magento2-paymentfee
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

```

### Option 2: Manual Installation

[](#option-2-manual-installation)

1. Copy the content of the repo to the Magento 2 `app/code/Mageprince/Paymentfee`
2. Run the following Magento CLI commands:

```
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

```

✅ Compatibility
---------------

[](#-compatibility)

- Magento Open Source (Community Edition): 2.4.4 – 2.4.8
- Adobe Commerce (Enterprise Edition): 2.4.4 – 2.4.8

🤝 Contribution
--------------

[](#-contribution)

Want to contribute to this extension? The quickest way is to [open a pull request](https://help.github.com/articles/about-pull-requests/) on GitHub.

🛠 Support
---------

[](#-support)

If you encounter any problems or bugs, please [open an issue](https://github.com/mageprince/magento2-paymentfee/issues) on GitHub.

📸 Screenshots
-------------

[](#-screenshots)

### Checkout Page

[](#checkout-page)

[![image](https://private-user-images.githubusercontent.com/24751863/436014973-b22c94e7-5c89-4c48-8929-cde1b6dd68f4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUyODMyNzksIm5iZiI6MTc3NTI4Mjk3OSwicGF0aCI6Ii8yNDc1MTg2My80MzYwMTQ5NzMtYjIyYzk0ZTctNWM4OS00YzQ4LTg5MjktY2RlMWI2ZGQ2OGY0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDQlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA0VDA2MDkzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWQyZDY2MmFkZWNhNzQyMjM3MDVjZTVhNWM2YzJiMmExZmYyZmE4OGQ5ZDY1MDc3NThhNzI2NDkwZmJkOTc5MDYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.9WS3X_1_wSL_vvVJ4TBZebGo6KvbzIvE1PaVYfm5cr4)](https://private-user-images.githubusercontent.com/24751863/436014973-b22c94e7-5c89-4c48-8929-cde1b6dd68f4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUyODMyNzksIm5iZiI6MTc3NTI4Mjk3OSwicGF0aCI6Ii8yNDc1MTg2My80MzYwMTQ5NzMtYjIyYzk0ZTctNWM4OS00YzQ4LTg5MjktY2RlMWI2ZGQ2OGY0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDQlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA0VDA2MDkzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWQyZDY2MmFkZWNhNzQyMjM3MDVjZTVhNWM2YzJiMmExZmYyZmE4OGQ5ZDY1MDc3NThhNzI2NDkwZmJkOTc5MDYmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.9WS3X_1_wSL_vvVJ4TBZebGo6KvbzIvE1PaVYfm5cr4)### Configuration

[](#configuration)

[![image](https://private-user-images.githubusercontent.com/24751863/436013533-2e8df15a-2ae3-41cf-91f0-9bb975b35eb0.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUyODMyNzksIm5iZiI6MTc3NTI4Mjk3OSwicGF0aCI6Ii8yNDc1MTg2My80MzYwMTM1MzMtMmU4ZGYxNWEtMmFlMy00MWNmLTkxZjAtOWJiOTc1YjM1ZWIwLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDQlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA0VDA2MDkzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTZlYTk4ODI5NDAzNDhkNTljZDc4ZGIyOTc0N2Q4MmY4ZWQ0NDliZTRiMDUyYWMzZDlhM2FlODAzYzRlZmZjNzImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.gnAB980YqJ_S6eIOJFOoddtnU5scWxwRgK_ZIPKOKig)](https://private-user-images.githubusercontent.com/24751863/436013533-2e8df15a-2ae3-41cf-91f0-9bb975b35eb0.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUyODMyNzksIm5iZiI6MTc3NTI4Mjk3OSwicGF0aCI6Ii8yNDc1MTg2My80MzYwMTM1MzMtMmU4ZGYxNWEtMmFlMy00MWNmLTkxZjAtOWJiOTc1YjM1ZWIwLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDQlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA0VDA2MDkzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTZlYTk4ODI5NDAzNDhkNTljZDc4ZGIyOTc0N2Q4MmY4ZWQ0NDliZTRiMDUyYWMzZDlhM2FlODAzYzRlZmZjNzImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.gnAB980YqJ_S6eIOJFOoddtnU5scWxwRgK_ZIPKOKig)[![image](https://private-user-images.githubusercontent.com/24751863/436013648-8239f224-985f-498e-9af7-b84bc2372534.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUyODMyNzksIm5iZiI6MTc3NTI4Mjk3OSwicGF0aCI6Ii8yNDc1MTg2My80MzYwMTM2NDgtODIzOWYyMjQtOTg1Zi00OThlLTlhZjctYjg0YmMyMzcyNTM0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDQlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA0VDA2MDkzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWQ4MTFjNjdiMDk5ZjI3Zjg0MjI5N2M1NzE4YTZlYjQwMDg1Y2NmNDU0NWZkMjczNmI2Nzc0ZjZlMzJjMGQyN2UmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.7FRY5OyWoojPaoacUNcSDodBI20BN6gTMt0Eub-h76g)](https://private-user-images.githubusercontent.com/24751863/436013648-8239f224-985f-498e-9af7-b84bc2372534.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUyODMyNzksIm5iZiI6MTc3NTI4Mjk3OSwicGF0aCI6Ii8yNDc1MTg2My80MzYwMTM2NDgtODIzOWYyMjQtOTg1Zi00OThlLTlhZjctYjg0YmMyMzcyNTM0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDQlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA0VDA2MDkzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWQ4MTFjNjdiMDk5ZjI3Zjg0MjI5N2M1NzE4YTZlYjQwMDg1Y2NmNDU0NWZkMjczNmI2Nzc0ZjZlMzJjMGQyN2UmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.7FRY5OyWoojPaoacUNcSDodBI20BN6gTMt0Eub-h76g)

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance45

Moderate activity, may be stable

Popularity45

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.7% 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 ~351 days

Recently: every ~398 days

Total

6

Last Release

391d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/874d990fdd2aec1749284bd4fa6a67bd59c53b4d30bd8df67ea8fa00cff70b44?d=identicon)[mageprince](/maintainers/mageprince)

---

Top Contributors

[![mageprince](https://avatars.githubusercontent.com/u/24751863?v=4)](https://github.com/mageprince "mageprince (50 commits)")[![Coosos](https://avatars.githubusercontent.com/u/5632327?v=4)](https://github.com/Coosos "Coosos (3 commits)")[![princektpl](https://avatars.githubusercontent.com/u/55445358?v=4)](https://github.com/princektpl "princektpl (2 commits)")[![sfritzsche](https://avatars.githubusercontent.com/u/32567473?v=4)](https://github.com/sfritzsche "sfritzsche (2 commits)")

---

Tags

extrafeefree-extensionfree-modulemagentomagento-marketplacemagento2magento2-extension-freemagento2-free-extensionmagento2-free-modulesmagento2-paymentmagento2-payment-feepaymentfee

### Embed Badge

![Health badge](/badges/mageprince-magento2-paymentfee/health.svg)

```
[![Health](https://phpackages.com/badges/mageprince-magento2-paymentfee/health.svg)](https://phpackages.com/packages/mageprince-magento2-paymentfee)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

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