Invoice Management

The lists of invoices allow you to view and search all of the invoices in your WHMCS installation.

You can view lists of invoices at Billing > Invoices.

Create an Invoice

WHMCS automatically generates invoices for recurring products and services. You can also create custom one-time invoices for specific clients.

To create a one-time custom invoice for a specific client:

  1. Use one of the following methods to create the draft invoice. The system will create a new invoice in the Draft status.
    • From the client’s profile’s Summary tab, click Create Invoice.
    • From anywhere in the Admin Area, click the + icon at the top of the interface and choose New Invoice.
      1. Choose a client.
      2. Enter invoice and due dates.
      3. Select a payment method.
      4. Click Create Invoice.
  2. To configure the invoice’s details:
    1. Update the desired settings in the Options tab.
    2. Click Save Changes.
  3. Under Invoice Items, for each invoice item that you wish to add:
    1. Enter a description and amount.
    2. Click Save Changes. A new row will then appear to allow adding further line items.
  4. To publish the invoice, choose the Summary tab and click a publishing option. These options only display when the invoice is in the Draft status, and clicking them will set Invoice Date to the current date:
    • Publish & Send Email — Convert the invoice to the Unpaid status and send the Invoice Creation email to the customer.
    • Publish — Convert the invoice to Unpaid without notifying the customer.

You can navigate away from the invoice at any time during this process and return to it later. WHMCS will store the invoice as a draft and it will not be visible to the customer until you have published it.

The due date for manually-created invoices defaults to the same number of days in the future as you allow for automatic invoice generation. You can customize this via the Options tab when managing an invoice.

Find and View Invoices

To find and view invoices, use the following methods:

Click the invoice ID or, in WHMCS 8.9 and later, click View in the list of invoices to view the desired invoice.

In WHMCS 8.9 and later, invoices default to view-only mode. This decreases the risk of unintentional edits while viewing or paying client invoices.

  • Admins who have the Manage Invoices permission can:
    • Click Manage Invoice to edit the invoice.
    • Click Edit while viewing a list of invoices to skip view-only mode and go directly to editing the invoice.
  • Admins who have the View Invoice permission can view invoices, add payments and credit, issue refunds, and add notes if they have the correct permissions for these tasks. They cannot edit invoice contents.


You can view the information for an invoice and perform many actions using several tabs:


The Summary tab lists the client name, invoice and due dates, invoice items, and associated transactions, and allows you to send client emails.

To send an email for the selected invoice, choose the desired email template from the menu under the invoice status and click Send Email.

You cannot send email for invoices that are in the Draft status. You must first publish the invoice before sending email.
For more information, see Emailing Clients.

Cancel an Invoice

To cancel an invoice, click Mark Cancelled under the invoice status.

  • In WHMCS 8.10 and later, the system cron can automatically cancel invoices after they have been overdue for a specified number of days. You can enable this setting and set the number of days in the Billing Settings section at Configuration () > System Settings > Automation Settings.
  • In WHMCS 8.9 and later, you must have the Manage Invoices permission and click Manage Invoices in the top-right corner while in view-only mode to perform this action.

Split to New Invoice

In WHMCS 8.9 and later, you must have the Manage Invoices permission and click Manage Invoices in the top-right corner while in view-only mode to perform this action.

Splitting invoices allows you to separate line items from an invoice into a separate invoice. This is useful if, for example, items appear together on a single invoice that a client wants to renew separately or a merge happened incorrectly.

To split items, select the desired items under Invoice Items and then choose Split to New Invoice from With Selected. The system will immediately move all of the items to a single new invoice.

  • This process does not send an email to the customer. If you want to notify the customer, click Send Email.
  • When splitting an invoice, the system sets the due date of the resulting invoice based on the current date and Invoice Generation settings in Configuration () > System Settings > Automation Settings.


In WHMCS 8.9 and later, you must have the Manage Invoices permission and click Manage Invoices in the top-right corner while in view-only mode to perform this action.

To delete items from an invoice, select the desired items under Invoice Items and then choose Delete.

This does not move the deleted items to a new invoice.

Add Payment

