# Working with Subscriptions

Subscriptions connect your customers to your products or services they opt into on a recurring payment basis. They specify what the customer has subscribed to and the frequency of their recurring charges.

Each subscription must include a [plan](https://chargebee.com/docs/billing/2.0/product-catalog/plans). Currently, a single subscription cannot have more than one plan. Optionally, it can also incorporate one or more associated [addons](https://chargebee.com/docs/billing/2.0/product-catalog/addons), [charges](https://chargebee.com/docs/billing/2.0/product-catalog/charges), [coupons](https://chargebee.com/docs/billing/2.0/product-catalog/coupons), and [discounts](https://chargebee.com/docs/billing/2.0/subscriptions/subscription-manual-discounts).

> ℹ️ Note
>
> * [Customers](https://chargebee.com/docs/billing/2.0/customers/customers) are limited to 900 subscriptions at any time. This limit includes both [active and inactive](https://chargebee.com/docs/billing/2.0/subscriptions/subscriptions#subscription-status) subscriptions.
> * On the day of your subscription's renewal, Chargebee will ensure to promptly initiate the renewal process.

## Subscription Billing Frequency

Chargebee offers two billing frequency options for subscriptions:

* **Plan-based billing (default)**: Subscriptions are billed based on the billing period defined in the plan.

* **Multi-frequency billing**: Subscriptions are billed according to the billing period of each recurring item price within the subscription, whether it's a plan or addon. Note that a single subscription can hold multiple addons, but not more than one plan. [Learn more about Multi-frequency billing](https://chargebee.com/docs/billing/2.0/subscriptions/multi-frequency-billing). 

The selection of the billing frequency option is configured at the site level.

### Plan-based billing

With plan-based billing, the billing frequency of the plan determines the subscription's billing frequency. This default method simplifies subscriptions' offers with a fixed and regular billing schedule.

#### Example

Consider the following price points:

| Name | Type | Price | Billing Period |
| --- | --- | --- | --- |
| 1-Year Plan | Plan | $1000 | 1 year |
| 2-Month Addon | Addon | $100 | 2 months |

If a subscription starts on January 1, 2024, with these price points, the billing schedule under plan-based billing would be:

| Billing Cycle # | Date | Billed Items | Invoice Amount |
| --- | --- | --- | --- |
| 1 | Jan 1, 2024 | Plan: $1000, Addon: $600\* | One invoice for $1600. |
| 2 | Jan 1, 2025 | Plan: $1000, Addon: $600\* | One invoice for $1600. |

**Calculation:**

Price of addon = $100

Billing period of addon = 2 months

Annual price of addon = ($100 × (12/2)) = $600

#### Compatibility of other items with the plan

While creating or updating a subscription, Chargebee ensures a plan is selected, along with any compatible addons or charges. Compatibility is based on matching currencies and, for plan-based billing, whether the addon's billing frequency is a divisor of the plan's billing frequency.

The following table illustrates this:

| Plan's Billing Frequency | Compatible Addon Billing Frequency | Example |
| --- | --- | --- |
| Day-based | Day-based. The addon's billing frequency must be a divisor of the plan's billing frequency. | If the plan's billing frequency is 10 days, then the billing frequency of the addons (in days) can be any of the following: 10, 5, 2, or 1. |
| Week-based | Week or day-based. The addon's billing frequency (in days) must be a divisor of the plan's billing frequency (in days). | If the billing frequency of the plan is 2 weeks, then the billing frequency of the addons can be any of the following: 2 weeks, 1 week, 14 days, 7 days, 2 days, or 1 day. |
| Month-based | Month-based. The addon's billing frequency (in months) must be a divisor of the plan's billing frequency (in months). | If the billing frequency of the plan is 6 months, then the billing frequency of the addons (in months) can be any of the following: 6, 3, 2, or 1. |
| Year-based | Year or month-based. The addon's billing frequency (in months) must be a divisor of the plan's billing frequency (in months). | If the billing frequency of the plan is 2 years, then the billing frequency of the addons can be any of the following: 2 years, 1 year, 24 months, 12 months, 8 months, 6 months, 4 months, 3 months, or 1 month. |

### Multi-frequency billing

In multi-frequency billing, the subscription is billed in accordance with the billing period of each recurring item in the subscription. Note that a single subscription can hold multiple addons, but not more than one plan.

[Learn more about Multi-frequency billing](https://chargebee.com/docs/billing/2.0/subscriptions/multi-frequency-billing). 

## Subscription Status

The subscription details page in Chargebee displays the details of the subscription along with its status. The following are various statuses of a subscription:

**Future:** Subscriptions that are yet to go into trial or active state on the specified date in the future.

**In Trial:** Active subscriptions that are in trial mode.

**Active:** Active subscriptions that are charged based on plan, addons, and billing period.

**Non Renewing:** Subscriptions that are scheduled to cancel and will no longer renew.

**Paused:** Active subscriptions that are stopped temporarily.

**Canceled:** Inactive subscriptions that will no longer renew. You can [configure](https://chargebee.com/docs/billing/2.0/subscriptions/cancellations#configure-subscription-cancellation) how charges and credits are handled upon cancellation.

## Viewing Subscriptions

To view all subscriptions in your Chargebee site, click **Subscriptions**. This page lists all your subscriptions along with a summary of each subscription.

This page provides options such as filtering views, sending emails to customers, exporting the list of subscriptions to a CSV file, and downloading [shipping labels](https://chargebee.com/docs/billing/2.0/integrations/shipping_address_and_labels).

![](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/2.0/subs-index.png)

Select one or more subscriptions to perform bulk actions such as delete, change term end, or cancel subscriptions.

![](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/leap-summary.png)

> ℹ️ Note
>
> Only Admins can perform bulk actions such as bulk delete, changing the end of term for multiple subscriptions, and bulk cancel.

The following bulk actions can be performed from the subscription details page:

**Delete:** Deletes the selected subscriptions.

**Change Term End:** Changes the end date of the subscription. When you select this option, the Change Term End dialog opens. Enter the necessary details and click **Apply Changes**. This operation moves any upcoming [ramps](https://chargebee.com/docs/billing/2.0/subscriptions/ramps) on the subscription to **draft** status. If you need to adjust subscription ramps to align with this operation, [delete](https://chargebee.com/docs/billing/2.0/subscriptions/ramps#delete-subscription-ramps) and [recreate](https://chargebee.com/docs/billing/2.0/subscriptions/ramps#create-subscription-ramps) them as needed.

**Cancel Subscription:** Cancels the selected subscriptions. Enter the required details in the Cancel Subscriptions dialog and click **Apply Changes**. To cancel subscriptions, select **More > Cancel Subscription**. Read more about [canceling subscriptions](https://chargebee.com/docs/billing/2.0/subscriptions/subscriptions#cancel-reactivate-subscription).

## Creating a Subscription

[Training Video: 8R8zwbzs1dey82lyItZbhA]

To create a new subscription in your Chargebee site, follow these steps:

1. Click **Subscriptions** > **Create New Subscription**.
2. In the **Pick a Customer** dialog, select the customer record for which you are creating this subscription. You can also create a new customer before creating this subscription.
3. The Create a Subscription page allows you to create a new subscription. The subscription ID field is auto generated and is used to uniquely identify the subscription. Fill out the details described in the upcoming steps to create a new subscription.
4. The *Subscription Info* section collects information related to the plan you would like to subscribe the customer to.

   ![](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/2.0/create-subs.1.png)
5. Click the Product Family drop down and select the product family of the plan for which you are creating this subscription.
6. Click **+ Add Plan** and select the plan. The Add Plan dialog displays all the existing plans/addons for selection. [Metered components](https://chargebee.com/docs/billing/2.0/usage-based-billing/metered_billing#defining-plans-addons-as-metered-components) can be easily differentiated using the metered icon.
7. Select the Currency and the Billing frequency of the plan, and click **Add**. You can modify this selection by clicking the more icon next to the plan to change the Plan or Frequency.
8. If [Price overriding](https://chargebee.com/docs/billing/2.0/subscriptions/price-override) is enabled in your site, you can edit the price of the plan as required.
9. Click **+Add Recurring Addon** to attach addons to the subscription.
10. Click **+Add Charge** to attach a charge to the subscription. Select [an event](https://chargebee.com/docs/billing/2.0/product-catalog/applicable-addons-charges#viewing-addons-and-charges-application) when the charge should be applied.
11. Click **+Add coupon** or **+Add coupon code** to apply coupon.
    As you add the subscription information, a sneak-peek of the immediate charges for the subscription gets displayed for your reference on the right side. You can click See breakdown to view the complete breakdown of immediate charges.
    ![](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/2.0/create-subs.2.png)
12. The **Billing Info section** captures information related to the billing of the subscription.
    ![](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/2.0/create-subs.3.png)
13. Start Date is when the subscription starts for the customer. It is a date or time depending on the proration mode of your site. Start date/time given has an impact on the statuses the subscription can have:
    * **Active**: The customer is using the subscription and is paying for it. An invoice will be generated on the date/time the subscription status changes to Active. You can also set the start date/time as a date/time in the past, i.e., the date/time can be any time before the time you're creating the subscription, provided that the date/time falls within the current billing cycle. This will come in handy when you've started providing the service already but are creating the subscription in Chargebee at a later time.
    * **Future**: The start date/time is in the future with respect to the date/time the subscription was created. The status will change to Active or Trial on the start date/time mentioned. An invoice will be generated on the date/time the subscription status changes to Active.
    * **In Trial**: On the start date/time, if the subscription has a trial period specified, then the status of the subscription will be "In Trial".
14. **Billing Cycles** field is used to set the number of times a customer will be charged. Here, you can specify a different value for the no. of billing cycles than what you have already configured in the plan. The value entered in the new subscription will override the value that was already configured in the plan.
15. **Next Renewal On** field is set to Default which is based on the plan frequency or calendar billing setting. If you have enabled the setting **Enable next renewal date at subscription creation** under the [calendar billing settings](https://chargebee.com/docs/billing/2.0/subscriptions/calendar-billing-config#configuring-site-wide-billing), you can modify the default value to choose a specific date of your preferance. Chargebee Billing will use this date to determine the upcoming billing cycle.
16. **Auto-collection** option decides whether the payments for the invoices generated for the subscription are charged automatically. You can select one of the following options:
    - **Use Customer's settings**: Chargebee applies the auto-collection settings defined for the associated customer record.
    - **Auto Collection is turned ON**: Chargebee charges the customer's payment method (primary or the one assigned to the subscription) automatically when a payment for the subscription is due.
    - **Auto Collection is turned OFF**: Chargebee does not automatically charge the customer's payment method when a payment for the subscription is due.
17. **Billing override** appears when Credits Flexibility is enabled on your site. For **Refundable credits** and **Excess payments**, select **Use Site Default**, **Do not auto-apply**, or **Auto-apply up to limit**. See [Credits Flexibility](https://chargebee.com/docs/billing/2.0/invoices-credit-notes-and-quotes/credit-notes#credits-flexibility).
18. **PO Number** uniquely identifies a purchase order and is generally defined by the buyer. You can specify the PO Number for the subscription. More on that [here](https://chargebee.com/docs/billing/2.0/invoices-credit-notes-and-quotes/po-number).
19. **Assigning a Payment Method**: If a customer has multiple payment methods available, Chargebee supports assigning a payment method exclusively to a particular subscription. If assigned, the payment method will be tried for all charges against the subscription. Find out how to assign a payment method to a subscription .
20. The **Invoicing Options** section captures information related to invoicing the subscription. You can choose to generate an invoice immediately or add to unbilled charges.
    ![](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/2.0/create-subs.4.png)
21. The **Shipping address** section captures the shipping information related to the subscription, if you are dealing with shippable physical goods. You can either apply the billing address of the customer for shipping, or add the shipping address details.
22. Click **Create**.

**See Also:**
* [Plans](https://chargebee.com/docs/billing/2.0/product-catalog/plans) and [addons](https://chargebee.com/docs/billing/2.0/product-catalog/addons) for more information on defining your products/services in Chargebee together with their pricing models.
* [Bulk operations](https://chargebee.com/docs/billing/2.0/data-operations/bulk-operations) for more information on importing sizable volumes of your subscriptions into Chargebee.
* [Automatic payment collection rules](https://chargebee.com/docs/billing/2.0/subscriptions/subscriptions#automatic-payment-collection-rules)

> ℹ️ Note
>
> * To create a subscription in Chargebee, it is mandatory to have both a [plan](https://chargebee.com/docs/billing/2.0/product-catalog/plans#creating-a-plan) and a [customer](https://chargebee.com/docs/billing/2.0/customers/customers#creating-a-new-customer) already created.
> * Subscriptions created for plans without trial days would need credit card details to process the charge immediately.
> * Configuring Auto Collection at the Subscription level overrides the Auto Collection setting you have configured at the Customer level.
> * Non-recurring addons cannot be added to a plan that has trial days.

### Free Period

While creating a subscription record, you can enable the **Free period** setting to offer a fixed number of days, weeks, months, or years for the first billing cycle of the subscription, free of charge. See [Free Period](https://chargebee.com/docs/billing/2.0/subscriptions/free-period) for how it differs from trial periods, API attributes, billing behavior, editing rules, and limitations.

![Free period setting on the Create a Subscription page](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/free-period.png)
### Creating Subscriptions for Plans Without Trial Period

If your plan does not have a trial period, you can create the subscription by setting **Auto Collection** to OFF. The subscription will be created as an **Active** subscription. Once the subscription is created, you can add the card details using the **Add Credit Card** option within the subscription.

Another way of creating subscriptions using plans without a trial period is by using the plan's [payment link](https://chargebee.com/docs/billing/2.0/hosted-capabilities/checkout-integration#via-payment-link). This allows you to enter the credit card details while creating the subscription.

## Editing a Subscription

[Training Video: dr7xOz11j7NEeWNFF7E4XA]

When you open up an existing subscription record, there are several details you can view and actions you can perform. The subscription provides you with all the details like customer info, CC info, due amount, trial days remaining (if in trial). You can also see subscription info, non-recurring items, address, current term charges/credits, invoices and transactions.

> ℹ️ Note
>
> * The address section will only appear if you add the buyer's address.
> * Charges appear when any ad-hoc charge has been applied using **Create Quick Charge**.

![](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/2.0/editing-subscriptions.png)

You can perform the following operations from the subscription details page:

* Edit Subscription
* Change Customer Details
* Pause/Resume Subscription
* Cancel/Re-Activate Subscription
* Create and send a Quote
* Add Coupon
* Add Manual Discount
* Add One-time Charges and Quick Charges
* Add Charge
* Add Usage
* Create Quick Charge 
* Request Payment Method
* Bill and Invoice for Future Renewals
* Edit Next Billing Date
* Add/Update Credit Card
* Add Billing/Shipping Address
* Add subscription invoice note 
* Delete Subscription

The subscription details page also displays the following sections:

* Applicable Charges - This section displays the items that your customers have subscribed to, the quantity, and the amount payable. Usage details are displayed for metered components with which you can view, add, or delete usage data for the subscription.
* Billing Address - This section displays the billing address added for the customer.
* Shipping Address - This section displays the shipping address added for the subscription. You can add a new shipping address, or edit/delete the existing address. <a id="json-metadata"></a> 
* Configurations - This section displays Auto Collection, JSON Metadata, and **Billing override** (refundable credits and excess payments) for the subscription. You can change the auto collection settings, add metadata, or update [Credits Flexibility](https://chargebee.com/docs/billing/2.0/invoices-credit-notes-and-quotes/credit-notes#credits-flexibility) for this subscription.
* Payment Methods - This section displays the customer's payment method that is added for the subscription. You can click the more icon to modify the same.
* Invoice Note - This section displays any subscription invoice note to be displayed on the Invoice of this subscription. You can click to add a note or edit any existing note anytime.
* Unbilled Charges - This section displays unbilled charges, if any, for the subscription.
* History  - This section contains the details of the Quotes, invoices, Credit Notes, Email Logs, Transactions, and Events related to the selected subscription. All payments related to the subscriptions are recorded under Invoices and Transactions. Read more on [invoices](https://chargebee.com/docs/billing/2.0/invoices-credit-notes-and-quotes/invoice-overview) and [transactions](https://chargebee.com/docs/billing/2.0/invoices-credit-notes-and-quotes/transactions).
* Activity Log - This sections displays the subscription history. Events such as sign up, cancellation and reactivation are shown here.
* Comments - Use comments to add information specific to a particular subscription or as a tag that you can use to find subscriptions using filters. The comments section appears at the bottom of the subscription and this option is available for subscriptions, invoices, transactions, plans, addons, and coupons.

### Edit Subscription

The Edit Subscription option can be accessed from one of the following places:

* Self serve Portal
* Chargebee site:
  * Under customer profile
  * In subscription details page, on the Actions pane
  * In subscriptions index page, in the Actions drop-down

It allows you to change one or more of the following aspects of the subscription such as:

* the plan subscribed to
* the price of the plan
* addons attached to the plan (Note: Mandatory addons linked with the subscription aren't automatically removed when changing plans. You must [remove them explicitly](https://chargebee.com/docs/billing/2.0/subscriptions/subscriptions#creating-subscriptions-for-plans-without-trial-period).)
* plan/addon quantities
* coupons or [coupon codes](https://chargebee.com/docs/billing/2.0/product-catalog/coupon_codes)
* [no. of plan billing cycles](https://chargebee.com/docs/billing/2.0/product-catalog/plans#configuring-product-catalog-settings)
* [PO Number](https://chargebee.com/docs/billing/2.0/invoices-credit-notes-and-quotes/po-number)
* **Billing override** for refundable credits and excess payments, when Credits Flexibility is enabled. See [Credits Flexibility](https://chargebee.com/docs/billing/2.0/invoices-credit-notes-and-quotes/credit-notes#credits-flexibility).

> ℹ️ Note
>
> In [plan-based billing](https://chargebee.com/docs/billing/2.0/subscriptions/subscriptions#subscription-billing-frequency), when editing a subscription that has [ramps](https://chargebee.com/docs/billing/2.0/subscriptions/ramps) scheduled, the ramps move to **draft** status if the billing frequency of the subscription is changed.

**Applying Changes**: In the Apply Changes section you can choose to bring the changes into effect in three timelines as follows:

* **Immediately** bringing the changes into effect also provides you the option to Apply prorated credits and charges to any charge which was generated because of the changes made to the subscription.
* **During next renewal**(at the end of term) schedules the changes for the end of term.
* **On a specific date** schedules the changes to take effect only on the set date. This makes the prorate credits and invoicing option unclickable and takes into account the proration setting and unbilled charges setting configured in your Chargebee site. This feature can be enabled only on request, contact [support](https://chargebee.com/docs/billing/2.0/kb/getting-started/how-to-contact-chargebees-support-team?utm_source=user-doc&utm_medium=content&utm_campaign=support) to get it enabled for your site.

> ℹ️ Note
>
> * Any scheduled change will be overridden if a new change is scheduled. Contact [support](https://chargebee.com/docs/billing/2.0/kb/getting-started/how-to-contact-chargebees-support-team?utm_source=user-doc&utm_medium=content&utm_campaign=support) if you'd like Chargebee to notify you about the removal of scheduled changes.
> * You can schedule changes to a subscription for any specific date up to 5 years (1830 days) from the current date.
> * APIs carrying parameters for proration and unbilled charges will not work in the case of scheduled changes.

### Add Charge

This option lets you add a one-time addon to the subscription. [Learn more](https://chargebee.com/docs/billing/2.0/product-catalog/charges#adding-a-charge-to-a-subscription).

### Remove mandatory addons

While updating a subscription record via [Chargebee Billing User Interface(UI)](https://chargebee.com/docs/billing/2.0/subscriptions/subscriptions#editing-a-subscription) or [API](https://apidocs.chargebee.com/docs/api/subscriptions/update-subscription-for-items), you can have the mandatory add-ons associated with the old plan removed automatically by enabling the setting **Remove mandatory addons from old plan during subscription plan update**.

To enable this setting on your Chargebee Billing site, follow the steps below:

1. Click **Settings** > **Configure Chargebee** > **Billing LogIQ** > **Customers & Subscriptions** > **Update Subscription**.
2. Click to enable the setting **Remove mandatory addons from old plan during subscription plan update** > **Apply**.

After the setting is enabled, mandatory add-ons associated with any old plan will be removed automatically during subscription update done via Chargebee Billing UI or API.

> ℹ️ Note
>
> Enabling this setting does not remove the mandatory addons automatically when your customers update subscriptions via [self-serve portal](https://chargebee.com/docs/billing/2.0/hosted-capabilities/hosted-portal). They need to remove the mandatory addons manually. This allows your customers to make an informed decision while modifying subscriptions.

### Create Quick Charge

This option lets you add an additional charge to the subscription. It is a one-time charge and does not recur. [Learn more](https://chargebee.com/docs/billing/2.0/product-catalog/charges#adding-quick-charges).

### Add Usage

If you have enabled [Usage Based Billing](https://chargebee.com/docs/billing/2.0/usage-based-billing/setting-up-usage-based-billing) in your Chargebee site and when the subscription contains metered components, you can use this option to add usage data to the subscription. Click Add Usage, specify the date and time for when the usage is being added and specify the usage units in Quantity field.

You can also do a [bulk import](https://chargebee.com/docs/billing/2.0/data-operations/bulk-operations) of multiple usage data for multiple subscription records using the Bulk Operations feature (for Subscriptions) in Chargebee.

### Add Coupon
This option can be used to apply and redeem additional coupons on an existing subscription. Only coupons that are applicable to the plan in this subscription will be displayed.

### Request Payment Method

This option allows you to send an email with an auto-generated link that the subscriber can use to add/update their card details.

### Edit Start Date/Time
This option appears only when the subscription is in "Future" state. You can change when the subscription should start using this option. If you need to start the subscription immediately (or on the current day, if your Chargebee site is on day-based [proration mode](https://chargebee.com/docs/billing/2.0/subscriptions/proration)), you can choose the current time/date.

If the subscription was created through the API and a trial period was specified, changing the start date will automatically remove that trial period. In this case, only the plan's trial period (if present) will be considered. Otherwise, the subscription will go into "Active" state.

The Change Next Billing Date option will appear on active subscriptions and is used to change the next renewal date/time. You can change the date/time to a later or an earlier point in time. The subscription will update on the specified date/time.

### Edit Trial End
This option will only appear on trial subscriptions. This can be used to extend the trial period if needed.

![](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/2.0/edit-trial-date.png)

### Add/Update Card

This option allows you to add a new credit card number if it is not available or update it if there is a change.

### Add Address
This option is used to enter the customer's shipping address. Once you have added this information, it will appear on the subscription as a new section. You can edit all the address fields except for the **Label** used. You can delete the address, and add a new one if needed.

### Add/Update Billing Info
If you've enabled any of the [billing address](https://chargebee.com/docs/billing/2.0/customers/customers#customer-billing-address) fields, you will see this option, and you can use this to add/edit your customers' billing address.

### Cancel/Reactivate Subscription

This option can be used to cancel or re-activate a subscription. You can cancel a subscription immediately or at the next renewal. Only subscriptions with credit card info can be reactivated once it is canceled. If **Show Decommission Option During Cancellation** is enabled, you can also select **Decommission this subscription** during cancellation. You cannot reactivate a decommissioned subscription. [Learn more](https://chargebee.com/docs/billing/2.0/subscriptions/cancellations).

### Price overriding for Subscriptions
You can override the price point of a plan while creating or editing the subscription when [price overriding](https://chargebee.com/docs/billing/2.0/subscriptions/price-override) is enabled in your Chargebee site.

To change the price for an existing subscription, follow these steps:

1. Navigate to the subscription details page and click **Edit Subscription**.
2. On the page that appears, you can change the price and, if applicable, the quantity associated with the subscription.

   ![](https://chargebee.com/docs/assets/screenshots/billing/subscriptions/2.0/price-override-create-subs.png)

If [proration](https://chargebee.com/docs/billing/2.0/subscriptions/proration) is enabled, a new invoice is generated for the subscription at the new price. Refundable credits are raised for the remaining period of the subscription at the old price and applied to the new invoice.

### Regenerating Invoice for Subscriptions
When an invoice is generated with incorrect details, such as an error in the line items, incorrect shipping and billing address etc, you can void that particular invoice and regenerate it using the **Regenerate Invoice** option.

Refer [Regenerate Invoice](https://chargebee.com/docs/billing/2.0/invoices-credit-notes-and-quotes/invoice-operations#actions-for-payment-due-not-paid-invoices) to learn more about this.

### Deleting a Subscription
If you wish to delete a Subscription in Chargebee, open the specific Subscription's details page and click the **Delete Subscription** option available on the actions panel.

This operation is irreversible - all data related to the Subscription, such as Transactions and Invoices, get deleted.

The numbers in the following reports will get modified when a Subscription is deleted:

* Payments
* New Revenue
* Signups
* Activations
* Cancellations
* Refunds

> ℹ️ Note
>
> * The option to delete a Subscription is available only for the Admin role.
> * You can also delete a Subscription using the Delete a Subscription API .

## Automatic payment collection rules

Three settings govern the automatic collection of payments for invoices using online payment methods:

* **Auto-collection**: Can be configured at the [customer](https://chargebee.com/docs/billing/2.0/customers/customers#auto-collection-status) and [subscription](https://chargebee.com/docs/billing/2.0/subscriptions/subscriptions#automatic-payment-collection-rules) level, with the latter taking precedence.
* **Payment collection when payment method is added** toggle: Can be configured by navigating to **Settings** > **Configure Chargebee** > **Billing LogIQ** > **Payments**.
* **Dunning**: Automatic  for payment failures.

The following table shows how the settings work in tandem with invoice and subscription statuses.

| Payment collection when payment method is added toggle | Auto-Collection | Invoice Status | Subscription Status | Action |
| --- | --- | --- | --- | --- |
| Disabled | On or Off | Payment Due | Any | Payment collected on next dunning retry. |
| Enabled | On or Off | Payment Due | Any | Payment is collected immediately even if the next dunning retry is only due later. |
| Enabled or Disabled | Off | Posted | Any | Payment is not collected. |
| Enabled or Disabled | On | Posted | Any | Payment is collected at the end of the payment term. |
| Enabled or Disabled | Off | NA | In trial | Payment is not collected. |
| Enabled or Disabled | On | NA | In trial | Payment is collected at the end of the trial period. |

## Subscription Entitlements

[Product Entitlements](https://chargebee.com/docs/billing/2.0/entitlements/entitlements) in Chargebee allow you to control the features accessible to customers based on the plan or addon they subscribe to. When a [feature is activated and mapped](https://chargebee.com/docs/billing/2.0/entitlements/managing-product-entitlements#adding-product-entitlement-for-a-feature) to a plan or addon, it is automatically available for all subscriptions of the plan or addon.
You can [view entitlements in subscriptions](https://chargebee.com/docs/billing/2.0/entitlements/subscription-entitlements#view-entitlements-in-subscriptions). The feature name, entitlement level, and status are displayed in the entitlement section of the subscription details page.
![](https://chargebee.com/docs/assets/screenshots/billing/subscription-entitlements/view-entitlement-subscription.png)
You can even override the entitlement level for each subscription, to add or change the entitlements to features that are not part of the associated plan or addon. [Learn more.](https://chargebee.com/docs/billing/2.0/entitlements/subscription-entitlements#edit-entitlements-in-subscriptions)
![](https://chargebee.com/docs/assets/screenshots/billing/subscription-entitlements/edit-subscriptions-entitlements.png)

## FAQs

**1) Can I add coupons to the subscriptions on the customer's request?**

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

There are three 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 Info** 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 **Edit Subscription** page.

**2) Is it possible to send a quote to a customer that they can review before signing up?**

Yes. Enable [Quotes](https://chargebee.com/docs/billing/2.0/invoices-credit-notes-and-quotes/quotes) in Chargebee to send pricing quotes or proforma invoices to your customers.

**3) Why can't I specify the time when entering details such as "subscription start date" or "change next billing date"?**

The [proration mode](https://chargebee.com/docs/billing/2.0/subscriptions/proration) of your Chargebee site determines whether prorated charges and credits are calculated in calendar days or to the millisecond. If your site uses the earlier day-based definition, you cannot make changes to billing-related times with a granularity finer than a calendar day.