Skip to content

Charge a fee per payment gateway

A payment fee passes a gateway’s cost on to the clients who pay with it, as HostBill’s Gateway Fees and the WHMCS gateway fee add-ons do. The fee is its own line on the invoice, such as “PayPal fee”, and changes when the client pays with another gateway.

Check first that your card scheme, your payment provider and the law where you sell allow surcharges, and how high they may be. In Australia, for example, a card surcharge may not be more than what the card costs you.

  1. Open the gateway on System → Payment Gateways.
  2. Under Payment fee, enter the Percentage of the amount due, a Fixed amount, or both. The fixed amount is in your default currency. Invoices in other currencies get it at the exchange rates on System → Settings → Currency.
  3. Turn on Tax the fee if the fee is taxed where you sell. It is then taxed at the invoice’s tax rate.
  4. Optional: select the Client groups that pay no fee, such as resellers.
  5. Select Update Gateway.

A fee of 2.5% plus 0.30 on an invoice with 100.00 due is 2.80.

The fee line follows the gateway that is to take the payment of an unpaid invoice:

  • an invoice issued with a gateway, such as an order placed with one, carries its fee;
  • when the client picks a payment method on the invoice, starts paying with a gateway, or sends a transfer receipt for a manual method, the invoice takes that gateway and its fee;
  • when staff change an invoice’s gateway, or its amounts, on Manage, or delete one of its lines, the fee follows;
  • a saved card or PayPal account that pays the invoice automatically adds its gateway’s fee first.

Choosing a gateway without a fee removes the line, so a client who leaves a card payment and picks bank transfer instead owes no fee. While a payment for the invoice is still clearing, the method cannot be changed. Add funds invoices never carry a fee.

The fee is a share of the balance due without the fee. Credit the client applies to the invoice pays no fee: the fee line is taken off, and what the credit leaves due gets the fee again. A part-paid invoice gets the fee on what is left.

At checkout and on the cart page, each payment method shows the fee it adds, and Due today and the pay button show the total of the chosen method, its fee and the fee’s tax included. On the invoice, each method shows its total with the fee; picking a method updates the invoice’s lines and total at once.

A subscription keeps the amount of its first payment, fee included.