Overview

Required plan

This feature or setting is available to all customers on any Recurly subscription plan.

Definition

Calendar Billing is a feature in Recurly that allows businesses to consolidate multiple invoicing charges for a customer into one unified invoice. This is especially beneficial for businesses whose customers have multiple subscriptions.

Key benefits

• Simplified invoicing: Reduce the number of invoices generated, making it easier for both businesses and customers to manage payments.
• Enhanced customer experience: Customers receive a single, consolidated invoice, leading to clearer communication and fewer queries.
• Flexible options: Choose between aggregate invoices for physical goods or aligning renewals for digital goods, depending on your business model.

Background

For businesses offering multiple subscriptions, it's often desirable to bill these subscriptions together. Depending on your business model, Recurly provides tailored solutions:

• Aggregate Invoices: This feature consolidates all subscriptions on an account with the same billing date into one invoice. It's particularly beneficial for merchants selling physical goods as it doesn't enforce proration like the Aligning Renewals feature. Learn more about Aggregate Invoices.

• Aligning Renewals: Aligning subscriptions involves prorating for those starting immediately or transitioning from a trial period to synchronize with a unified account billing date. This ensures that all subscriptions renew simultaneously on a single invoice, making it a preferred option for digital goods and services companies. Dive deeper into Aligning Renewals.

Aggregate Invoices

Aggregate Invoices is a feature that merges subscriptions with the same billing date into one invoice. It's ideal for businesses whose customers frequently have multiple subscriptions billed on the same day.

Eligible subscriptions

For subscriptions to be combined into one renewal invoice, they must:

• Share the same bill date: Precisely down to the second. Achieve this optimally by purchasing Multiple Subscriptions together.
• Use one payment method: As the invoice merges all charges, it must be paid using a single method, like a credit card.
• Have one collection method: All subscriptions in an aggregate invoice should have the same collection method (either manual or automatic). Those with different methods will be invoiced separately.
• Follow a specific billing cadence: Supported only for monthly (minimum 30 days), quarterly, or annual subscription billing cycles.
• Same Shipping Address: Subscriptions with different shipping addresses will result in separate invoices.

🚧

Note:

Subscriptions activated within 24 hours of an aggregate invoice's renewal date will be invoiced separately. If future start date subscriptions activate on the same day as an aggregate renewal invoice, they will activate simultaneously with other subscriptions to bill together. In addition, differing shipping addresses will result in separate invoices.

Editing Account Bill Date

Once Aggregate Invoice is activated, Recurly will try to combine all subscriptions with the same bill date onto one invoice. Manual overrides of your site default aren't possible within a group of aggregated subscriptions. However, you can cause separate invoices by adjusting the subscription's bill date to be different from the account's and it will be invoiced separately. Adjusting all account subscriptions to a new bill date can be done via the postpone feature in the API.

Expiring or canceled subscriptions

Subscriptions in their last billing cycle or those canceled before the bill date won't be included in the renewal invoice.

Promotional subscriptions renewing or expiring

Promotional subscriptions, like those bought with a gift card or cardless free trials, will expire if there's no payment method or enough credit/coupons to cover the total cost of all promotional subscriptions.

If promotional and non-promotional subscriptions are set to bill together and there's no payment method, subscriptions initiated with a gift card will expire, and the cardless trial subscription will enter dunning.

📘

To Enable Aggregate Invoices:

Reach out to [email protected] to check eligibility for this feature on your site. Once activated, subscriptions with the same renewal date will be combined into a single invoice.

Alignment

Alignment, like Aggregate Invoices, consolidates subscriptions into one invoice. However, it aligns a subscription's bill date if purchased or exiting a trial on a different day from the account's bill date. This results in a one-time prorated invoice, ensuring the new subscription bills with existing ones on the next bill date.

📘

To Enable Alignment:

Contact [email protected] to check eligibility for this feature on your site. Once activated, purchased subscriptions will align to a bill date or set the account bill date if it's a new account.

Bill date

Alignment introduces the concept of an account bill date, determining when subscriptions on an account bill together. If there are existing subscriptions when the feature is activated, the oldest subscription's bill date becomes the account's bill date. This means subsequent subscription purchases will align to this date. For new customers purchasing subscriptions after activation, their account bill date is set by their first non-trial invoice.

Once an account has a bill date, future subscription purchases, upgrades, or downgrades will prorate to align with the account's bill date.

The Bill Date can be viewed on the Accounts page, showing the subscription timestamp information down to the second.

Assigning a bill date