If you receive a payment that the system hasn’t automatically logged in WHMCS, you will need to manually apply it to the invoice.

To do this, enter the details corresponding to the payment, including the date, payment method, transaction ID, and amount. Then, click Add Payment.

  • If a payment is not for a specific invoice, issue credit to the client instead.
  • If a payment applies to multiple invoices, add a transaction at Billing > View Transaction List. For Invoice ID(s), enter a comma-separated list of all of the invoice numbers to apply payment to.
    • The system will apply payments in the order you enter them until the client has used the full amount.
    • The system will automatically add any amount left over as a credit to the user for use on future invoices.


In WHMCS 8.9 and later, you must have the Manage Invoices permission and click Manage Invoices in the top-right corner while in view-only mode to use this tab.

In the Options tab, you can configure the following invoice settings:

Invoice DateThe date on which the system generated the invoice or you created it.
Payment MethodThe payment method that the system will attempt to use to pay the invoice.
Invoice #The invoice number.
Due DateThe invoice’s due date.
Tax RateThe rate at which the system will tax the items in the invoice.
StatusThe invoice status.


Admins can add funds to a client account in the client’s profile’s Summary tab.

In the Credit* tab, you can add credit to the invoice.

  • To add credit from a client’s balance to an invoice, enter the desired amount under Add Credit to Invoice and click Go.
  • To remove credit from an invoice, enter the desired amount under Remove Credit from Invoice and click Go.

Automatically-generated invoices always check whether a client has a positive credit balance. If they do, the system automatically applies the credit to the invoice during invoice generation. If applying credit reduces the invoice balance to 0, the system marks the invoice Paid automatically.


In the Refund tab, you can refund transactions for the invoice. Refunding transactions allows you to issue credits and refunds for payments that clients have made.

The Refund tab for an invoice

If the system can’t automate a refund for your particular gateway, you can still use this process to enter the refund billing entry in WHMCS. It will update the income totals and reflect the refund on the invoice. Then, you can go to your payment gateway to send the refund.

Refund a Transaction

To refund a transaction:

  1. If there have been multiple transactions for the invoice, select the desired transaction from Transactions.
    You can only refund one transaction at a time, and the refund amount cannot exceed the total amount of the transaction.
  2. For Amount, enter the amount to refund for a partial amount. Otherwise, leave this blank to refund the entire transaction value.
  3. Select the desired type from Refund Type:
    • Refund through Gateway — If your payment gateway supports refunds, WHMCS sends the refund to your gateway to process. This returns the money to the payment method that the client used.
    • Manual Refund Processed Externally — WHMCS records a refund in the system. You must then process the refund separately with your payment gateway. You may also use this if a chargeback or dispute occurs.
    • Add to Client’s Credit Balance — WHMCS records a refund and adds the refunded balance to the client’s credit balance. This does not return any money to the customer.
  4. Check Reverse Payment if you want to reverse the effects of the original payment (for example, when you set the invoice status to Collections and reverse the service’s Next Due Date.
    • When you check this, the system’s actions depend on the configuration in Configuration () > System Settings > Automation Settings.
    • This setting does not alter the system’s treatment of any affiliate commissions (see the steps below).
      For more information, see Payment Reversals.
  5. If you do not want to send a refund confirmation email, uncheck Send Email.
  6. Click Refund.

Reversing Affiliate Commission

In WHMCS 8.3 and later, if the transaction is associated with an affiliate commission and the payment gateway supports reversals, WHMCS can also reverse the commission.

  • When you perform a full refund, WHMCS automatically reverses all of the associated commissions.
  • When you perform a partial refund, WHMCS will ask you whether to also reverse the commission. You cannot, however, choose an amount of the commission to reverse. This action reverses the entire amount.
  • If you choose not to perform a commission reversal, the commission payment will not be affected. The page will reload and display the results of the refund attempt if you chose Refund through Gateway. If it fails for any reason, the Gateway Log can provide more information.


In WHMCS 8.9 and later, you must have the Manage Invoices permission and click Manage Invoices in the top-right corner while in view-only mode to use this tab.

Use the Notes tab to enter notes about the invoice.

Last modified: June 11, 2024