This module supports multiple currencies and offers various billing options, including hourly billing, credit billing, and recurring billing.
It automatically generates invoices according to your preferred settings and at customizable intervals, sending them directly to your customers.
Additionally, clients can set up email reminders to notify them when they reach or exceed specified resource usage limits.

Advanced Billing For WHMCS is compatible with many popular modules, including cPanel, Plesk, and SolusVM, as well as a variety of ModulesGarden products.

The Wiki page for Advanced Billing For WHMCS 3.x can be found here.

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

The content of the package to upload should look like this.

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

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

Log in to your WHMCS admin area. Click 'System Settings' , then choose 'Addon Modules'.
Afterward, find 'Advanced Billing' and press the 'Activate' button.

To do so, click on the 'Configure' button, tick the desired admin roles, and press 'Save Changes'.

 php -q /your_WHMCS/modules/addons/AdvancedBilling4/cron/cron.php cron  

We recommend setting it to run at 5-minute intervals. If there are any issues with cron execution, you will be notified about the time it stopped running.

Refer to the manual below to learn how to configure the module and make full use of its extensive features.

Select your product from the dropdown list.

• Set Pricing
• Configure Settings
• Show Related Items
• Delete Product from the List

The pricing list includes information on each usage record:

• Name
• Unit
• Billing Status
• Extended Pricing

Click on the 'Edit' button to set up billing for a usage record.

• Enable or Disable Billing for the Record
• Select Billing Type
  • Last - calculates the total based on the most recent reading only.
  • Summary - sums all collected records and bills based on the cumulative amount.
  • Hourly - averages hourly readings and bills according to that average.
• Select Unit

• Price - the value per unit that clients will be billed with.
• Free Usage Amount - the number of set units that, when exceeded, will enable billing.

• Cron Frequency - define how often the cron will run for the product. Use seconds as the unit.
• Summary Calculation Method - choose how summaries are calculated:
  • Total Sum
  • Total Average (Hourly only)
• Client Area Integration - toggle to enable client area integration for the product, this option does not add features on its own but is a requisite for other functions to be displayed in the client area.

cPanel Extended

• Application Manager
• cPanel Theme

Proxmox VE Cloud VPS

• Free IPv4 Addresses
• Free IPv6 Addresses

OpenStack

• OpenStack Timezone
• Local Timezone

and more.

Enable the functionality with the 'Enable Credit Billing' toggle and configure the details:

• Create Invoice Every - dictates how often invoices are generated for the product.
• Minimum Credit - the minimum amount that will be charged from the client account credit balance.
• Low Credit Notification - if this value is higher than the credits on the client's account, an email will be sent to your client regarding the low credit amount.
• Email Interval - defines how often low credit notification email will be sent, the interval refers to the number of days.
• Autosuspend - when the credit balance reaches 0, the product ordered by the client is automatically suspended and an invoice reminding of the lacking amount will be generated.
  Note: This function also takes account of the ''Override Auto-Suspend' feature.
• Due Date - determines how many days after the invoice is generated the payment is due.
• Use Client Credits - if enabled, the invoices can be paid with the client credits. If disabled, the default payment method will be used.

• Auto Apply Credits - enable to automatically apply user credits if available.
• Tax - if enabled, the tax will be added to the created invoice.
• Hours - define a number of hours that must pass before the service is billed at a monthly rate.
• Due Date - define payment due date.
• Currency - set the pricing amount in any currency to bill clients after a declared number of hours has passed.

• Billing Overview Interval (Days) - define how often billing overviews should be refreshed.
• Minimum Credit - determine the minimum amount that will be charged from the client's account.
• Low Credit Notification - define the credit balance low point when an email notification will be sent.
• Email Interval - set interval for email notifications, measured in days.
• Autosuspend - suspend the account automatically if the user does not have sufficient funds.
• Due Date - number of days between the invoice being generated and due date.

After the client indicates the amount of credits to be added to his account, an invoice will be generated for it.
Only after the invoice is paid, will the client receive the credits.