The account bill date is when an account's subscription(s) are billed. This date is determined by an account's first non-trial invoice. For instance, if a subscription starts on January 20th, the account's bill date will always be the 20th of the month. A $0 invoice is still considered a non-trial invoice. If a gift card or promotional credit covers the full cost of the non-trial invoice, this date will still be the account's bill date.

For subscriptions with a bill date on the last day of the month, if the day doesn't exist for the next bill date, the last day of the month will be used (e.g., January 31st, next bill date will be February 28th).

For subscriptions bought on the last day of the month, and the bill date on the account is the first day of the month, the invoice amount will be smaller than usual. For instance, a bill date of the 1st and a subscription bought on the 30th will result in a prorated invoice for the 30th-1st.

Editing a bill date

The Bill Date on an account is read-only and cannot be changed. However, if you wish to modify the bill date of a specific subscription or group of subscriptions, bill dates on subscriptions can be adjusted only via API and link to the API call for that if we have precedence for linking out to our API docs from within these documentation pages. Once all subscriptions share the same bill date, they will bill on the same invoice. However, once you adjust a subscription's bill date, it won't re-align to the account's Bill Date and will renew separately.

Clearing a bill date

An account will always have a permanent bill date. Neither the API nor Admin UI permits changing or clearing the account's bill date.

Aligning logic

This section discusses subscription alignment scenarios based on whether there's an established bill date on an account and/or if purchased subscriptions are in trial. When a new subscription is bought on an account with a bill date, we first identify its regular billing cycle start and end dates and then adjust its bill date to match the account's bill date.

Non-trial subscriptions

When a non-trial subscription is purchased, its bill date will either prorate to the account's bill date or, if there's no bill date, the non-trial subscription's bill date will be set as the account's bill date.

Monthly and monthly subscription example

An existing customer is subscribed to a monthly Silver subscription ($5) billing on the first of every month. The customer buys a monthly Gold subscription ($10) on March 15th.

• The account bill date is the first of the month, set by Silver's bill date.
• Gold subscription's regular billing cycle would be March 15th - April 15th.
• Gold subscription's bill date of April 15th is adjusted to April 1st to align with the account's bill date.
• A prorated invoice of $5 for Gold is created for the billing period of March 15th - April 1st.
• The next month's invoice on April 1st will include both Silver and Gold ($5+$10=$15).

Monthly and annual subscription example

An existing customer is subscribed to a monthly Silver subscription billing on the 15th of every month. The customer buys an annual subscription to the Gold plan on January 10th, 2017.

• The account bill date is set as the 15th of each month by the Silver subscription.
• Gold annual subscription's regular billing cycle would be January 10th, 2017 - January 10th, 2018.
• Gold annual subscription's bill date of January 10th, 2018 is adjusted to December 15th, 2017 to align with the account's bill date.
• The Gold annual subscription will prorate for the period of January 10th, 2017 - December 15th, 2017.
• The next invoice that will include both subscriptions will be on December 15th, 2017.

Annual and annual subscription example

An existing customer subscribed to an annual Gold subscription on January 10th, 2017 with a bill date of the 10th.

• If the customer buys a second annual subscription before February 10th, 2017, it will end up on the same invoice as the existing subscription on January 10th, 2018.
• If the customer buys a second subscription after February 10th, despite the subscription being aligned to the correct day of the month, the new annual subscription won't be on the same invoice and will renew one year after its start date.

🚧

Note:

When a customer is currently subscribed to an annual subscription and buys another annual subscription, the new subscription will only align to the existing subscription if it's bought within one month of the start date for the first annual subscription. To enable a subscription to align after the one-month window, you can use the postpone feature.

Upgrades and downgrades

Customers sometimes upgrade or downgrade their subscription plans. If an immediate subscription change includes a change of billing period, the subscription will need to be aligned since it resets to the current date. As long as this feature is active, any immediate subscription change will consider the account's bill date, ensuring the subscription maintains alignment.

Monthly upgrade to annual example

An existing customer is subscribed to monthly Bronze and Silver plans with a bill date of the 1st of the month. The customer upgrades their Silver monthly plan to the annual Gold plan on January 15th.

• Gold annual subscription's regular billing cycle would be from January 15th to January 15th of the following year.
• Gold annual subscription's bill date of January 15th is adjusted to January 1st to align with the bill date of the 1st.
• A prorated invoice for Gold is created for the billing period from January 15th to January 1st.
• The next invoice that will include both subscriptions will be on January 1st.

Other immediate subscription changes that don't involve a plan change won't require proration or adjustment since they'll maintain the current billing period and subscription alignment.

Expiring or canceled subscriptions

Subscriptions in their last billing cycle or those canceled before the bill date won't be included in the next invoice. This logic is the same as the Aggregate Invoice feature.

