With this module you can easily set products, addons, domains and other items which require an additional fee.
You can also select clients that will be exempt from fees and discounts.

We will guide you step by step through the whole installation and configuration process.

Files in your WHMCS directory should look like these.

File is located in 'modules/addons/gateway_charges_functions/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in your client area → 'My Products'.

Log in to your WHMCS admin area. Go to 'Setup' → 'Addon Modules'. Afterwards, find 'Payment Gateway Charges' and press 'Activate' button.

To do so click on 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.

You can access your module at 'Addons' → 'Payment Gateway Charges'.

In this short guide we will present you the possibilities of our module.

Module allows your customers to view charges for using payment gateways when ordering.
We implemented easy integration codes and the displayed instruction of which can be easily adjusted to each order form template.

Note! Please insert the codes to the template you are using, if you use more than one template then insert the codes to all of them.
The provided directory is just an example of one of the available templates.

Underneath you will find as specific information on the code insertion as possible.
As soon as you enter any part of integration, its status will change from 'Undone' to 'Done' in the addon.

Open the template you are using (we opened 'modern' template as an example).

Open the 'viewinvoice.tpl' file and insert the below codes at the very top of that file. Remember to alter the file of the used by you template!
On the screen there is a shown location of the file in template 'Six'.

Find a list of active gateways and set charges for all of them or only for those you wish.

You can add percentage value of invoice amount or fixed amount to charge. Fixed amount will be charged in the default currency of the client.
Once you have set up the configuration, press 'Save Changes' button.

1. Minimum Invoice Value - set minimum value of invoice to charge or place discount
2. Tax Payment Charge - tick to impose taxes on charges
3. Charge After Taxing - if selected, charge will be applied to an already taxed item
4. Hide Gateway Charges Table - if selected, the box with details of additional payments with our module on the order form will not be visible for a client
5. Charge After Applying Promo Code - if checked, your promotion codes will be taken into consideration before calculating the final price.

   See Tips section to read about exceptions!

6. Billing type - choose between Standard (exclusive charge) or PayPal billing type (inclusive charge) - see below to note the differences

   Underneath you can find some examples illustrating difference in charging with both types.

Do not forget to press 'Save Changes'.

• Standard (exclusive to cart total) - when this type is selected, then full amount charged for product and fee paid to a payment gateway is counted in a standard way;
  
• PayPal (inclusive to final total) - when PayPal method is selected, charge amount is already included in the fee when calculating the final amount.

  Note: when this method is selected such billing type is applied to every activated payment gateway, not only to the PayPal ones.

Fee: $124
Gateway Discount: 5%

To do so, mark checkbox next to client ID and press 'Save Changes', consequently such client will not be additionally charged for using a specific payment gateway.

1. Module automatically calculates fixed amount discount depending on the currency selected by the customer. Example:
When your default payment gateway currency is USD and you set fixed amount discount at -1.00, your customer who prefers to pay in USD will receive $1 discount.
If you have other payment gateway currency, let's say EUR, and the same fixed amount discount -1.00, your customer who prefers to pay in EUR will receive about 0.75€ discount.
2. Exactly the same as above applies to Minimum Invoice Value which currency is also automatically calculated.
3. Percentage value is collected separately for each currency based on the values specified in the 'Pricing' section of each product, addon, domain or other.

Go to 'Setup' → 'Products/Services' → 'Products/Services' and edit product group you want to disable payment gateway for.

If the promotion code is created for a bundle of items (e.g. a product ordered with an addon) then all required items must be chargeable to allow the promotion
before being charged with the gateway charge. In case at least one of the required items in the ordered package is not chargeable, the promotion will be applied after charging the price.

$LANG['mg_chtpl_charged'] = 'Payment Gateway Charge';
$LANG['mg_chtpl_discount'] = 'Payment Gateway Discount';

Charge is not automatically added and calculated when auto applying credits.
Problems may occur when a client does not have sufficient credits for both the basic payment and the charge.

1. To change the line, edit the module english.php lang file. Find line:

$LANG['client_header']     = 'Payment Gateway Charges'; 

Change the text as you need or leave empty space between quotation marks:

$LANG['client_header']     = ''; 

2. To delete the line, edit your currently used template.
Depending on the used cart, adequate template must be found and edited.
Templates are located in: /modules/addons/gateway_charges_functions/templates/
Full list of files:

• boxes.tpl
• ajaxcart.tpl
• cart.tpl
• comparison.tpl
• default.tpl
• modern.tpl
• slider.tpl
• standard_cart.tpl
• verticalsteps.tpl
  

Find variable that describes this language line and comment the line including it out:

  {$lang.client_header}

Usually this is:

<h2 {if $hideChargesTable}style="display: none;"{/if}>{$lang.client_header}</h2>

or

<h2>{$lang.client_header}</h2>