A subscription goes into canceled state due to multiple reasons, such as non-payment. To re-start the billing for a canceled subscription, you need to reactivate your subscription.
A subscription can be manually reactivated in Chargebee's web interface by clicking the Reactivate Subscription button available on the right side panel of the particular subscription details page. You can also use the Reactivate a subscription API call to reactivate a subscription via the API.
When reactivating a subscription, whether through the web interface or via the API, you can specify a past date/time for Chargebee to consider the subscription reactivated from. This is useful in case you want to keep the original billing cycle of the subscription in place.
Let's assume you're reactivating a particular subscription on 20th Feb,
Plan Type: $20/month
Cancellation Date: 10th Feb
Sign-up Date: 1st Feb
Current Term: 1st Feb to 1st March
Reactivate From: 15th Feb
(You can specify this date when reactivating the subscription.)
New Term: 15th Feb to 15th March
Reactivate From must be specified as a date/time in the past.
The process of reactivation differs depending on when the subscription is cancelled.
When a canceled subscription is reactivated, the billing term of the reactivated subscription will start from the past date/time of your choosing. If, for some reason, you choose to withhold a past date/time, the billing term of the reactivated subscription will start immediately with a new term. An invoice will be generated for the items subscribed to in both cases.
Plan Type: $15/Monthly
Sign Up Date: 1 May 2015
Current Term: 1 May 2015 to 1June 2015
Cancellation Date: 15 May 2015
Reactivation Date: 20 August 2015
Reactivate From: Not specified (if specified, the subscription will restart from this date)
New Term: 20 August 2015 to 20 September 2015
Here the billing term is changed from the 1st of every month to the 20th.The customer will be charged $15 immediately for August 20th and the next charge will be on September 20th.
When a subscription has been canceled due to non-payment after dunning, and is reactivated within its current billing term, it is referred to as in-term reactivation.
In this case, the billing term of the subscription will not be changed and no new invoice will be generated.
Plan Type: $10/Monthly
Sign Up Date: 1 June 2015
Current Term: 1 June 2015 to 1 July 2015
Cancellation Date: 2 June 2015
Reactivation Date: 20 June 2015
Reactivated from: Not specified. If specified, Chargebee will consider this date to be the date of activation of the subscription.
Term will continue to be the same and the next billing term will be from 1 July 2015 to 1 August 2015.
The trial period can be entered while reactivating a subscription, which would make the subscription active only after the trial period ends. Hence, the billing term will also start after the trial period ends and subsequently an invoice will be generated. Even if the customer does not have a card on file, you will be able to include a trial period and reactivate the subscription. The Reactivate From date/time in this case will be considered the Start Date of the trial.
John, a customer, signs up for a 14-day trial, but due to some unforeseen reason, they were not able to try the product. They come back to you after a few weeks and request another trial, and you did not collect their card details either. In this case, simply reactivate the account and opt to extend their trial.
The No. of Billing Cycles can also be provided during reactivation. This will override the number of cycles associated with the subscription.
In addition to manual reactivation, a canceled subscription will get reactivated if change subscription operation is performed. So, switching to a different plan, addition of an addon/coupon, or any such subscription-level changes made to a canceled subscription would reactivate it. You can also use the Update a subscription API call to change and reactivate a subscription via the API.
If you are using the API to change the details of and reactivate a subscription remember to set the reactivate parameter to true.
Reactivation due to Change Subscription operation also has two different behaviors, based on when the change is made:
1. Out-of-term Subscription Change
Similar to general reactivation, when a subscription change is made for a canceled subscription, the subscription will get reactivated from the reactivation date/time you specify. If a reactivation date/time is not entered Chargebee will set a new billing term. A subsequent invoice will be raised in both cases.
2. In-term Subscription Change
When Change Subscription operation is performed on a subscription that has been canceled to due to non-payment after dunning, and the change is made within the current billing term, it is referred to as 'in-term' subscription change. If the subscription is changed to a plan that has the same term as that of the existing plan (e.g. monthly to monthly), the billing term of the subscription will not be affected and a new invoice will be generated with the same billing term.
However, if the subscription is switched to a plan that has a different term (e.g. monthly to yearly), the billing term of the subscription will change with immediate effect and the invoice will get raised instantly as well.
'Plan term' refers to the regular intervals in which the subscription gets renewed. (e.g. monthly or yearly plans).
Unpaid invoices will not be collected as part of the reactivation operation. However, if the payment method details (such as card information) have been provided as part of the change subscription operation and the option Attempt payment collection when payment method is added has been enabled (under Settings > Configure Chargebee > Billing rules), then an attempt would be made to collect the payment for the recent invoice that is unpaid.
Chargebee does not support calculating of proration for the in-term subscription change scenario. Hence, it should be calculated manually at your end and either credits or charges should be added accordingly.