Difference between revisions of "Automated Upgrades and Downgrades"

From WHMCS Documentation

(How it works)
 
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
==How it works==
 
==How it works==
  
With the automated upgrading & downgrading features in WHMCS, your clients can upgrade or downgrade the products and packages they have with you from the client area. When they place an upgrade or downgrade order, they will be refunded what they haven't used of the current cycle on the existing product/service and then charged for the remainder of the cycle at the new product/services price. The next due date doesn't change.
+
In WHMCS, your clients can upgrade or downgrade their products and packages directly in the Client Area. When they place an upgrade or downgrade order, they will receive a refund for any value they haven't used of the current cycle on the existing product or service. Then, the system will charge them for the remainder of the cycle at the new product's or service's price. The next due date doesn't change.
  
 
<div align="center">
 
<div align="center">
 
<p>'''Old Product/Service'''<br />
 
<p>'''Old Product/Service'''<br />
 
Price Per Day * Number of days until next due date = Amount Credited</p>
 
Price Per Day * Number of days until next due date = Amount Credited</p>
 
+
<div class="docs-alert-info">
 +
'''Price Per Day''' in the above calculation is the '''Recurring Amount''' of the client's service divided by the number of days in the billing cycle.
 +
</div>
 
<p>'''New Product/Service'''<br />
 
<p>'''New Product/Service'''<br />
 
Price Per Day * Number of days until next due date = Amount Debited</p>
 
Price Per Day * Number of days until next due date = Amount Debited</p>
 
+
<div class="docs-alert-info">
 +
'''Price Per Day''' in the above calculation is the cost of the new service divided by the number of days in the billing cycle.
 +
</div>
 
<p>'''Total Payable Today = Amount Debited - Amount Credited'''</p>
 
<p>'''Total Payable Today = Amount Debited - Amount Credited'''</p>
 
</div>
 
</div>
  
 
===Free to Paid Products===
 
===Free to Paid Products===
When a free product is upgraded to a paid product a Next Due Date needs to be set to determine when it will renew. WHMCS sets this automatically to 1 billing cycle from the date of upgrade.
 
  
EG. If a client upgraded from a free product to a monthly paid product on 1st Jan, the Next Due Date would be set to 1st Feb.
+
When a client upgrades a free product to a paid product, you must set a '''Next Due Date''' to determine when it will renew. WHMCS sets this automatically to one billing cycle from the date of upgrade.
 +
 
 +
For example, if a client upgraded from a free product to a monthly paid product on the 1st of January, the '''Next Due Date''' would become the 1st of February.
  
 
===Promotion Codes===
 
===Promotion Codes===
 +
 
====Upgrade Discounts====
 