• Invoice on Termination - when the account connected with your module is terminated, an invoice for the account will be generated.
• Billing Type - enables you to choose how to bill your client.
  • Bill On Invoice Generated - new items will appear on the renewal invoice for the hosting account just as it is generated by WHMCS.
  • Bill On Specific Day - generates invoices each month on the day specified in the 'Billing Type Value'.
  • Bill Every X Days - generates an invoice each X days where X is the number specified in the 'Billing Type Value' field.
• Due Date - the number of days in which your customers will have to pay the invoice.
• Auto Generate Invoice - if enabled, the invoices are automatically generated and sent directly to your customers.
• Auto Apply Credits - automatically applies any available credits when an invoice is created. Works only if the 'Auto Generate Invoice' option is enabled.
• Show Advanced Billing Information - this will replace any 'Billing Cycle' with 'Hourly Billing' on the product management page in the client area.
• Apply Group Discount - enable if you want to apply the discount to the invoice set in the client group.

• Reminder Limit - limit how many reminders a client can create.
• Email Template - email template that will be used.
  

• {$reminder_name} - the name of a reminder set by a client.
• {$type} - the resource type for which the limit has been set by a client. E. g. 'Storage' , 'Bandwidth' etc.
• {$usage} - the current recorded usage value of the resource type the limit is set for.
• {$limit} - the limit value defined by a client whose reaching or exceeding results in sending the notification.
• {$unit} - the unit of the billed record. E.g. 'MB' , 'GB' etc.

To add a new notification click on the 'Add Reminder' button.

• Name - name your reminder, it is used in the default notification template.
• Checks Frequency - how often a resource check is performed, in hours.
• Reminders Frequency - limits how often a reminder can be sent, in hours.

• Edit Reminder
• Define Limits
• Delete

• Used - current recorded usage of the given resource.
• Operator - logical operator used for the argument.
• Value - the value for the logical operation.

For example, we can set the reminder to be sent after the bandwidth is 'is more' than 20000MB, as shown on the screen below.

• Display Summary From - defines the period for which usage records will be counted.
• Usage Records Precision - the number of decimal digits indicating the precision of usage records.
• Records History - displays history of usage records.
• Display Usage Records Pricing - displays usage record pricing for the product during the order process.
• Show Usage Details Per Subitem - display detailed usage history for subitems in cloud services.
  Additional usage details will be listed in the 'Usage Details Per Subitems' on the service page in the client area.

Note: The screen below is taken from the Proxmox VE Cloud VPS product view, not cPanel Extended, as all other illustrations in this section.

This feature enables precise control over complimentary usage thresholds before charges apply.
After enabling the feature with the 'Enable Free Limit' toggle, select the configurable options responsible for the resources below.
The configurable option has to be created for the product first. The configurable option value represents the resource in units selected under 'Products' → 'Pricing'.
Leave fields empty, to not enable the free limit on selected resources.

They will be able to change the graph's scope and resources displayed.

After enabling the function, take a look at the Product Auto Upgrade Management section to prepare the options.

• Enable/disable automatic upgrades for their product.
• Set a minimum time interval that has to pass between upgrades.
• Include/exclude certain upgrade options.
• See and/or change upgrade conditions.
• See their upgrade history.
• Set upgrade notifications based on resource usage.

The cancellation bypasses the standard queue, and the service is terminated right away.
Billing is stopped instantly, and if applicable, any remaining balance is refunded.

The 'Item List' includes current billable items, while the 'Item Archive' lists historical items that are already billed.

The list includes information such as:

• Item ID
• Hosting Name
• Client Name
• Total Amount
• Last update

And action button responsible for:

• Viewing details
• Viewing the graph
• Deleting the item from the list

The page includes action buttons responsible for:

• Deleting the item
• Generating an invoice for the item

The list includes information such as:

• Item ID
• Hosting Name
• Client Name

And action button responsible for:

• Viewing details
• Deleting the item from the list

This includes 'Invoices' and 'Credits'.

The invoice list includes:

• Invoice ID
• Client Name
• Hosting Name
• Product Name
• Total
• Date
• Due Date

And action buttons responsible for:

• Generating the invoice
• Displaying details
• Deleting the invoice

• Invoice Date
• Invoice Due Date

and every billed item with its:

