This Summer season, boost your WHMCS with premium modules and save 15% off.

Use promo code: SUMMER2026

Payment Gateway Fees Module by WHMPress

Optimize Payment Gateway Charges with Precision

Payment Gateway Fees is a WHMCS addon module that automatically adds a payment gateway surcharge or a gateway-specific discount to your client invoices based on the payment method chosen. Set a percentage fee, a fixed amount, or both for every payment gateway activated in WHMCS, and the module handles the rest: it recalculates the invoice the moment the gateway is switched, shows the client exactly what they will be charged before they complete checkout, and keeps the invoice subtotal, tax and total correct throughout. Enter a negative percentage or fixed amount instead and the same engine applies it as an incentive discount useful for steering clients toward cheaper payment methods. Fees can be capped with a minimum invoice amount and a maximum threshold, excluded for specific clients, and calculated with a Stripe-style gross-up formula so the amount that lands in your account after the processor takes its cut still matches the invoice total.

Admin Area Features

• Dedicated addon module interface with four tabs — Dashboard, Settings, Integration Code and Info — plus a direct link to the online documentation.
• Dashboard table listing every payment gateway currently activated in WHMCS, showing each gateway's configured percentage, fixed amount and current status.
• Per-gateway on/off switch that enables or disables fees for that gateway instantly over AJAX, with all unpaid and draft invoices using that gateway recalculated immediately.
• Per-gateway configuration modal covering percentage, fixed amount, minimum invoice amount, threshold, additional tax, VAT fee basis and Stripe calculation mode — saved by AJAX, with the dashboard row updating in place.
• Excluded Clients management: a searchable multi-select of active clients (searchable by name and email), bulk "Add to Excluded List" action, and removal through a confirmation dialog. Excluded clients never receive a gateway fee, and their unpaid invoices are recalculated as soon as they are added or removed.
• Customisable invoice line-item description with placeholder support: {gateway_name}, {percentage_fees}, {fixed_fees} and {fixed_fee_currency}.
• Optional fee round-off with a choice of zero, one or two decimal places.
• Optional module logging — every fee calculation, checkout preview and cart validation is written to Utilities → Logs → Module Log.
• Automatic credit-amount handling on the admin invoice page: when an admin applies client credit to an unpaid or draft invoice, the credit field is capped at the maximum amount that can genuinely be applied once the gateway fee is accounted for, and the invoice is recalculated before submission.
• Unpaid and draft invoices are corrected automatically the moment an admin opens them, not only on the nightly cron run.
• Integration Code tab with copy-ready instructions for adding the {$paymentGatewayFeesContent} variable to custom order form templates such as Lagom.
• Info tab showing module name, installed version, license key, valid domain, next due date, and the live WHMCS version, PHP version and ionCube Loader version detected on the server.
• License activation and a one-click license status refresh directly from the module interface.
• Automatic module updates delivered through the WHMCS daily cron job, with each successful update written to the WHMCS activity log.
• Optional Refresh Database setting that removes the module's database tables on deactivation; tables are otherwise created and migrated automatically.
• Administrator access is restricted through the standard WHMCS Addon Modules access control (admin role groups).
• Toast notifications for every save, and automatic sidebar collapse for a full-width working area.

Client Area Features

• Live fee preview on the checkout page: selecting a different payment method updates the displayed charge and the order total by AJAX, without reloading the page.
• The charge line is labelled Gateway Charges for a fee and Gateway Discount where a negative value has been configured, so the client always sees which one applies.
• Optional comparison table on the checkout page listing every fee-enabled gateway alongside its percentage and fixed amount, letting clients pick the cheapest payment method before they order.
• Choice of display format — either the full percentage % + fixed amount breakdown, or a single summed charge.
• The "Complete Order" button is disabled while a fee is being calculated, preventing checkout on a stale total.
• Credit-aware checkout: when a client applies account credit, the fee is recalculated against the remaining balance, and the fee display is hidden entirely when credit covers the full amount.
• On the client-area invoice page, the credit amount field is pre-filled and capped at the maximum credit that can be applied to that invoice, with an on-screen notice explaining the adjustment.
• Unpaid and draft invoices are recalculated and corrected the moment the client opens them.
• Where an invoice is ultimately paid in full using client credit, the gateway fee is removed from the invoice and refunded back to the client's credit balance automatically.

