Getting Started

Building Blocks

Subscription Features

Custom Fields




Order Management

Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Revenue Recovery


Self-Serve Portal


Reports and Analytics

Data Privacy & Security

Fraud Management


Other Features


Third Party Integrations


Promotions and incentives play a key factor in driving customers toward a product and in boosting sales. And one way of doing this is by using coupons.

Chargebee gives you the flexibility and ease of providing buyers with discounts, promotions and special offers with coupons.

These coupons can be used any time and the discounts will be applied to the next invoice.

You can set up two types of coupons in your Chargebee site:

  1. Fixed Amount Coupons

  2. Percentage Coupons

Read further to know more about the nature of discounts provided by these coupons.

Fixed Amount 

This discount type will deduct the specified amount from either the total amount on the invoice, sum of the specified items (selected plans and/or addons), each specified item or from each unit of the specified items (selected plan and/or addon quantity).

Fixed Amount coupons can be applied only once in a billing cycle. However, if there is a surplus in the discount after applying the coupon once, the surplus discount will be applied again when there is a change in subscription within the same billing cycle.
Say, you gave the customer a $50 worth fixed amount coupon, but the total invoice amount is $10. The discount will be applied and the invoice amount will be $0. At the same time, if the customer updates the subscription to a new plan that costs $100, the balance of the $50 fixed amount coupon, $40, will be applied to the new charge and customer will pay only $60. To sum in up:

Invoice Invoice Amount Discount Applied Final Amount
Invoice #1 $10 $10(the coupon is left with a balance of $40) $0
Invoice #2 $100 $40 $60

Let's take a look at how the "Fixed Amount" discount type works with the different "Apply On" options.

Fixed Amount with Invoice Amount

When a "Fixed Amount" coupon is created to be applied on "Invoice Amount", the discount amount specified will be applied to the total amount on the invoice. This discount will be applied regardless of what the line items on the invoice are (plans with/without setup fee, addons, quantity).

For Example:

The coupon applied (Early Bird - Discount $10) in the example above is a deduction made on the total amount ($314) of the invoice.

Fixed Amount with Each Specified Item

You can specify which item(s) (plans and/or addons) the discount should be applied to. When a "Fixed Amount" coupon is created to be applied on "Each Specified Item" the discount amount specified will be applied individually to each item(plans and/or addon) specified. For plans or addons that are quantity based, the discount is applied on the item total and NOT on each unit. The discount will also NOT be applied to the setup fee of a plan, if any.

In the following example, a "Fixed Amount" coupon (Growth Discount) of value $30 has been setup. This coupon is set to be applicable only on the Plans & Addons as shown below:

In this invoice, a total discount of $90 has been applied. This is because a $30 discount has been applied on the "Plan - Grow", "Concierge Support - Add-on" and the "Custom Reports - Addon" line items. No discount is applied on the other line items as shown:


This discount type will deduct the specified percentage amount instead of just an amount from the invoice. "Percentage" type coupons can however only be applied to the total of the invoice amount or to each of the specified plan(s) and/or addon(s).

Percentage with Invoice Amount

When a coupon is created as a "Percentage" coupon to be applied on the "Invoice Amount", the discount will be applied to the total amount on the invoice. This discount will be applied regardless of what the line items on the invoice are (plans with/without setup fee, addons, quantity).


A 50% coupon applied to an invoice that has a total of $200 will give a total discount of $100. This invoice may contain a plan with a setup fee and multiple addons and consist of various quantities.

Percentage with Each Specified Item

When a "Percentage" coupon is created to be applied on "Each Specified Item" the discount percentage specified will be applied to each item (plans and/or addon)specified. The discount will also NOT be applied to the setup fee of a plan, if any.

Coupons Cheat Sheet 

  1. "Fixed Amount" and "Percentage" coupons applicable to "Each Specified Item" will not be applied to the setup fee of a plan if the plan has a setup fee configured.
  2. Discount will be applied before applying the taxes, if any.

When a coupon's discount amount is more than the plan price 

Imagine you give a buyer a $50 coupon, and they make a purchase for $20 and apply the coupon, the total becomes -$30.

If this is the case, Chargebee will just deduct the total value of the purchase from the coupon and the total price becomes $0.


Plan Price: $10

Addon Price: $5

Fixed Amount Coupon Value: $20

Apply On: Invoice Amount

Total Invoice Amount: $15

Discount Value will be $15

If the coupon value is greater than the total price of the subscription, it will not become a negative total; instead it will be $0.

Do coupons have a recurring option? 

The Duration Type deals with the recurring functionality of coupons. This specifies how long a coupon can be applied to a subscription after being added.

There are 3 types of durations:

One Time coupons can only be used once in a subscription and cannot be used again after being redeemed. Once the discount is applied on the initial charge, the coupon will no longer be applicable.

Forever coupons do not have an expiration time set, and the discount will be applied as long as the subscription is active.

Limited Period coupons will have a fixed time duration. Once this time is over, the coupon can no longer be applied to the subscription.


If the coupon is set for 3 months, then the discount will be applied only for the next 3 months. After that, normal plan charges will incur.

Applying multiple coupons to a subscription 