====Upgrade Discounts====
[[Promotions#Upgrades.2FDowngrades|Promotion codes]] can be configured to apply to upgrades, this is useful for incentivizing clients to upgrade to higher tier products. When the client places an upgrade order they will be given the opportunity to enter a promo code. The discount is calculated based on the total amount due. This is given as a discount on the amount payable today.
+
 
 +
You can configure [[Promotions#Upgrades.2FDowngrades|promotion codes]] to apply to upgrades. This is useful for incentivizing clients to upgrade to higher-tier products. When the client places an upgrade order, they will receive the opportunity to enter a promo code. The system calculates the discount based on the total amount due. Clients receive this as a discount on the amount payable.
 +
 
 +
<div align="center">
 +
'''Total Payable Today (from above) - Discount = Discounted Upgrade Price'''
 +
</div>
  
 
====Lifetime Promotions====
 
====Lifetime Promotions====
[[Promotions|Promotion codes]] can be configured to last the lifetime of a client's service - even sustained through upgrades and downgrades. If this is the case, the recurring discount is calculated based on the full product price after the upgrade has completed. The full product price is obtained and then the discount calculated based on that. The recurring price is reduced accordingly and then updated on the client's service.
 
  
==Clients Self Service==
+
You can configure [[Promotions|promotion codes]] to last the lifetime of a client's service, including through upgrades and downgrades. For these, the system calculates the recurring discount using the full product price after the upgrade. The recurring price is reduced accordingly and then updated on the client's service.
  
In order to place an upgrade/downgrade order, the client has to login to the client area, navigate to the '''My Products/Services''' section, click into view the full details for the product or service they wish to manage, and then select the options to either upgrade the Package or upgrade the Configurable Options.
+
===Upgrade Order Handling===
  
==Admin/Staff Upgrades==
+
If an upgrade order is not paid before the renewal invoice is generated by the daily cron task, the system cancels the upgrade order automatically and generates the renewal invoice using the current service details. To upgrade, the client must place another upgrade order.
  
Staff can also create upgrade orders from the admin area. Staff are not restricted to just the products or options that are defined in the product config, so any single package can be upgraded to any other. Using the upgrade process will create the prorata invoice for the difference, and then auto provision it upon payment. To create an upgrade order from the admin side, simply navigate to the product that is to be upgraded and then click the '''"Create Upgrade/Downgrade Order"''' link displayed to the top right of the product config.
+
== Creating Upgrade and Downgrade Orders ==
 +
 
 +
Upgrading and downgrading is available in both the Client Area and Admin Area:
 +
 
 +
==In the Client Area==
 +
 
 +
To place an upgrade or downgrade order from the Client Area:
 +
 
 +
# Go to '''Services > My Services'''.
 +
# Click to view the full details for the desired service.
 +
# Select the desired upgrade options.
 +
 
 +
==In the Admin Area==
 +
 
 +
The system doesn't restrict admins to the products or options in the product configuration, so admins can upgrade between any two packages. Using the upgrade process will create the prorata invoice for the difference and auto-provision it on payment.  
 +
 
 +
To create an upgrade order from the Admin Area:
 +
# Go to the '''Products/Services''' tab in the client's profile.
 +
# Go to the service to upgrade.
 +
# Click '''More > Upgrade/Downgrade'''.
  
 
==Configuration==
 
==Configuration==
Line 37: Line 66:
 
===Product Upgrades===
 
===Product Upgrades===
  
In order to allow clients to upgrade and downgrade their package, you need to specify exactly which products can be upgraded and downgraded to from each of your packages. This is done in '''Setup > Products/Services > Products/Services''' on the '''Upgrades''' tab of the product configuration.
+
To allow clients to upgrade and downgrade their packages, you need to specify the products that can upgrade to and downgrade to each of your packages.  
 +
 
 +
To do this, go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Products and Services|Products/Services]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Products/Services''' in the '''Upgrades''' tab of the product configuration.
  
To select multiple products that can upgraded/downgraded to, hold the '''Ctrl''' key while selecting the products in the list.
+
To select multiple products, hold the '''Ctrl''' key while selecting the products in the list.
  
 
===Configurable Options Upgrades===
 
===Configurable Options Upgrades===
  
With the configurable options upgrade configuration, this allows your clients to upgrade or downgrade the configurable option selections you offer on the product.  You do not need to specify any further configuration for this - by simply ticking the box the upgrade options will be shown to the client in the client area. The upgrade price for configurable options are calculated in exactly the same was products described above.
+
With the configurable options upgrade configuration, this allows your clients to upgrade or downgrade the configurable option selections you offer on the product.  You do not need to specify any further configuration for this.
 +
 
 +
Check the checkbox and the client will see the upgrade options in the Client Area. The system calculates the upgrade price for configurable options the same way as the products above.

Latest revision as of 16:04, 16 May 2023

How it works

In WHMCS, your clients can upgrade or downgrade their products and packages directly in the Client Area. When they place an upgrade or downgrade order, they will receive a refund for any value they haven't used of the current cycle on the existing product or service. Then, the system will charge them for the remainder of the cycle at the new product's or service's price. The next due date doesn't change.

Old Product/Service
Price Per Day * Number of days until next due date = Amount Credited

Price Per Day in the above calculation is the Recurring Amount of the client's service divided by the number of days in the billing cycle.

New Product/Service
Price Per Day * Number of days until next due date = Amount Debited

Price Per Day in the above calculation is the cost of the new service divided by the number of days in the billing cycle.

Total Payable Today = Amount Debited - Amount Credited

Free to Paid Products

When a client upgrades a free product to a paid product, you must set a Next Due Date to determine when it will renew. WHMCS sets this automatically to one billing cycle from the date of upgrade.

For example, if a client upgraded from a free product to a monthly paid product on the 1st of January, the Next Due Date would become the 1st of February.

Promotion Codes

Upgrade Discounts

You can configure promotion codes to apply to upgrades. This is useful for incentivizing clients to upgrade to higher-tier products. When the client places an upgrade order, they will receive the opportunity to enter a promo code. The system calculates the discount based on the total amount due. Clients receive this as a discount on the amount payable.

Total Payable Today (from above) - Discount = Discounted Upgrade Price

Lifetime Promotions

You can configure promotion codes to last the lifetime of a client's service, including through upgrades and downgrades. For these, the system calculates the recurring discount using the full product price after the upgrade. The recurring price is reduced accordingly and then updated on the client's service.

Upgrade Order Handling

If an upgrade order is not paid before the renewal invoice is generated by the daily cron task, the system cancels the upgrade order automatically and generates the renewal invoice using the current service details. To upgrade, the client must place another upgrade order.

Creating Upgrade and Downgrade Orders

Upgrading and downgrading is available in both the Client Area and Admin Area:

In the Client Area

To place an upgrade or downgrade order from the Client Area:

  1. Go to Services > My Services.
  2. Click to view the full details for the desired service.
  3. Select the desired upgrade options.

In the Admin Area

The system doesn't restrict admins to the products or options in the product configuration, so admins can upgrade between any two packages. Using the upgrade process will create the prorata invoice for the difference and auto-provision it on payment.

To create an upgrade order from the Admin Area:

  1. Go to the Products/Services tab in the client's profile.
  2. Go to the service to upgrade.
  3. Click More > Upgrade/Downgrade.

Configuration

Product Upgrades

To allow clients to upgrade and downgrade their packages, you need to specify the products that can upgrade to and downgrade to each of your packages.

To do this, go to Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services > Products/Services in the Upgrades tab of the product configuration.

To select multiple products, hold the Ctrl key while selecting the products in the list.

Configurable Options Upgrades

With the configurable options upgrade configuration, this allows your clients to upgrade or downgrade the configurable option selections you offer on the product. You do not need to specify any further configuration for this.

Check the checkbox and the client will see the upgrade options in the Client Area. The system calculates the upgrade price for configurable options the same way as the products above.