> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.clientexec.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Billing Cycles

_ **Clientexec 6.2.0** _ introduces a new _ **Billing Cycles** _ section, which allows the admins to configure custom billing cycles to be used throughout the application.

**Manage billing cycles permission**

In order for an admin to be able to use this new section, it requires to be either a _ **Super Admin** _ or having enabled the new admin permission _ **Manage billing cycles** _.

To configure the permission:

- go to _ **Settings > Users > Staff Management** _
- click on a Staff Role name, then select _ **Edit Permissions** _
- go to _ **Admin Permissions > View Billing Setup > Manage billing cycles** _
- after enabling the permission, do not forget to click the _ **Update Permissions** _ button

**Billing Cycles section**

The new _ **Billing Cycles** _ section allows admins to add, edit, and delete billing cycles.

This section can be located at:

- _ **Settings > Billing > Billing Cycles** _

In the new _ **Billing Cycles** _ section, there is a list of all the available billing cycles that were introduced by default with the installer, as well as the options to add, edit and delete billing cycles.

**One Time billing cycle**

There is an especial billing cycle that is not like the others.

By default, this billing cycle is named _ **One Time** _ and it _ **can never be deleted** _ but it _ **can be renamed** _ if required but taking into account that the name will appear on invoices and several places related to billing.

The _ **One Time** _ billing cycle is used for:

- one time payment price for products
- setup price for addons
- non-recurring charges

**Add Billing Cycle**

In order to add a new billing cycle, click on the _ **Add Cycle** _ button and the following popup will appear:

![](https://storage.crisp.chat/users/helpdesk/website/895a2775afb3f800/billingcycles1_1p9q7j8.png)

- _ **Name** _

  - Avoid using duplicated names to avoid confusion
  - Recommended names are the number of the _ **Amount of Units** _, followed by a single space character, followed by the name of the _ **Time Unit** _ starting with uppercase. This will help the translation system to translate the new custom billing cycle name to other languages, but any name can be used. Examples: 1 Day, 2 Days, 1 Week, 2 Weeks, 1 Month, 2 Months, 1 Year, 2 Years

- _ **Time Unit** _

  - _ **Days** _: stored in the database as _ **d** _
  - _ **Weeks** _: stored in the database as _ **w** _
  - _ **Months** _: stored in the database as _ **m** _
  - _ **Years** _: stored in the database as _ **y** _

- _ **Amount of Units** _

  - The value should be a positive integer number representing how many _ **Time Units** _ it will be using

Every billing cycle is a unique combination of _ **Time Unit** _ and _ **Amount of Units** _.

Attempting to submit a combination that already exists will be ignored **.**

**Edit Billing Cycle**

In order to edit an existing billing cycle, click on the billing cycle name and the same popup like the one for  **Add Billing Cycle**  will appear, displaying the current configuration of that billing cycle.

**Delete Billing Cycle**

Select the billing cycles to be deleted by checking their respective check-boxes, then, click _ **Delete** _ button.

Attempting to delete the _ **One Time** _ billing cycle will be ignored.

If a billing cycle is in use (there are Recurring Fees using it), it can not be deleted.

**Coupons**

When configuring a coupon, please take into account that the field _**Duration (months)**_ should be used only for _ **Billing Cycles** _ which have their _ **Time Unit** _ in _ **Months** _ or _ **Years** _.

The value should be an integer number representing _ **how many months** _ it will be recurring.

**Products**

Products of _ **any type** _ will have available the _ **One Time** _ billing cycle.

Products of type _ **Domain** _ and their respective _ **Addons** _ will only be able to use billing cycles that have their _ **Time Unit** _ in _ **Years** _, and the _ **One Time** _ billing cycle.

Products of type _ **SSL ** _will only be able to use billing cycles that have their _ **Time Unit** _ in _ **Years** _, and the _ **One Time** _ billing cycle.

When configuring a product, please take into account that the field _ **Prorate To Day** _ and _ **Include Following Payment** _ should be used only for _ **Billing Cycles** _ which have their _ **Time Unit** _ in _ **Months** _ or _ **Years** _.

**Addons**

Products of type _ **Domain** _ and their respective _ **Addons** _ will only be able to use billing cycles that have their _ **Time Unit** _ in _ **Years** _, and the _ **One Time** _ billing cycle.

**Recurring Fees**

When configuring a recurring fee, please take into account that the field _ **Duration in months** _ should be used only for _ **Billing Cycles** _ which have their _ **Time Unit** _ in _ **Months** _ or _ **Years** _.

The value should be an integer number representing _ **how many months** _ it will be recurring.

**Order New Service**

When using a _ **Direct Link** _ to allow placing direct orders for a new product or service, it is possible to indicate in the _ **Direct Link** _ the billing cycle wanted to be used, with the _ **GET** _ parameter _ **paymentterm** _, using either the _ **billing cycle id** _ or a _ **value representing the billing cycle** _.

In Example, 15 days can be either 15d or d15, 1 week can be either 1w or w1, 3 months can be either 3m or m3, 2 years can be either 2y or y2, etc.

**Updating custom Plugins or code**

_ **If having custom plugins or code** _, that is making use of billing cycles, please take a look [here](/en/article/updating-custom-code-for-billing-cycles-16fc387/) for more details about how to proceed.

