Getting Started

Building Blocks

Custom Fields

Subscription Features

Localization

Invoices

Credits

Order Management

Billing Features

Taxes

Payment Methods

Direct Debit Payments

Configuring Gateways

Revenue Recovery

Hosted Pages

Notifications

Reports and Analytics

Data Privacy & Security

Fraud Management

Migration

Open Source Resources

Other Features

API Integration

Third Party Integrations

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 incase 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 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 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 > 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.
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 an 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 ACTIVE state can be paused.

Via UI

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

  • Navigate to the subscription details page.

  • Click the Pause Subscription button on the action pane on the right.
    The defaults defined in Chargebee settings will be preloaded and the necessary options can be overridden, if allowed.

  • 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 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 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 you customer is losing 2 months of service period.

Subscription Changes/Cancellation

  • Change subscription will not be allowed when the subscription is paused (however, once the subscription resumes, you can make changes)
  • Scheduled subscription changes will be removed when the subscription is paused or scheduled to be paused.
  • Advance invoices cannot be raised on a subscription that's on pause. If there are any advanced invoices raised on a subscription that's paused later, credits will be created for the invoice.
  • Next billing date 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 can be changed to a date that falls within the date of resumption.
  • Scheduled subscription cancellation will take place even if the subscription is on pause or scheduled for a pause.
  • A paused subscription can be canceled if required.
  • 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, 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. For a scheduled resumption, the resumption date can be updated even when the subscription is on pause.

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

Via UI

You can resume a paused subscription immediately or on a specific date.
You can choose to invoice the charges immediately or add to unbilled charges.

"

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 Portal v2 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, 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, subscription term will align with the billing date and charges will be raised accordingly.
  • If Calendar billing is not enabled, the renewal date will be set as resumption date. For instance, 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…