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.7(1mo ago)40121.5k↓30.7%25[2 issues](https://github.com/mageprince/magento2-paymentfee/issues)1GPL-3.0-or-laterPHP

Since Jun 28Pushed 1mo 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 yesterday

READMEChangelog (7)DependenciesVersions (9)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
- [Hyva](https://www.hyva.io/) Compatibile

💡 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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI4NDUzNzIsIm5iZiI6MTc4Mjg0NTA3MiwicGF0aCI6Ii8yNDc1MTg2My80MzYwMTQ5NzMtYjIyYzk0ZTctNWM4OS00YzQ4LTg5MjktY2RlMWI2ZGQ2OGY0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjMwVDE4NDQzMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTRkMzFiYTZiZjMxYTE2YmNjYmE2NzA1MDEzM2FlODNjYTBhODlkOTBjODJjNDA0NDQ3N2RiZTIzMTFlODFlOGQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.PscLiZJyZNKvuzxdoMbhztEwznUHngKN_fLuW_MtuD4)](https://private-user-images.githubusercontent.com/24751863/436014973-b22c94e7-5c89-4c48-8929-cde1b6dd68f4.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI4NDUzNzIsIm5iZiI6MTc4Mjg0NTA3MiwicGF0aCI6Ii8yNDc1MTg2My80MzYwMTQ5NzMtYjIyYzk0ZTctNWM4OS00YzQ4LTg5MjktY2RlMWI2ZGQ2OGY0LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MzAlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjMwVDE4NDQzMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTRkMzFiYTZiZjMxYTE2YmNjYmE2NzA1MDEzM2FlODNjYTBhODlkOTBjODJjNDA0NDQ3N2RiZTIzMTFlODFlOGQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.PscLiZJyZNKvuzxdoMbhztEwznUHngKN_fLuW_MtuD4)### Configuration

[](#configuration)

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

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance89

Actively maintained with recent releases

Popularity46

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 88.3% 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 ~358 days

Recently: every ~491 days

Total

7

Last Release

46d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/24751863?v=4)[Mageprince](/maintainers/mageprince)[@mageprince](https://github.com/mageprince)

---

Top Contributors

[![mageprince](https://avatars.githubusercontent.com/u/24751863?v=4)](https://github.com/mageprince "mageprince (53 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

[msilabs/bkash

bKash Payment Gateway API for Laravel Framework.

181.2k](/packages/msilabs-bkash)

PHPackages © 2026

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