Docs

Pause Subscription 

Introduction 

Your customers may want to pause their subscription temporarily instead of canceling it altogether, for the following reasons:

  • they might not want to use the service for a short span of time
  • they might not be present at the location temporarily

You can pause a subscription in case there are issues with receiving payments from your customer, so until you have resolved the payment issues, you can keep the subscription on hold.

Subscriptions placed on pause will not be accounted for in Churn, hence your reports will be accurate and will reflect the right numbers.
Such subscriptions will also be identified by a distinct status - paused. This will help in tracking these subscriptions in Chargebee and communicate better with 3rd party systems. Say, an order tracking system can identify whether to ship the goods or not for that period based on whether the subscription is paused.

You can pause the subscription from your Chargebee site or via API. Your customers can also pause the subscription via the Customer Self-serve Portal.

Subscriptions can be placed on pause for a defined period if the resume date/time is known, else can be placed on pause indefinitely. Chargebee will not provide credits for the unused billing period. However, you can choose to manually provide credits to your customers, if required.

Configure Pause & Resume Subscription 

You can enable Pause subscription in your Chargebee site at Settings > Configure Chargebee > Billing LogIQ > Customers & Subscriptions > Pause Subscription > Enable.

Configure the default settings on how to handle the subscriptions, invoices, charges when you pause or resume -

"

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 choose to allow overriding the default settings via the Chargebee site and-or via API, when a subscription is paused/resumed. When overriding is locked, users will not be able to change the settings.

Pause a Subscription 

Only subscriptions in the ACTIVE state can be paused.

Via UI 

Once Pause Subscription has been enabled for your site, to pause an active subscription:

  1. Navigate to the subscription details page and click Pause Subscription. The default settings defined gets preloaded and the necessary options can be overridden, if allowed.
  2. Choose when you want to pause the subscription:
"
  • Immediately: The subscription will be paused immediately. Prorated credits will not be given when the subscription is paused.
  • End of term: Subscription will be paused at the end of the current billing term.
  • Scheduled: The subscription can be scheduled to pause on a specific date.
    If the subscription is scheduled to be paused, it'll override other changes that were scheduled for the said subscription and will prevent further changes as well. Say, you're scheduling an upgrade and later scheduled a pause. In this case, the subscription upgrade will not take place, and will be paused instead.
  • Set Resume Date: If you know when you want to resume the subscription, you can set the date/time here, else you can resume later. If the resume date is not mentioned, subscription will be placed on pause indefinitely.

Via API 

You can pause the subscription via the Pause Subscription API .

Via Self-Serve Portal 

If the settings allow, your customers can pause and resume their subscriptions using the Self-serve Portal:

If you use Chargebee Hosted Pages Portal for your customers:

If the settings allow, then your customers can Pause or Resume subscriptions from the Hosted Pages Portal.

Your customers can choose to pause the subscription immediately or end of the current billing term.

They can also choose to resume a paused subscription manually or on a specific date.

Renewals and Charges 

  • Subscription renewals will not go through if the subscription is paused.
  • Subscription renewal reminder emails will not be sent to the customer during the pause period.
  • Unbilled charges linked to the subscription will be invoiced when the subscription is resumed post the billing term.

Billing Cycle 

  • Whenever you resume the subscription, the billing cycle will remain intact.
  • Managing the billing cycle of a paused subscription depends on the subscription period of the plan. For a monthly plan, pausing the subscription for 2 months, will not affect the billing cycle of the subscription. However, for a yearly plan, pausing the subscription for 2 months will mean that your customer is losing 2 months of service period.

Subscription Changes/Cancellation 

  • Edit subscription will not be allowed when the subscription is paused. You can make changes once the subscription resumes.
  • Scheduled subscription changes (except cancellation) will be removed when the subscription is paused or scheduled to be paused.
  • Subscription cancellation (whether immediate or scheduled) will take place even if the subscription is on pause or scheduled for a pause.
  • Advance invoices cannot be raised on a subscription that's on pause. If there are any advance invoices raised on a subscription that's paused later, credits will be created for the invoice.
  • Next billing date/time cannot be changed if the subscription is on pause. However, if the subscription is scheduled to be paused at the end of term, the next billing date/time can be changed to a date/time that falls within the date/time of resumption.
  • Record payment, write-off or void can be performed on past invoices linked to the paused subscription.

