When an active subscription moves to an inactive state and further renewals do not take place, it is said to be canceled. An active subscription can be canceled any time. There are five ways in which a subscription can be canceled:
Subscription cancelation can happen due to various reasons. If a subscription gets canceled for any of the below mentioned cases, the subscription_canceled event will notify you the reason for the cancelation.
If the subscription gets canceled due to any other reason, the subscription_canceled event will not hold the reason for cancelation.
You can configure Chargebee's default subscription cancelation settings by navigating to: Settings > Configure Chargebee > Subscription Cancelation
The below table explains the various options available for each setting.
|When a subscription has to be canceled||Cancel immediately: Cancels the subscription immediately.
Cancel at end of term: Waits till the end of the term and then cancels (changes the subscription status to non-renewing).
|When a subscription is canceled mid-term, how should the credits for the unused period be handled.||Don't issue credits: The subscription is canceled without giving any credits for the unused period.
Issue prorated credits: The subscription is canceled and prorated credits are given for the unused period.
Issue full credits: Issues full credits for the entire term.
|If there are existing refundable credits|| Retain credits: No action is taken against the credits.
Initiate refund: Initiates the refund of the credits.
|If there are existing unpaid invoices for the canceled subscription||Retain as unpaid: No action is taken against the invoice.
Attempt Collection: A charge is attempted on the available payment method if auto-collection is enabled. If the payment fails, the invoice is retained as payment due.
Write Off: The amount due is written off.
|If there are existing unbilled charges for the canceled subscription||Invoice Charges: The unbilled charges will be invoiced and a charge is attempted on the available payment method if auto-collection is enabled. If the payment fails, the invoice is marked not paid.
Delete Charges: The unbilled charges will be deleted.
|Apply refundable credits/excess payments, if any, to unpaid invoices.||This toggle allows you to apply to the unpaid invoices, any refundable credits/excess payments that are present for the customer record.|
Chargebee also allows you to override the default settings or add a condition. You can perform these actions by clicking the vertical ellepsis available next to each setting.
When the number of billing cycles increases for a subscription or when the subscription is changed to a plan that has a different term period, it will switch from non-renewing state to active state.
If the number of billing cycles for a monthly subscription, scheduled for cancelation (number of billing cycles set to 0) is set to any non-zero number, or if the plan is changed to a yearly one using the Change Subscription operation, the subscription will become active.
Customers can be offered a way to turn their subscriptions to active from non-renewing by extending their subscription.
The date of cancelation for a subscription which is scheduled to be canceled upon the next renewal can be changed via web interface (using the option Change Cancel Date available on the right side panel of the subscription details page) or using the Change term end API.
If the cancelation date is postponed, the subscription will still continue to be in the non-renewing state, until the cancelation date. An option to raise prorated charges for the extended period is also made available while performing this action.
To re-start the billing for a canceled subscription, you need to ‘reactivate' your subscription. Learn more.