Docs
You are viewing:
Product Catalog 2.0
Your customers may want to pause their subscription temporarily instead of canceling it entirely, for reasons such as:
You can also pause a subscription if there are issues with receiving payments from your customer. Until the payment issues are resolved, you can keep the subscription on hold.
Subscriptions placed on pause are not counted as churn, so your reports remain accurate and reflect the correct numbers. These subscriptions are identified by a distinct status—Paused. This helps you track paused subscriptions in Chargebee and communicate more effectively with third-party systems. For example, an order tracking system can determine whether to ship goods based on the subscription's paused status.
You can pause a subscription from your Chargebee site or via API. Customers can also pause their subscription using the Customer Self-Serve Portal.
Subscriptions can be paused for a defined period if the resume date/time is known, or paused indefinitely. Chargebee does not automatically provide credits for the unused billing period, but you can choose to manually provide credits to your customers if needed.
You can enable the Pause Subscription feature in your Chargebee site at Settings > Configure Chargebee > Billing LogIQ > Customers & Subscriptions > Pause Subscription > Enable.
Configure the default settings for how subscriptions, invoices, and charges are handled when you pause or resume a subscription:
Choose defaults for Pause:
Action | Select a default |
---|---|
When Pause Subscription is invoked | You can choose to default to Pause immediately or Pause on Next renewal. |
For how long should the subscription be paused | You can choose to default to Pause indefinitely or pause till a specific date/time. |
If there are unbilled charges | Either retain the existing charges as Unbilled charges or invoice them |
If there are invoices in Dunning | Either Stop Dunning or continue Dunning |
Choose defaults for Resume:
Action | Select a default |
---|---|
When Resume Subscription is invoked | You can choose to default to Resume immediately or Resume on Next renewal. |
If there are charges | You can choose what happens to the charges raised for a subscription that is resumed after the current billing period. |
If there are unpaid invoices from previous terms | You can choose what happens to the unpaid invoices from the previous terms of the subscription. On resumption, all the current term invoices will be collected. |
Note:
You can allow overriding the default settings via the Chargebee site and/or API when a subscription is paused or resumed. When overriding is locked, users cannot change the settings.
Only subscriptions in the Active state can be paused.
Once Pause Subscription has been enabled for your site, to pause an active subscription:
You can pause the subscription using the Pause Subscription API.
If enabled, your customers can pause and resume their subscriptions using the Self-Serve Portal:
If you use the Hosted Pages Portal for your customers, and if the settings allow, your customers can pause or resume subscriptions from the portal.
Customers can choose to pause the subscription immediately or at the end of the current billing term. They can also choose to resume a paused subscription manually or on a specific date.
You can handle unbilled charges while pausing a subscription as follows:
When the subscription is paused, you can choose to continue dunning or stop dunning for related invoices.
If a discount is applied to a subscription and the subscription is paused, the coupon duration is not extended. The coupon may expire even if the subscription is paused.
A subscription in a paused state can be resumed at any time.
If your customer requests to resume, payment issues are resolved, or for any other reason the product or service should be delivered again, you can resume the subscription in Chargebee.
If a resume date/time is defined at the time of pause, the date will be preloaded and you can modify it. If a resume date/time was not specified, the subscription will be paused indefinitely. You can choose a new resume date/time or resume immediately.
You can resume a paused subscription immediately or on a specific date/time.
You can resume a paused subscription using the Resume Subscription API.
When a subscription resumes, it can resume within the billing term or outside of it. The two scenarios are:
If enabled for your Chargebee site, your customers can resume their subscription from the portal—either immediately or by scheduling resumption on a specific date.
This occurs when a subscription is paused and resumed within the same billing term. For example, if the subscription renews on the 1st of every month, and it is paused on the 15th and resumed on the 25th, this is considered an in-term resumption.
When a subscription resumes in-term, new charges are not created.
When a paused subscription resumes after the renewal date/time, it is considered an out-of-term resumption. For example, if the subscription renews on the 1st of every month, and it is paused on the 15th and resumed on the 10th of the next month, this is considered an out-of-term resumption.
A new invoice will be generated on March 10 (in this example).
If you disable the Pause Subscription feature:
1. What will happen to the non-recurring charges if the subscription is resumed before the end of the billing term?
If the subscription resumes before the end of the billing term, non-recurring charges will not be invoiced right away. Said charges will be added to the invoice of the subscription renewal.
Was this article helpful?