New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now

Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model Context Protocol)

Developer Resources


  • Developer Resources Overview
  • Articles and FAQ

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
    • Billing Mode & Proration
    • Calendar Billing
      • Calendar Billing Configuration
    • Unbilled Charges
    • Net D
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Subscriptions
  3. Billing
  4. Calendar Billing
  5. Calendar Billing Configuration
  1. Billing
  2. Subscriptions
  3. Billing
  4. Calendar Billing
  5. Calendar Billing Configuration

Calendar Billing Configuration

Overview

Easily configure calendar billing on your Chargebee site according to your business needs. Click here to learn more about this feature, the various settings, and use cases.

The following options are available for the configuration of Calendar Billing based on your business type:

  • SaaS: This includes your digital product offerings that do not require shipping.
    • Site-wide configuration: Settings apply to all plans offered to your customers.
    • Plan-specific configuration: Settings will apply to selected plans only.
  • E-Commerce: This includes your physical product offerings that require shipping.
    • Site-wide configuration: Settings apply to all plans offered to your customers.
    • Plan-specific configuration: Settings will apply to selected plans only.

Note

Any changes made as part of the new calendar billing configuration will override any previous billing settings that are currently active on your Chargebee site.

Configuring Calendar Billing

Follow these steps to enable Calendar Billing on your Chargebee site:

  1. Log in to your Chargebee Billing site.

  2. Click Settings > Configure Chargebee > Billing LogIQ > Billing & Invoices > Calendar Billing, and click Enable.

    image
  3. On the Calendar Billing configuration page, select if your products are shippable under Is your product shippable setting by clicking the drop-down to select Yes or No. We recommend configuring this carefully. Once you select an option in this setting, you cannot change it even by disabling and re-enabling the calendar billing settings.

  4. Enable the toggle On under Enable next renewal date at subscription creation option if you want to allow users to modify the next renewal date field while creating subscription records.

  5. Enable the toggle On under Enable Proration option if you want to adjust credits when a subscription is created or changed outside of the billing date range. Learn more about proration.

  6. In the Set proration method, select your preferred proration option from the drop-down list. You can select from the following options:

    • Immediate Alignment
    • Delayed Alignment

    Learn more about proration alignment.

    image
  7. Under Cut-off days specify the number of days during which a single invoice is generated between two billing periods for Weekly, Monthly, and Yearly billing frequency. Learn more about cut-off days.

    image
  8. Click Apply > Confirm to save your updates.

You can continue to configure site-wide billing or plan-specific billing based on your billing preferences and product offerings.

image

Configuring Site-Wide Billing

To configure site-wide billing that applies to all plans and addons in your Chargebee site, follow these steps:

  1. On the Calendar Billing configuration page, click Set up Calendar Billing for your site > Add a site-wide billing frequency.

  2. On the Configure site-wide settings pop-up, specify the following details:

    image
    • Name: Enter a name for the calendar billing site-wide setting that will be used internally within the Chargebee site.

    • Select billing frequency: Select from the applicable billing frequency that is configured on your Chargebee site.

      Note: Calendar billing is not supported for plans with billing frequency in Days.

    • Select billing trigger type: Select from the following billing trigger types from the drop-down list:

      • Standard: Select this option to configure the site-wide settings and have them applied to subscription creation, activation, change, and renewal.
      • Advanced: Select this option to configure the site-wide settings and have them applied to specific subscription events as follows:
        • Apply these calendar billing settings when: You can select to apply the calendar billing settings specifically on subscription creation, activation, change, renewal, or any combination of them.
          image
        • Set billing date range: You can additionally set a range of days in which your customers will be billed for the events you select in the previous step.
          image
    • Set a recurring billing day: You can select from the following options in the drop-down:

      • Select a day/date: Select a recurring billing day or date from the drop-down list to determine when the customer will be billed every subsequent week, month, or year.
      • Not set: Select this option to set the billing day by calling an API.
      • Auto set: Select this option to align with the corresponding subscription's first purchase, applicable only for the associated customer.
  3. Click Add a site-wide billing frequency to configure calendar billing settings for other billing frequencies set up on your Chargebee site.

  4. Once you're done, click Apply > Confirm to save your updates.

You have successfully configured site-wide calendar billing settings.

Configuring Plan-Specific Billing

To configure calendar billing settings to specific plans on your Chargebee site, follow these steps:

  1. On the Calendar Billing configuration page, click Set up Calendar Billing for specific plans > Add a plan-specific billing frequency.

  2. On the Configure plan-specific settings pop-up, specify the following details:

    image
    • Name: Enter a name for the calendar billing plan-specific setting that will be used internally within the Chargebee site.

    • Select plan frequency: Select from the applicable billing frequency that is configured for the plan.

      Note: Calendar billing is not supported for plans with billing frequency in Days.

    • Select billing trigger type: Select from the following billing trigger types from the drop-down list:

      • Standard: Select this option to configure the settings and have them applied to subscription creation, activation, change, and renewal for the plan.
      • Advanced: Select this option to configure the settings and have them applied to specific subscription events for the plan as follows:
        • Apply these calendar billing settings when: You can select to apply the calendar billing settings specifically on subscription creation, activation, change, renewal, or any combination of them for the associated plan.
          image
        • Set billing date range: You can additionally set a range of days in which your customers will be billed for the events you select in the previous step.
          image
      • Set a recurring billing day: You can select from the following options in the drop-down:
        • Select a day/date: Select a recurring billing day or date from the drop-down list to determine when the customer will be billed every subsequent week, month, or year.
        • Not set: Select this option to set the billing day by calling an API.
        • Auto set: Select this option to align with the corresponding subscription's first purchase, applicable only for the associated customer.
      • Click Select Plans to add specific plans/plan price points and click Add plans.
        image
        image
      • Click Apply.
  3. Click Add a plan-specific billing frequency to configure settings for more plans.

  4. Once you're done, click Apply > Confirm to save your updates.

You have successfully configured plan-specific calendar billing settings.

Articles & FAQs

Calendar Billing date not applied for a few subscriptions
What would be the monthly billing date of customers whose billing date fall on the 31st of the month?
How does calendar billing work with subscriptions with 'Future Start'?
How does calendar billing work with subscriptions that has a trial period?
We only ship products to our customers during a certain time of the month (or particular day of the month). How can this be setup?
How to configure self-serve calendar billing for SaaS business?

Show more

Was this article helpful?