• Description
• Amount
• Tax toggle

The list includes:

• Client Name
• Hosting
• Credits Reserved
• Amount Paid

and an action button allowing the admin to 'Refund' the credits to WHMCS 'Credit Balance'.

This section is only relevant for products with the Product Auto Upgrade function enabled.

• Name - name the group, the name will not be visible to clients.
• Product - select the product the group will be applicable for.
• Configurable Options Group - optionally include a configurable options group.

• Edit the group's settings.
• Add and manage upgrade options within the group.
• Delete the group from the list.

• Group Name
• Server Type
• Time Interval - how often upgrades can happen (in minutes).
• Notification Time Interval - how often the notification can be sent (in minutes).

• Client Rules Configuration - display rules configuration in the client area.
• Rules Configuration - enable clients to change the upgrade rules for themselves.
• Rules Disable - permit clients to disable some of the upgrade rules.
• Time Interval - give clients the option to modify upgrades time interval.
• Time Interval Values - define the allowed range for upgrades time interval (minutes).
• Notifications - allow clients to manage notifications.
• Notifications Time Interval - allow clients to modify notifications time interval.
• Notifications Time Interval Values - define the allowed range for notifications time interval (minutes).

To begin, click on the 'Add Option' button and name the option.

• Edit - define the upgrade and downgrade rules.
• Change Package - select which package will be used for the option.
• Change Description - add descriptions to each option's configuration.
• Delete - delete the option from the group.

The list includes information such as:

• Hosting ID
• Client Name
• Product Name
• Option ID

The 'Details' action button will display more information on a specific account.

• Date of the update
• Type
• Option before the upgrade
• Option after the upgrade
• Message regarding the action taken

Assuming 'Client Rules Configuration' is enabled, clients will be able to change how their service interacts with the system by clicking on the 'Settings' icon under 'Auto Upgrade'.

• Enable Auto Upgrade - can be turned off to disable auto upgrades altogether.
• Time Interval - change the minimum time that has to pass between upgrades.

• Cron Memory Limit - limit how much memory the cron can use (in megabytes). If exceeded, the cron will restart. Leave empty or set to 0' to disable the limit.
• Cron Threads - toggle to enable cron threading.
• Threads Limit - limit the number of threads for the above function.
• Thread Accounts - limit the number of accounts per thread
• Clear Logs - toggle to have the cron clear logs.
• Clear After [days] - enter how old the logs have to be to be subject to clearing (in days). The default is 365 days.

Cron job additional options:

• --force → Runs a single cron loop immediately.
• --single → Forces execution of the module-specific cron.
• --ignore-product-frequency → Runs cron without applying product frequency settings.
  Note: If you prefer not to run the module in daemon mode (as the module runs continuously by default), you can use these cron options to control execution manually.

• Clear Automatically - Enable to automatically clear the item archive under specified conditions.
• Flush Interval - Decide how often (in days) the flush should happen.
• Delete Archive Items Older than - Decide how old the archive items have to be to be subject for deletion during flush.

This includes:

• Translations Tool
• Access Control
• Module Logs

Prepare translations for the original English files with this handy built-in tool. For specific instructions on how to use this tool please refer to its dedicated article, you will find it here.

For more detailed information on the available modules that include this tool, please refer to the Access Control Tools Wiki Page.

Start with creating a new rule, click on the 'Create Rule' button and a dedicated form will appear. Below you will find a description of every field required in the form.

• Rule Name - Pick a name for your rule.
• Grant Full Access - Enable to grant full access to all sections of the module to the specified personnel. Disable to specify in two additional fields below, to which resources access will be granted, and to which it will be denied.
• Allow Access To - Designate the resources that the specified personnel will have access to.
• Restrict Access To - Specify the resources that the specified personnel will not have access to.
• Administrators - Specify which singular administrators will be subject to the new rule. If the specific administrator is already included in the group you have picked, you do not need to add him separately.
  Note: All restrictions for specific administrators are summed with the restrictions on their role groups, across all rules.
• Administrator Roles - Specify which administrator role groups will be subject to the new rule.
  