Promotional Subscriptions Renewing or Expiring

Promotional subscriptions, defined as subscriptions purchased with a gift card or using cardless free trials, will expire if there's no payment method or sufficient credit/coupons to cover the total cost of all promotional subscriptions.

If promotional and non-promotional subscriptions are set to bill together and there's no payment method, subscriptions initiated with a gift card will expire, and the cardless trial subscription will enter dunning. This logic is the same as the Aggregate Invoice feature.

Trial subscriptions

When dealing with trial subscriptions, it's essential to remember:

• If an account doesn't have a bill date (new customer) and they buy a trial subscription, the account's bill date won't be set until the trial ends (when the first non-trial invoice occurs).
• If an account doesn't have a bill date (new customer) and they buy trial subscriptions of varying lengths, the trial subscription that ends first will set the account bill date (e.g., a 7-day trial subscription will have its first non-trial invoice before a 30-day trial subscription).

Trial Subscription without Bill Date

If a customer doesn't have an account bill date, it means they either have a subscription(s) currently in trial or they're a new subscriber.

Example

A new customer buys a 7-day trial subscription on January 15th.

• The trial ends on January 22nd, and the subscription activates into its regular billing cycle.
• The account's bill date is set to January 22nd.
• Any subsequent non-trial subscription purchases or activations will align to this date.

Trial Subscription with Bill Date

If a customer already has an account bill date and buys a new trial subscription, when the subscription finishes its trial, we'll adjust the bill date to match the account bill date. This results in a one-time prorated invoice. At the next bill date, the subscriptions will bill together.

Example

An existing the customer has an account bill date of the 10th. The customer buys a subscription to the monthly Gold plan with a 7-day trial on February 15th.

• When the trial subscription ends on February 22nd, the first non-trial invoice occurs.
• Gold subscription's regular billing cycle is February 22nd - March 22nd.
• Gold subscription's bill date of March 22nd is adjusted to March 10th, to align with the bill date.
• A prorated invoice for Gold is created for the billing period of February 22nd - March 10th.
• The next month's invoice on March 10th will include both subscriptions.

Emails

If you've enabled automatic email templates on your site or plans, the following email templates will support renewal-related emails. These emails will be sent, one email per subscription, if the template is enabled at the site level and if at least one of the subscription plans has the automatic email enabled:

• Renewal Reminder
• Payment Confirmation
• Invoice Past Due

If you're interested in any of these features included in Calendar Billing, please contact Support at [email protected].

Enabling Calendar Billing

Before you can use Calendar Billing, you need to have it enabled for your Recurly account.

• Step 1: Contact Recurly Support at [email protected] to request the activation of the Calendar Billing feature.
• Step 2: Once confirmed by the support team, navigate to your Recurly dashboard. Under the 'Billing' section, you should now see an option for 'Calendar Billing'.

Setting Up Aggregate Invoices

• Step 1: Navigate to the 'Calendar Billing' section.
• Step 2: Choose the 'Aggregate Invoices' option.
• Step 3: Ensure that the subscriptions you want to aggregate share the same bill date, payment method, collection method, and billing cadence.
• Step 4: Save your settings.

Aligning Renewals

• Step 1: In the 'Calendar Billing' section, choose the 'Aligning Renewals' option.
• Step 2: Review the account's current bill date. If the account doesn't have a bill date, it will be set based on the first non-trial invoice.
• Step 3: For any new subscriptions or those coming out of trial, ensure they align with the account's bill date.
• Step 4: Save your settings.

Managing Bill Dates

• Step 1: Navigate to the 'Accounts' page.
• Step 2: Locate the 'Bill Date' section. Here you can view the bill date for each account.
• Step 3: If you need to adjust the bill date for specific subscriptions, use the Postpone feature via the API.

Handling Promotional and Trial Subscriptions

• Step 1: For promotional subscriptions, ensure there's a valid payment method or sufficient credits/coupons to cover the costs.
• Step 2: For trial subscriptions, monitor the end date. Once the trial ends, the subscription will either align with the account's bill date or set a new bill date if none exists.

Setting Up Renewal Emails

• Step 1: Navigate to the 'Email Templates' section in your Recurly dashboard.
• Step 2: Enable the 'Renewal Reminder', 'Payment Confirmation', and 'Invoice Past Due' email templates.
• Step 3: Customize the email content if necessary and save your settings.

Review and Monitor

• Step 1: Regularly check the 'Calendar Billing' section to ensure all settings are as desired.
• Step 2: Monitor your aggregated invoices and aligned renewals to ensure they're functioning correctly.
• Step 3: Address any issues or discrepancies by contacting Recurly Support.