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
  • 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
    • Reports Explorer
    • Custom Fields in RevenueStory
    • Report Builder
      • Working with Reports
      • Data Sources
        • Coupons
        • Credit Notes
        • Customers
        • Customer Balance
        • Invoices
        • Orders
        • Payments
        • Products
        • Refunds
        • Subscriptions
        • Multientity
        • Product Family
        • Subscription Contract Terms
        • Dunning Details
        • Invoice Transactions
        • Invoice Line Items
        • Invoice Addresses
        • Invoice Discounts
        • Credit Note Line Items
        • Monthly Subscription History
        • Yearly Subscription History
        • Applied Credits
        • Monthly Component History
        • Yearly Component History
        • Order Line items
        • Payment Sources
        • Subscription Discounts
        • Subscription Addons
        • Subscription Shipping Addresses
      • Sample Reports
    • Monthly Recurring Revenue (MRR)
    • Metric Description
  • 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. Addons Billingcycle
  1. Billing
  2. Subscriptions
  3. Addons Billingcycle

Billing Cycle for Addons

Overview

A recurring addon, when applied to a subscription, stays attached for as many billing cycles the subscription runs. Of course, it can be removed at any time. However, if you only want the addon to stay attached to the subscription for a fixed number of billing cycles, you can set the addon billing cycle parameter for the addon while creating or updating a subscription.

Example

Consider that a customer subscribes to a plan (Plan A) with a billing period of 6 months for $600. Now consider an addon with a period of 2 months for $20. This addon period fits into the plan billing period 6 ÷ 2 or 3 times. When the addon is attached to a subscription for plan A, the price of the addon for one subscription billing cycle is 3 × $20 = $60. The first invoice amount becomes $600 + $60 = $660. If the billing cycle for this addon in this subscription is set to 1, the addon is not charged from the next billing cycle of the subscription. In other words, the next invoice after 6 months is $600.

This feature also comes in handy when you want to break down a one-time charge so the customer can pay in parts.

Note

  • Only recurring Addons can have a billing cycle.
  • To enable this feature, contact support

See also

Trial Period for Add-ons

Set up addons with billing cycle

The first step is to set up an add-on.

After navigating to Product Catalog > Add-ons, you can either create a new recurring add-on with the charge or modify an existing add-on for that purpose. Once the add-on is set up, you need to link it to a new subscription or an existing subscription.

To add the add-on to a new subscription, navigate to Subscriptions and click Create New Subscription. Click Add Recurring Add-on. Here you choose the add-on and mention the billing cycle as well.

The add-on will be added to the invoice of the new subscription. As the term progresses and more invoices are generated for each billing cycle, the billing cycle will decrement to become zero and the add-on will be removed.

To add the add-on to an existing subscription, locate the subscription and click Edit Subscription.

Then click the edit icon for an addon to change the number of billing cycles.

For the existing subscriptions, when an addon is added, a prorated invoice is generated based on the subscription term. The prorated period will be considered as one billing cycle as far as the add-on is concerned. If you add a billing cycle to an existing addon linked to a subscription, no charge will be raised. However, the billing cycles for the addon against the subscription will be increased by 1.

Note

If there is a change of term for the subscription (for example, you change the subscription from monthly to quarterly) and the change is done via API, ensure that the billing cycle of the addon is passed as well. If not, the billing cycle of the addon will be reset to ‘forever', i.e., the customer will be charged for the addon indefinitely.

Subscription Cancellation

When a subscription is canceled, the addon linked to the subscription will be disabled till reactivation. There are two scenarios to be taken into account as far as the reactivation of the subscription is considered:

1. In-term Reactivation: If the subscription is reactivated before the end of the subscription term, the billing cycles of the addons will be maintained.

2. Out-of-term Reactivation: If the subscription is reactivated after the end of the subscription term, the billing cycle of the addon will be reset to ‘forever', i.e., the customer will be charged for the addon indefinitely. Using Change Subscription option, you can update the billing cycle of the addon after reactivation.

FAQ

1. How do I collect one-time charges/setup fees in parts? You can use billing cycle for addons to collect the setup fee in parts. Say you're charging your customers a setup fee of $1,000, and you want to let them pay in 10 installments, then the billing cycle should be set as 10. You can configure an addon with "Unit Price" set as $100 and "Billing Cycles" as 10. However, the setup fee modeled as an addon will be considered in the MRR calculation (setup fees defined in the plan are not considered for the MRR).

2. Can I raise an advance invoice for addons that have a billing cycle? Yes, you can raise an advance invoice to collect payments for addons with billing cycles.

Articles & FAQs

Billing cycle for recurring addons
Why is my addon not visible in subscription quotes?

Was this article helpful?