Important: When picking specific sections, keep in mind that allowing a parent section will also allow all of its children.
For example by allowing 'Access Control' you allow every section of it
If you would like to give access to everything about Access Control, but the ability to delete logs, you can pick 'Access Control' in 'Allow Access To' and then 'Access Control → Logs → Delete' in 'Restrict Access To.'
Restrict takes precedence over Allow, so if a specific section is included in both, it will be restricted.

• Log ID
• Name of the administrator
• Requested resource
• Applied Resource
• Rule Name
• Date

Use the trash bin icons to delete specific logs, or utilize the mass action function to delete multiple logs at once.

You can filter the module logs by type with the 'Show' buttons:

• Error
• Info
• Both (Total)

• Logging Settings
• Log Export
• Rule Based Deletion

• Log Types - which type of logs should be recorded.
• Clear automatically - if you would like to automatically delete logs older than defined number of days.
• Delete Logs Older Than - how many days should pass before logs are automatically deleted.

• From
• To
• Log Types

• Log Types
• Delete Logs Older Than

Explore the examples below for practical insights into how the module works.

You benefit from full cost transparency, a secure prepaid system, and automated billing, while your clients enjoy fast provisioning and real-time insights into their usage and expenses.

• Client autonomy - Clients pay once, top up their accounts, and deploy services anytime, without additional steps for approval.
• Real-time cost overview - Clients can monitor daily costs, projected expenses, and pricing per resource (CPU, RAM, bandwidth).
• Secure prepaid billing - Services activate only after funds are deposited, eliminating unpaid usage risks.
• Self-service top-ups - Clients add credit anytime from the WHMCS client area.

• Usage analytics - Clients gain access to detailed, near real-time tracking of individual resource usage.

• Visual insights - Clients can view usage patterns through clear, intuitive graphical representations.

• Prepaid Billing - Deducts charges from the client's prepaid credit balance, consolidating multiple charges into a single summary invoice, making it ideal for dynamic cloud environments.
• Credit Billing - Deducts costs from a client's available credit instead of using standard payment methods.
• Recurring Billing - Automatically charges clients at set intervals for their services.
• Fixed Pricing - Bills a fixed amount after a defined number of usage hours. Suitable for predefined pricing plans.

• Proxmox VE Cloud VPS For WHMCS
• SolusVM 2 VPS & Cloud For WHMCS

For enterprise-level solutions, you may use:

• OpenStack Projects For WHMCS - fully compatible with Virtuozzo Hybrid Infrastructure.

• Cron Frequency - Set how often the cron should run (in seconds).
• Summary Calculation Method - Choose between:
  • Total Sum
  • Total Average (Hourly only)
• Client Area Integration - Enable to allow features like usage overviews and resource summaries to appear in the client area.

• Billing Overview Interval (Days) - Frequency for generating billing summaries.
• Minimum Credit - Minimum charge amount per deduction cycle.
• Low Credit Notification - Credit threshold that triggers a low balance warning.
• Email Interval - Time (in days) between low balance reminder emails.
• Autosuspend - Automatically suspend service if the client has insufficient funds.
• Due Date - Days between invoice creation and due date (used if invoice generation is active).

• Usage Records – for precise, near real-time tracking of resource consumption.
• Graphs – for graphical visualization of usage trends in the client area.

Your clients can now top up their balance, deploy services, monitor usage, and manage everything directly from the WHMCS client area.

Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues.
Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.

1. Optionally backup your language files and license.
   
2. Delete all old module files.
   
3. Upload new module files from version 4.0.
   
4. Re-add the license to license.php and reissue it in your client area.
   
5. Cron Job Update:
   
   • Delete the old cron job.
   • Kill the cron process.
   • Run the upgrade command:

     php -q whmcs/modules/addons/AdvancedBilling4/cron/cron.php upgrade run "4.0.0" 

   • Set the new cron job, make sure to replace 'your_WHMCS' with your WHMCS directory path:

     php -q /your_WHMCS/modules/addons/AdvancedBilling4/cron/cron.php cron 

Opt for the Open Source version of your Advanced Billing For WHMCS module to unlock these benefits.
Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied.

Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.

This option will be implemented in future releases of the Advanced Billing module.