Revision as of 16:51, 1 November 2011

Promotions can be setup to offer discounts on your Products & Services. Discounts cannot currently be offered on Product Addons or Domains. To create a promotion code navigate to Setup > Promotions.

See also Common Promotions

Types of promotions that can be offered

• One Time Discounts
• Recurring Discounts
• Limited Recurring Discounts (eg. First 2 months free)
• Monetary Discounts (eg. $5 Off)
• Percentage Discounts (eg. 20% Off)
• Apply to Specific Products/Addons/Domain TLDs
• Apply to Specific Billing Cycles or Registration Periods
• Apply Once per Order or to All Applicable Items in Cart
• Valid for New Signups Only
• Valid for upgrade orders only

How to create a new promotion

1. Begin by going to Setup > Promotions
2. Click the Add New link at the top of the page
3. You must enter a promotion code - this is the code that customers will need to enter on the order form to receive the discount
4. You can then choose the promotion type (One Time or Recurring), Discount Method (Percentage or Money Value) and Value (amount of the discount - number only)
5. Next you need to select what products/addons/domain TLDs the promotion applies to and what billing cycles/registration periods are required for it to be applied - these should match those of your products.
6. The start and expiration date fields are optional - if filled out, the coupon will only start working after the set date and will stop working at the end of the day chosen. You can use one option or both to achieve the desired effect.
7. The final 4 checkboxes allow you to specify who can use the promotion:
   • Apply Once - If the client orders multiple qualifying products the discount is only applied once.
   • New Signups - Only new clients can use the promotion.
   • Apply Once / Client - If a client has an existing active order using this promotion they will not be able to use the code a second time.
   • Existing Client - Only existing clients with 1 or more active orders can use the promotion.
   • Enable for product upgrades – Refer to separate section below.
8. In the admin notes section add information pertinent to the promotion.

Limiting Usage

With WHMCS, you can set the maximum number of times a promotion can be used. You do this as follows:

1. Go to Setup > Promotions
2. Locate the promotion you want to limit the usage of and click the edit icon next to it
3. In the Maximum Uses field, enter the number of uses that you want to allow (the number of times that the promotion has already been used will be shown below the field)
4. For unlimited uses, enter the value zero
5. Once complete, simply click the Save Changes button

Prerequisites

By selecting products from the "Requires" menu it is possible to stipulate which products/services the client must also have in their shopping cart before the discount will be applied. This can be used to offer "buy x get y half price" style promotions.

The "Also allow existing products in account to qualify for promotion" option means that the products the client already owns will be included in the promotion criteria.

For example if the client already owns product x they would be able to use the promo code when ordering product y. With this option disabled the client would need to order both products x and y at the same time to qualify.

Promotion Links

You can give links out to users that will automatically apply a certain promotion code to their order if it applies. To do that, simply use a link like the one below:

cart.php?promocode=TEST OR cart.php?a=add&pid=1&promocode=TEST

Both of the above will apply the promotion code "TEST" to the order. With the first link, the user can choose the package they want and with the second they are taken straight to step 2 of the order process with product id 1 selected.
More ways to link to WHMCS are detailed at Linking to WHMCS.

Management

It is possible when creating a promotion to specify an expiry date, but if you want the promo code to become invalid before this date is reached click the Expire Now link on the Setup > Promotions page.

A copy of any promotion can be created by clicking the Duplicate Promotion link. Particularly useful for quickly running a successful promotion again or providing a personalised promo code to a client.