Multiple coupons can be applied to an existing subscription as long as the coupons are not of the same discount type. If you apply a coupon with the same discount type, then the previous coupon will be overwritten.


Say you have already applied 2 coupons as shown below:

Discount Type: Percentage (10%)

Discount Type: Fixed Amount ($10)

Here you cannot add another percentage type discount coupon, but you can overwrite the existing coupon and replace it with the new percentage coupon.

So if we apply another percentage coupon, say 15%, it replaces the 10% coupon that has already been redeemed.

Discount Type: Percentage (15%)

Discount Type: Fixed Amount ($10)

The screenshots below show you what happens when you apply the same discount type twice as explained in the example above.

Before applying the same discount type coupon:

After applying the same discount type coupon:


Multiple coupons cannot be added during subscription creation and is only supported for existing subscriptions.

How do I setup my coupons? 

Coupon setup and integration can be done easily by entering the name, discount value, duration, validity and constraints.

You start by going to Product CatalogCoupons+ Create Coupon on the web interface.

Naming your coupon in a detailed way is quite useful during sign up. You should be able to easily understand what the offer is all about without checking the coupon details in the web interface.

The coupon display name also includes the discount details on the subscription page.

Coupon Id is used by Chargebee's API to identify the coupons on your website. The Id is a unique identifier of the coupon and when a subscription is created or updated via the API from your app/website, the Id should be used to refer to the coupon.

Specify an invoice name or the application will use the default. This name appears on the invoice sent to customers and appears on the HTML generated view of the invoice.

Setting the coupon expiration date 

Yes. You can specify how long the coupon will be valid and how many times it can be redeemed.

Select the expiration date in the Valid Till field. Once this date passes, the coupon becomes invalid.


During the festive season, you could offer coupons with limited period saying they would be valid until December 25th.

Redemption limit on coupons 

Set the number of times a coupon can be redeemed using the Maximum Redemptions field. If a coupon has maxed out the number of redemptions, it becomes void and can no longer be used for new sign ups.


You can apply an Early Bird coupon and set the redemption limit to 20.

  • If a coupon has been added to a subscription, the redemption value reduces by 1 regardless of whether the coupon has been applied to the invoice for the subscription or not.
  • You can reset the redemption value whenever needed while editing a coupon.

Editing coupons 

Once a coupon has been created and redeemed, only the Name, Code, Invoice Name, Valid Till and Max Redemptions can be edited. If a coupon has not been used yet, then all the fields can be edited.
To edit a coupon, click on the coupon name, and click on the Edit Coupon button on the right side. Once you have specified the maximum redemption value, it will be applied to the coupon.

Deleting coupons 

Coupons can be deleted or archived. This depends on whether the coupon has been redeemed or not.

To delete or archive a coupon, click on the coupon and then click on "Delete Coupon" button on the right side.

When you delete a coupon that has no redemptions, the coupon will be completely removed from the system and it will not appear on the list of coupons either. You can reuse a coupon name to create a new coupon if needed.

  • Reusing a coupon name is only possible if the original coupon has never been redeemed, renamed or completely deleted. If a coupon has been "Archived", the same coupon name cannot be re-used.

  • You can delete/archive multiple coupons in Chargebee in one-shot. To do this, go to Product Catalog > Coupons, select the coupons to be deleted and click the Delete button that appears above the list.

Cloning coupons 

Cloning a coupon involves replicating an existing coupon to make changes to it. You can also use this option to increase the discount amount for new subscriptions while keeping your existing subscriptions on the old discount amount. Alternatively, if you want existing subscriptions to be charged onto the new price, you can use the ‘Change Subscription' option.

You can make the following changes using the Clone Plan option:

  • Extend or limit the duration of the coupon and the discount amount.
  • Associate new plans or addons with the coupon.
  • Change the validity period of the coupon.

Cloning a coupon consists of the same steps involved in cloning a plan.


Ensure that the old coupon is archived after cloning so it does not appear in the customer portal.

Archiving coupons 

When you delete a coupon that has been redeemed, it becomes archived. This means that it is not completely removed but will be in archive mode and will appear on the list of coupons. Archiving will also prevent future usage of the coupon but existing users will not be affected.

The same rules of deleting/archiving applies to coupon codes as well.


1. Can I add Coupons to the Subscriptions on Customer's request? 

Yes, you can add coupons to the subscription in your Chargebee on customer's request.

There are 3 scenarios where you can add the coupon:

  • While creating a Subscription

    If you are adding a coupon/coupon code on behalf of your Customer while creating a new Subscription for them, navigate to Subscription Details in the ‘Create Subscription' page, and you will find the option to add Coupon/Coupon Code.

  • During Subscription change

    If you're applying the coupon on your Customer's behalf during a Subscription change, you will find the option in the Change Subscription page.

  • Add the Coupon/Coupon Code to the Subscription

    If you're adding the coupon/coupon code for the customer, at any point of time in the billing cycle, navigate to the respective Subscription, find the Apply Coupon/Coupon Code tab to add the Coupon/Coupon Code.

2. Can coupons be added while creating a Quote? 

Yes, learn more about quotes here.

Was this article helpful?