Unbilled Charges 

You can deal with unbilled charges while pausing a subscription as below:

  • Invoice now: You can choose to invoice the unbilled charges linked to the invoice right when the subscription is paused. If the subscription's Auto Collection is ON, Chargebee will try and collect the payment. If the payment fails, or Auto Collection is OFF, the invoice will be closed and marked as Unpaid.
  • Retain as Unbilled: If you choose to retain the unbilled charges, the charges will be invoiced when the subscription resumes and the charges will be added in the next invoice raised - on resumption (if out of term) or the next invoice raised post resumption or can be invoiced manually. Also the user can choose to retain resumption charges as unbilled.

Dunning 

When the subscription is paused, you can choose to continue dunning or stop dunning for related invoices.

  • If you choose to continue dunning for a paused subscription, the final action will override even if the subscription is on pause.
  • If you have enabled Consolidated invoicing and choose to stop dunning for a paused subscription, Chargebee will check if there is at least one active subscription listed in the invoice, and will not stop dunning for the said invoice. However, the said subscription will be paused.

Reporting/Analytics 

  • MRR of a paused subscription will be considered as $0 and will be accounted only on resumption.
  • Subscriptions scheduled for pause and/or resumption will be accounted in CMRR
  • Subscriptions on pause will not show up in reports as churn. You can filter the subscriptions that are paused.

Discounts/Coupons 

If a discount is applied to a subscription and the subscription is paused, the coupon duration will not be extended. The coupon may expire even if the subscription is paused.

Resume a Subscription 

A subscription in paused state can be resumed at any point in time.

If your customer has requested to resume or payment issues have been resolved, or any other reason due to which the product/service should begin to be delivered, you can resume the subscription in Chargebee.

  • Immediate: You can resume the subscription immediately.
  • Scheduled: You can schedule a subscription to be resumed on a specific date/time. For a scheduled resumption, the resumption date/time can be updated even when the subscription is on pause.

If a resume date/time is defined at the time of pause, the date will be preloaded and you can choose to modify it. If resume date/time wasn't mentioned, the subscription will be paused indefinitely. You can choose a new resume date/time or resume immediately.

Via UI 

You can resume a paused subscription immediately or on a specific date/time.

"

Via API 

You can resume a paused subscription via the Resume Subscription API .

When a subscription resumes, it can resume within the billing term or not, here's the calculation for the:

  1. In-term Resumption
  2. Out of term Resumption

Via Self-Serve Portal 

If you have Self-serve Portal enabled for your Chargebee site, your customers can resume the subscription from the portal (immediately or schedule resumption on a specific date).

In-term Resumption 

This is when a subscription is paused and resumed within the billing term of the subscription.
Say, the subscription renews on the 1st of every month. If the subscription is paused on 15th and resumed on the 25th, this is considered as an in-term resumption.

"

When a subscription resumes in-term, new charges will not be created.

  • Chargebee will try and collect the payment for the unpaid invoice of the current term on resumption (if dunning is not in progress for the invoice)
  • If the payment does not go through, Chargebee will hold the subscription on pause.

Out-of-Term Resumption 

When a paused subscription resumes after the renewal date/time, it is considered as an out-of-term resumption.
Say, the subscription renews on the 1st of every month. If the subscription is paused on the 15th and resumed on the 10th of the next month, this is considered as an out-of-term resumption.

"

A new invoice will be generated on the 10th of March (in this example).

  • If the payment goes through, the subscription will resume, else it will remain paused.
  • The collection of the invoice generated on the 1st of Feb will be scheduled as soon as the subscription resumes.
  • If Calendar billing is enabled, the subscription term will align with the billing date and charges will be raised accordingly.
  • If Calendar billing is not enabled, the renewal date/time will be set as resumption date/time. For instance, if a subscription which renews 1st of every month was resumed (from paused state) on the 10th of the next month, the subscription renewal date will now be updated to 10th.

Disable Pause Subscription 

If you disable the pause subscription feature,

  • You will no longer be able to pause subscriptions.
  • Subscriptions that are currently paused will resume as scheduled, or can be resumed manually.

FAQ 

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?
Loading…