Package & Configuration Options

Per-gateway options (Dashboard → gateway edit)

• Status — enable or disable fees for that gateway.
• Percentage Fee / Discount — percentage of the invoice amount; a negative value applies a discount.
• Fixed Amount / Discount — flat amount added on top of the percentage; a negative value applies a discount. Converted to the client's currency using the WHMCS exchange rate.
• Minimum Invoice Amount — no fee or discount is applied below this amount (0 disables the minimum).
• Threshold — caps the calculated amount in either direction (0 disables the cap). A discount can never exceed the amount it was calculated against.
• Additional Tax — marks the fee line item as taxable so the invoice tax rates apply on top of the fee.
• Enable VAT Fees — calculates the fee on the tax-inclusive amount; when off, the tax portion is stripped out first and the fee is based on the net amount.
• Stripe Calculations — uses the gross-up formula ((amount × %) + fixed) ÷ (1 − %) so the net amount received after the processor's cut still matches the invoice total.

Global module settings (Settings tab)

• Invoice Description — the fee line item description, with placeholder support.
• Enable Gateway Fees Round Off — rounds the calculated fee before it is added to the invoice.
• Round Off the Value To — no decimal place, one decimal place, or two decimal places.
• Enable Table on Client Area Checkout Page — shows the gateway comparison table at checkout.
• Enable Sum of Charges on Checkout — displays a single total instead of the percentage-plus-fixed breakdown.
• Enable Module Logs — writes fee calculations to the WHMCS module log.

What the Module Works With

Payment gateways

• Any payment gateway activated in WHMCS is listed automatically and can have a fee or discount configured. The module reads your activated gateways from WHMCS and adds its charge as an invoice line item — it does not connect to, authenticate against, or call any payment provider's API. The "Stripe Calculations" option is a fee-calculation formula, not a Stripe integration; where WHMCS Stripe Intents is in use, the module adjusts the pending checkout amount so it matches the recalculated total.

Invoice and order flows handled

• New orders placed through the client-area cart
• Orders placed by an administrator, including those with client credit applied
• Recurring and renewal invoices generated by the WHMCS cron
• Mass Pay / bulk-pay invoices, with each underlying invoice recalculated
• Merged and duplicated invoices
• Add Funds invoices
• Invoices where the payment gateway is changed after creation
• Invoices where the total is updated after creation
• Partially paid invoices, and invoices settled wholly or partly with client credit
• A daily cron sweep that recalculates every unpaid and draft invoice

Checkout page display

• Automatic, no template edits required: WHMCS themes with the identifiers twenty-one, six, nexus and idfnv810, and the standard and standard_cart order form templates.
• Lagom (lagom2) — supported, with dedicated stylesheet rules for the Lagom order summary; requires the one-line template variable from the Integration Code tab.
• Any other custom order form template — supported by adding {$paymentGatewayFeesContent} to ordersummary-checkout.tpl, as documented in the Integration Code tab.

General Compatibility

• Supports all payment gateways.
• Fully compatible with WHMCS themes like "Six," "Twenty-One," and "Lagom WHMCS Client Theme".
• Works with PHP 8.4 back to PHP 8.1 and WHMCS versions 9.0.3 to 8.7.
• Requires ionCube Loader V13 or later.

Why Choose WHMPRESS

WHMPress builds WHMCS modules that behave predictably in production, not just on a demo install. Payment Gateway Fees is a mature module with a long, documented release history, an admin area rebuilt on the WHMPress interface standard where every action saves over AJAX without a page reload, automatic database migration between versions, optional module logging for troubleshooting, and self-updating through the WHMCS daily cron for as long as the license stays active. Every WHMPress module ships with setup documentation and direct support from the developers who wrote the code.

Take your payment management to the next level with this must-have tool for WHMCS!

Module Price

Monthly Price:7.5 $.

Annually Price:39$.

One-Time Price:99$.

OPEN-SOURCE VERSION: $199 One-time Price.