WHMCS Gateway Fees Addon

Add fees — or discounts — to invoices based on the payment gateway your clients choose. Fully compatible with WHMCS 9.x and PHP 8.1+, with a dedicated admin management interface.

Features

Fixed and percentage-based fees per payment gateway — or discounts using negative values.
Minimum invoice threshold and maximum fee cap per gateway.
Configurable percentage base — item subtotal (excl. tax) or total incl. tax.
Client-group exemptions — never charge selected client groups.
Dedicated admin interface with overview stats and per-gateway enable/disable.
Automatic application on invoice creation and when the payment method changes (by client or admin).
One-click recalculation of fees across all unpaid invoices, or apply-on-save.
Optional taxable fees and Activity Log entries.
Optional checkout-page fee estimate (Twenty-One theme).
PayPal Payments (PPCP) support — Beta, opt-in (see below).
Fully translatable via language files.

PayPal Payments (PPCP) — Beta

PayPal Payments (paypal_ppcpv / paypal_acdc) create their PayPal order before the WHMCS invoice exists, so the fee would otherwise not be charged. Enable "Adjust PayPal Payments Order Total" (off by default) and the addon patches the PayPal order total to include the fee — recomputed server-side, with credentials kept server-side, and fail-safe so it never blocks checkout. Test on a PPCP sandbox before enabling in production.

Requirements

WHMCS 8.x or 9.x
PHP 8.1 or newer

Installation

Upload the gateway_fees folder to modules/addons/ in your WHMCS installation.
Activate it under Setup → Addon Modules → Gateway Fees.
Configure per-gateway fees under Addons → Gateway Fees.

Legacy 1.x settings are migrated automatically on upgrade. Open source under the MIT License — source and documentation are available on GitHub.

Reviews

5 stars

4 stars

3 stars

2 stars

1 star

Shortus @shortus7882

March 10, 2026 at 06:43:12 AM

Nice! thankyou so much sir

6 months ago
Version Number 1.0.1
Edited

Support AR @mohamed1924

July 7, 2025 at 07:26:41 AM

Thanks

1 year ago
Version Number 1.0.1

Version Compatibility

Compatible with WHMCS v9.0

Full Version Compatibility

Selected versions of WHMCS v9.0
9.0.0 - 9.0.8
All versions of WHMCS v8.13
All versions of WHMCS v8.12
All versions of WHMCS v8.11
Selected versions of WHMCS v8.10
8.10.0
Selected versions of WHMCS v8.9
8.9.0
Selected versions of WHMCS v8.8
8.8.0
All versions of WHMCS v8.7
All versions of WHMCS v8.6
All versions of WHMCS v8.5

Support for this product

The best place to start if you need help with a specific product is to contact the developer. All WHMCS Marketplace developers have both a website and support URL listed.

Visit Website Contact Support

Developed By Nikba Creative Studio

Changelog

v2.2.0 Released September 10th, 2026

Latest Version

PayPal Payments (PPCP) support — Beta, opt-in.

PayPal Payments (paypal_ppcpv / paypal_acdc) create their PayPal order in-context on the checkout page, before a WHMCS invoice exists — so the invoice-level fee was never charged and left an unpaid balance.

A new option, "Adjust PayPal Payments Order Total" (off by default), adds a checkout interceptor that detects the freshly created PayPal order and asks a server endpoint to update the remote order total to include the fee:

The fee is recomputed server-side from the PayPal order amount — the browser never supplies the fee value.
PayPal API credentials are read server-side and never exposed to the client.
Fail-safe: any error never blocks the PayPal flow. Requires cURL and outbound access to PayPal's API.

Disabled by default — existing installs are unaffected. Test on a PPCP sandbox before enabling in production.

Previous Versions

v2.1.1 Released September 3rd, 2026

View/hide detailed changelog

Major rewrite for WHMCS 9.x / PHP 8.1+.

New

Dedicated admin management interface — configure per-gateway fees from one page, with overview stats, apply-on-save and one-click recalculation of unpaid invoices.
Fixed and percentage-based fees, or discounts (negative values).
Minimum invoice threshold and maximum fee cap per gateway.
Configurable percentage base (item subtotal or total incl. tax).
Client-group exemptions, optional taxable fees and Activity Log entries.
Dedicated mod_gateway_fees table with automatic migration of legacy settings.
Internationalisation via language files.

Fixes

Fees now apply correctly to admin-created invoices (InvoiceCreationAdminArea).
Partial-payment guard: invoices with recorded transactions are left untouched.
Invoice total is refreshed correctly when fees are applied via Recalculate / apply-on-save.
Removed the fragile reimplementation of WHMCS' internal tax calculation; added null-safety throughout.

Compatible with WHMCS 8.x and 9.x. Source and documentation on GitHub.

v1.0.1 Released August 1st, 2024

View/hide detailed changelog

Add fixed and percentage-based fees for each payment gateway.
Automatically apply fees to invoices when they are created or updated.
Update fees when the payment method is changed by the client or administrator.

vv1.2 Released August 23rd, 2024

View/hide detailed changelog

Version 1.2 - Changelog

Updates and Improvements

Currency Display Fix:
- The module now correctly displays fees in the default currency set in the WHMCS system. This fix ensures that all fees are shown in the appropriate currency without needing manual adjustments.
Fee Display on Checkout Page for Twenty-One Template:
- Fees associated with payment methods configured via this module are now displayed on the checkout page when using the default Twenty-One template.
- Note for Developers: If you are using a custom template, you might need to make adjustments to the ShoppingCartCheckoutOutput hook in the hooks.php file to ensure that fees are displayed correctly on the checkout page.