Docs
Having the flexibility to select a Billing date is just as important as billing itself. With Chargebee's Calendar Billing feature, you can set the billing date for your customers, regardless of the date they sign-up.
If you are in SaaS business, you may want to bill a customer on a specific date, based on a request. Or if you are in eCommerce business, you may want to bill your customer based on when you can ship your product. Regardless of the kind of business you are in, the Calendar Billing feature is designed to accommodate your billing configuration.
Calendar billing can be implemented for subscriptions with weekly, monthly and yearly billing periods. It is also applicable for sign up, renewals, activation post trial, future start, and reactivation.
Billing date is set differently based on the period of subscription. For a weekly subscription, it can be set as any day of the week, from Monday to Sunday.
For monthly subscriptions, billing date can be a particular date, from 1st to 31st of the month. Subscriptions with a term greater than a month (quarterly/annual) will use the monthly billing date.
The different approaches for setting a billing date are:
After setting the billing date, you can decide the billing cycle from when the billing date is implemented. There are two options to go with:
1. Immediate Alignment: The subscription billing date will be changed immediately to the new date and charges/credits are raised accordingly.
Example:
A customer has a billing date set as the 15th of every month. They signed up for the plan on February 5.
| Billing Date | 15th of every month |
| Subscription charge | $100/month |
Here is how the subscription term is aligned to the billing date.
| First Billing Period | Feb 5 - Feb 15 |
| First Invoice Amount | ~$33 (prorated for 10 days) |
| Next Renewal date | Feb 15 |
Customer's first billing cycle will fall between February 5 and February 15 and the first renewal date will be February 15.
The Calendar Billing settings alignment will apply to subscriptions that are created with a Start Date prior to the creation date.
2. Delayed Alignment: The subscriptions will be aligned to the new billing date on first renewal i.e., the customer's subscription will go through one full billing cycle before it is aligned with the billing date.
Example:
A customer has a billing date set as the 15th of every month. They sign up for the subscription on February 5.
| Billing Date | 15th of every month |
| Subscription charge | $100/month |
The first billing cycle of the subscription will be 1 month i.e., from February 5 to March 5. The subsequent billing cycle will fall between March 5 and March 15, which will be treated as the first renewal period. From the second renewal on, from March 15, the subscription will continue with the normal billing cycle.
| First Billing Cycle | Feb 5 - Mar 5 |
| First Invoice Amount (1 month) | $100 |
| First Renewal date | Mar 5 |
| First Renewal Amount | ~$33 (March 5 to March 15) |
Adjusted Term
Whenever a subscription is aligned to a specific billing date, the subscription period is bound to be adjusted. In most cases, this term/period runs shorter than the actual subscription period.
Adjusted Term, even if it's shorter, will be counted as one billing term.
Example 1:
Say, a customer signs up on February 5, for a subscription that renews on the 15th of every month. The Adjusted term here will be 10 days and will be counted as one billing cycle of the whole subscription.
Example 2:
Consider two quarterly plans, Plan A and Plan B that charges $500/quarter.
A customer, who's billing date is the 15th of every month, subscribes to Plan A on Mar 5 and Plan B on April 1.
| Plan A | Plan B | |
| Initial Subscription Period | March 5 - May 15 | April 1 - June 15 |
| Subscription charge (Prorated) | ~$390.11 | ~$417.58 |
Even when the subscriptions have the same billing period and the billing date, since they are not aligned by the month, a separate invoice will be generated for both the subscriptions.
Charging a customer for the adjusted term can be done in two ways:
For e-commerce, customers are expected to pay in advance for the products as the merchant will have to prepare for the delivery. For this reason, the merchant can set up a cut-off date for signing up for the service. Customers who pay on or before the set cut-off date are eligible for the delivery of the product on the current subscription cycle; else the delivery will be shifted by a month/week, depending on the tenure of the subscription.
Alternatively, based on the sign up date of a customer, you could have a specific billing date set for them.
There are three rules to keep in mind when it comes to the first-time delivery of a subscription based e-commerce product:
Example:
Say, you set up a date range, that is 1st to 8th of every month, and the billing date is the 9th.
For customers who sign up within the date range, the billing date is the 9th and they receive the product on the 8th of the upcoming month.
| Sign up | Billing Date | Renewal Shift |
| Between 1st & 8th | 9th of every month | Shift first renewal |
| Between 9th & 31st | 9th of every month | No shift |
If a customer signs up on February 5, they will be billed immediately (and not on February 9) and will receive the shipment on March 8. They will be billed for the subsequent shipment on March 9.
The following are some additional scenarios you are likely to come across:
| If customer signs up on | Billing Date | First Renewal |
| Feb 5 | 9th of every month | Mar 9 |
| Feb 15 | 9th of every month | Mar 9 |
| Mar 1 | 9th of every month | Apr 9 |
There are two approaches for billing a SaaS customer.
1. Common Billing Date: You can have a common billing date for all your customers and align the renewal of the subscription with the billing date set by you. To know more on billing date alignment read Alignment of Billing date.
2. Customer Specific Billing Dates: You have two options for making the billing date customer specific:
When a billing date is not chosen, each subscription will have its own billing date, which is based on the activation date of each corresponding subscription.
Example:
Say, a customer signs up on January 15 for a subscription (Plan A $200) and signs up for another subscription on February 5 (Plan B $100). When there is no billing date defined for the customer, each subscription will renew every month on the sign-up date.
| Billing date for subscription 1 | 15th of every month |
| Subscription charge | $200 / month |
| Billing date for subscription 2 | 5th of every month |
| Subscription charge | $100 / month |
You can choose to have billing dates only for specific customers while allowing the remaining to be billed as the per subscription activation date.
Example:
Say, a customer has a specific billing date as 15th of every month. When they sign up for a subscription on February 5, the initial subscription period is set from February 5 to February 15 and a corresponding prorated charge is raised.
| Sign up date | February 5 |
| Sign up charge | $33 (prorated) |
| Next Renewal date | Feb 15 |
| Subsequent renewal charge | $100 |
You can choose to have the billing dates as per the first subscription activation for most of your customers while choosing to have a specific billing date for a few.
Example:
Say, a customer signs up on January 15 for a subscription (Plan A $200) and subsequent subscriptions are set to be aligned with the first subscription.
When the customer signs up for another subscription on February 5 (Plan B $100), the initial subscription period is set from February 5 to February 15 and a corresponding prorated charge is raised.
Signing up for a quarterly/annual plan
Example:
Say, a customer has a billing date set as the 15th of every month and they sign up on March 5 for a subscription of a plan which renews every quarter (Plan A $500).
| Billing Date | 15th of every month(Defined by the customer) |
| Subscription charge | $500/Quarter |
The initial term of the subscription will be set as 3 months less the prorated period not consumed in the month of activation (~20 days). The initial period for the quarterly subscription will be set as March 5 to May 15, for which a corresponding prorated charge is raised.
| Sign up date | Mar 5 |
| Sign up charge | $390.11 (prorated) |
| First renewal charge (on 15th May) | $500 |
Delayed Alignment is useful when you want to let your customer use the subscription service for one full billing cycle before aligning to the billing date. The sign up date and the billing date will be aligned on the first renewal. This will help set the customer's expectation on how much they will be charged for a full subscription right at the beginning of the subscription.
Customer will be charged in full for the first billing cycle of the subscription without any proration. The prorated charge will appear on the first renewal.
This will be particularly useful when customers are signing up for a subscription - they will be able to see the actual subscription value (listed in the plan), instead of a prorated amount. It might be difficult to manage communication if a prorated charge is raised in such cases
Example:
Say, a customer has a specific billing date as 15th of every month. When they sign up for a subscription on February 5, the initial subscription period is set as February 5 to March 5 (without proration) and a regular charge is raised. On March 5, i.e. the first renewal, the subscription aligns with the billing date and the next subscription period is set as March 5th to March 15th
| Billing date | 15th of every month |
| Sign up date | Feb 5 |
| Sign up charge | $100 |
| First renewal period | Mar 5 to Mar 15 |
| First renewal charge | ~$33 (Prorated) |
| Subsequent renewal charge | $100 |
With a change of billing date, you can either charge the customer separately for the adjusted term or combine the adjusted term with the next renewal. When the adjusted period is too short, like a day or two or even less than a week, a customer is less likely to fancy a separate invoice for the adjusted term. So it is best to combine the adjusted period with the upcoming renewal to create a longer-than-usual subscription.
Combining the subscription will consolidate the charges.
To decide, whether or not to combine the adjusted term, you can set Threshold days.
| Adjusted Term <=Threshold days | Combine the adjusted period with the next renewal period |
| Adjusted Term > Threshold Days | Bill the charge for the adjusted period separately |
To set up Threshold Days, contact support
Example:
Say, a customer has a specific billing date as 15th of every month with Threshold Days defined as 5.
| Billing date | 15th of every month (Defined for the customer) |
| Threshold Days | 5 days |
When the customer signs up for a subscription on February 12, which is 3 days away from the billing date, the initial subscription period is set as February 12 to March 15 and a prorated charge is raised for the extended period. From March 15 onward, i.e. from the first renewal, regular billing resumes and regular charges are raised on each renewal.
| Sign up date | February 12 |
| Sign up charge | $112.9 (prorated) |
| First subscription period | Feb 12 to Mar 15 |
| Subsequent renewal charge | $100 |
This feature is exclusive for Advanced Calendar Billing. To know more check Chargebee's Plans & Pricing .
Calendar billing gives you the control to change the billing date for the customer(s) based on your requirement, regardless of the billing date of the current subscription.
This will align the current billing date to the newly set billing date.
If a customer has multiple subscriptions, you can align all the billing dates to one date.
Example:
Say, a customer, who does not have a billing date set, has 2 subscriptions renewing on different dates.
| Subscription 1 | Renewing on the 15th of every month |
| Subscription 2 | Renewing on the 1st of every month |
On April 10, a billing date is introduced for the customer - 25th of every month. There will be no immediate effect of this change in billing date.
| Date of introduction | Apr 10 |
| New Billing date | 25th of every month |
The existing subscriptions will align to the newly introduced billing date on the next renewal.
| Next renewal period for Subscription 1 | Apr 15 to Apr 25 (~$36.67) |
| Next renewal period for Subscription 2 | May 1 to May 25 (~$166.67) |
Corresponding prorated charges will be raised for each of the subscriptions.
In this scenario, the customer will continue with the current subscription but the billing date will change. If the customer has more than one subscription, the billing date of all subscriptions will align with the chosen billing date from the upcoming renewal
Example:
A customer has a billing date set for the 15th of every month. On April 10, the billing date is changed to the 25th of every month.
| Date of Change | Apr 10 |
| New Billing Date | 25th of every month |
The billing date will not affect the subscription immediately. The existing subscription(s) will align to the newly introduced billing date only on the next renewal.
| Next renewal period for Subscription (adjusted term) | Apr 15 to Apr 25 |
| Prorated charge for April 15 to April 25 | ~$36.67 |
With Calendar Billing enabled, these are the impacts of change in the subscription:
1. Change in Existing Subscription: When a customer opts to change from one plan to another, say Plan A to Plan B, both being subscriptions with the same duration, the billing period and upcoming renewal date will remain the same as before. A prorated credit will be generated for Plan A and a prorated charge will be generated for Plan B for the period that falls between the date of change, until the upcoming billing date.
Example:
Customer has subscribed to Plan A ($100/month) with the billing date falling on the 15th of every month (set for the customer). Customer has decided to upgrade to Plan B ($200/month) from April 5 onward. Since the 15th is the customer set billing date, Plan B will align to 15th and will renew on the 15th of every month.
| Charge on change (Plan B) | ~$73.33 (Prorated) |
| Credit on change (Plan A) | ~$36.67 (Prorated) |
| Net charge on 5th April | ~$36.67 |
| Subsequent renewal charge | $200 |
No prorated charge or credit will be generated if the change in subscription is only bound to happen from the upcoming renewal onward.
2. Change in Subscription (with term change): A customer can change a monthly subscription to quarterly or yearly and even vice versa. Since the billing date is the same, a prorated charge will be generated for the rest of the subscription period in the new plan.
Example:
A customer has a billing date of 15th and has a subscription (Plan A) renewing on the 15th of every month. On April 5, the customer shifts to a plan which renews every quarter(Plan B - $500).
Since there is a change in the subscription term, a term realignment takes effect immediately. The initial term of the subscription (with plan B) will be set as 3 months less the prorated period consumed in the month of change (~21 days). The initial period for the quarterly subscription will be set as April 5 to June 15.
| Billing Date | 15th of every month |
| Change | Move from plan A ($100 monthly) to plan B ($500 quarterly) |
Following are the charges/credits raised during the transition:
| Date of change | April 5 |
| Charge on change (Plan B) | ~$391(Prorated) |
| Credit on change (Plan A) | ~$36.67 (Prorated) |
| First renewal period | Apr 5 to June 15 |
| Net charge on renewal | ~$354.33 |
| Subsequent renewal charge | $500 (June 15) |
3. Change in Next Billing Date (of the subscription): Even if there is no change in the existing plan, the customer can still have their billing date changed from the upcoming renewal onward.
There are two contexts to be taken into account:
With Calendar Billing enabled, here is how the cancellation and reactivation of a subscription is dealt with.
The billing date of a reactivated service is aligned based on the date of reactivation. The following are the scenarios to consider:
1. In-term Reactivation: This is when the customer reactivates their service before the renewal. In this case, there will not be an interruption in the service and an invoice will be generated as usual. No charge will be raised for the interim. Check out In-term Reactivation's page to know more.
Example:
A customer has a billing date of 15th and has a subscription (Plan A) renewing on the 15th of every month. On March 25, the subscription was cancelled and was later reactivated on Apr 5.
| Billing date | 15th of every month |
| Date of cancellation | Mar 25 |
| Date of reactivation | Apr 5 |
Since the reactivation happens within the subscription period (Mar 15 to Apr 15), there will be no charges raised on reactivation.
| Charge on reactivation | Nil |
| Next renewal date | Apr 15 |
| Subsequent renewal charge | $100 |
2. Out of Term Reactivation: This is when the customer reactivates the subscription after the renewal date, i.e., the customer renewed at a period they have not yet paid for. They will have to pay for the adjusted term that falls between their reactivation date and the upcoming renewal. A prorated invoice will be generated.
Example:
A customer has a billing date of 15th and has a subscription (Plan A) renewing on the 15th of every month. On March 25, the subscription was cancelled and was later reactivated on April 20.
| Billing date | 15th of every month |
| Date of cancellation | Mar 25 |
| Date of reactivation | Apr 20 |
On reactivation, the subscription will align with the existing billing date of the customer (15th of every month). A prorated charge will be raised for the period from April 20 to May 15.
| Current renewal date | Apr 15 |
| Current renewal charge | Nil |
| Charge on reactivation | ~$83.33 (Prorated) |
| Term | Apr 20 to May 15 |
| Subsequent renewal date | May 15 |
| Subsequent renewal charge | $100 |
Using advance invoice will set the next billing date based on the number of terms for which advance invoice is raised. In such a case, when billing date is defined, on the next billing date/renewal date, the subscription will be aligned with the billing date.
If any advance invoice has been generated before alignment, the alignment will happen only after the advance charges are exhausted.
Calendar billing is applicable with advance invoices. Advance invoice is generated based on the customer's sign up date. With advance invoicing, the subscription will align with the billing date after the period of advance invoice ends. In such cases, the charge for the adjusted term will be prorated. Such subscriptions are aligned with the billing date when the period of the advance invoice ends. The charge raised on the date the advance invoice period ends will be prorated.
There are three scenarios to be taken into account:
With Calendar billing in place, this is how coupons and discounts will work.
1. One-Time Use Coupon: Say a customer uses a one-time coupon when they are signing up and the billing cycle aligns immediately with the billing date. In this case, they're eligible for a full discount on their charge.
If the coupon value is greater than the total price of the subscription, it will not become a negative total; instead, it will be $0.
2. Recurring Fixed Amount Coupon: If the customer has a fixed amount coupon that can be used more than once (recurring), the discount given will be prorated based on the adjusted term.
3. Percentage Coupon: If the customer has a percentage coupon, which can be one-time or recurring, the discount given will be applied on the prorated charge.
If the Adjusted Term was charged in full, the customer will be given a full discount on the coupon.
How does calendar billing work with subscriptions that has a trial period?
A subscription becomes active post completion of the trial. When Billing date is available, the subscription period will align to the billing date. The alignment will happen on the date of activation and the initial period will be set as the date of activation till the upcoming billing date.
How does calendar billing work with subscriptions with 'Future Start'?
When a Future Billing Date is set, the initial charge will be created on activation. The initial charge will be calculated for the period between the date of commencement of subscription (post activation) till the Billing date.
What would be the monthly billing date of customers whose billing date falls on the 31st of the month?
For ‘End of the Month' cases, if a selected date is not present in a month (say, the 31st) for billing, then the preceding date is selected. The renewal shifts back to the original date in the subsequent month, if available.
Example:
The customer has signed up for a subscription that renews on the 31st of every month.
The renewal of the subscription will fall on Jan 31, February 28, March 31 and so on, i.e., the subscription will renew on the last day of the month.
Articles & FAQ