Search The Hostwinds Guides Knowledge Base

How To Setup Configure Payments In WHMCS

Share This Article [TheChamp-Sharing]

WHMCS provides the ability to customize the options and experience of order processing and payment. This article goes over the options available in the Setup > Payments menu.


To access payment options, simply go to Setup > Payments and then the payment section you wish to access.


Payments Menu



This section lets you specify what currencies you support in your payments. The page lists what currencies are currently configured and allows you to specify other currencies your system supports.




Add Additional Currency

To add support for another currency, simply fill out the fields listed under Add Additional Currency and click Add Currency. The currency options are as follows:

  • Currency Code: Short code for the currency (eg. USD, GBP, etc.).
  • Prefix: Prefix to indicate a monetary value (eg. $, £, etc.).
  • Suffix: Suffix to indicate the currency type (eg. USD, CAD, etc.)
  • Format: Specifies the display format for that currency.
  • Base Conv. Rate: The current conversion rate to your base currency.


There are also two buttons to allow you to pull to most up to date exchange rates between your supported currencies and to apply them as updates to the prices of your products.


Payment Gateways

This section of the Payments options allows you to enable support for multiple third party payment options such as PayPal.


This page has three tabs for these options.


Featured Payment Gateways

The payment gateways displayed here are typically very popular, trustworthy, and recommended by WHMCS. Each gateway listed here has a button to learn more about the service and how to enable it.


Featured Payment Gateways


All Payment Gateways

This tab lists all the available payment gateways you can enable, with buttons to enable them, and even a link at the bottom to WHMCS’ marketplace where they have more payment gateways available with third party modules.


All Payment Gateways


Manage Existing Gateways

This tab lets you manage and disable any payment gateways that you currently have enabled. The options available here varies slightly per payment gateway, as they each have their own requirements, but all options for them will be listed here. You can deactivate a payment gateway by clicking the red Deactivate text next to its name.


Manage Existing Gateways


Tax Rules

This page allows you to specify the tax settings for your orders. There are a set of global rules, and then the ability to set up to two levels of tax rules to allow instances of specifying things like state and federal taxes separately.


Global Rules

The following are the options available to set on all taxes applied to orders.


Global Tax Rules


  • Tax Enabled: Enabled tax support for orders in WHMCS.
  • Tax Type: Specifies whether tax is included or excluded from prices.
  • Apply Tax To: Specifies what services or types of charges to apply taxes to.
  • Compound Tax: Specifies whether to compound tax on your set Level 2 taxes.
  • Deduct Tax Amount: Enables deducting the cost of taxes from inclusive prices if no tax rules are met.


Leveled Tax Rules

Below the global tax rule, are three tabs for your leveled tax rules. The first two tabs are simply to list and allow edits on your existing tax rules for both Level 1 and Level 2. The third tab allows you to add a new tax rule.


Tax Rules


Adding a New Tax Rule

To add a new tax rule, simply open the Add New Tax Rule tab, fill in the fields and click Add Rule.


Add New Tax Rule


  • Level: Specifies which tax level this rule belongs to.
  • Name: Name/nickname of the tax.
  • Country: Specifies whether the rule applies to all countries or a single, specific country. Multiple tax rules will need to be made if applying to multiple, but not all, countries.
  • State: Specifies whether the rule applies to all states/regions in the country or to a single, specific state/region. The Country option must be set to a specific country for this option to matter. Multiple tax rules will need to be made if applying to multiple, but not all, states/regions.
  • Tax Rate: The rate of the tax.



This page lets you specify any promotional deals or coupons available for your products. The main page lists all your active promotions by default, but provides buttons to view expired promotions as well, or all promotions in a single list. With each promotion, there is a b




Creating a New Promotion

To add a new promotional deal, simply click the Create New Promotion button, fill out the following form with details on the promotion, and click Save Changes.


Create New Promotion


  • Promotion Code: Promotional code for the deal that clients will use at checkout. There is a button available to auto-generate a promotional code.
  • Type: Specifies the type of promotion the deal is between: percentage, fixed amount, price override, and free setup.
  • Recurring: Specifies if the promotion recurs over multiple invoices, and for how many invoices it recurs for.
  • Value: Specifies the value of the promotional deal.
  • Applies To: Specifies which products this deal applies to.
  • Requires: Specifies what product the client must already have in order to use this promotional deal.
  • Billing Cycles: Specifies what billing cycles the promotion can apply to. Select none to apply to all billing cycles.
  • Start Date: Specifies the date on which the promotion begins.
  • Expiry Date: Specifies the date on which the promotion expires.
  • Maximum Uses: Specifies how times the promotion can be used before it expires.
  • Number of Uses: Shows how many times the promotion has already been used. Mainly useful in viewing and editing existing promotions, as it will always be 0 for new promotions.
  • Lifetime Promotion: Specifies whether the promotion is still applied on upgrade and downgrade orders in the future.
  • Apply Once: Specifies if the order is to only apply once on an order, even if multiple items qualify for it.
  • New Signups: Specifies if this promotion should only apply to new clients who have no previous active orders.
  • Apply Once/Client: Specifies if this promotion should only apply once per client (only one order per client).
  • Existing Client: Specifies if this promotion should only apply to existing clients who have an existing, active order.
  • Upgrades/Downgrades: Specifies if the promotion is available on product upgrades/downgrades.
  • Admin Notes: A place for internal notes on the promotion. Text written here is only visible to WHMCS admins.