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

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Developer Resources
  • 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)

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
    • Next Billing Date
    • Trial Management
      • Trial Period for Addons
    • Price Override
    • Pause Subscription
    • Subscription Cancellation
    • Reactivation
    • Gift Subscriptions
    • Backdating Subscriptions and Invoices
    • Managing Contract Terms
  • Billing
  • Orders
  • Articles and FAQ

Customers


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

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
  • Managing payments with ChargebeeJS
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • 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

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
  • Order Management
  • Mobile Subscriptions (Legacy)
  • Other Integrations
  • 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. Working with Subscriptions
  4. Trial Management
  5. Trial Period for Addons
  1. Billing
  2. Subscriptions
  3. Working with Subscriptions
  4. Trial Management
  5. Trial Period for Addons

Trial Period for Addons

Introduction

Along with the service or product that you offer, additional features can help attract more customers. These supplementary features are provided at an added cost and are known as addons. With Chargebee, you can offer addons on trial to your customers, so they can experience the feature before signing up for it.

For example, if you offer Google Calendar as an addon, customers interested in signing up can use the Google Calendar feature for a limited number of days as a trial before using it with their subscription.

Note

Request access to enable this feature on your site.

Configure Trial Period for Addons

The trial period for addons is available only via API. You can save the details of the addon's trial period in the metadata of the addon.

Invoice for Addons on Trial

At the end of the trial period, the addons will move to Active state. When it does, a separate invoice is generated for the addon. From the date of activation to the date of subscription renewal, a prorated charge will be generated for the addon.

For example, for a subscription with a billing cycle from January 15 to February 15, an addon was added as a trial on January 20 for 10 days. The addon will activate on January 30, and an invoice with a prorated charge will be raised for January 31 to February 15.

If the customer's subscription renews on the same day the addon is activated, they will receive two invoices: one for the subscription and one for the addon, regardless of the number of addons.

For example, if a customer has a subscription and three addons on trial, and the subscription renews on the same day the addons become activated, the customer will receive four invoices: one for the subscription renewal and three for the addons.

Note

A separate invoice will be generated at the end of the addon trial even when Consolidated Invoicing is enabled for your Chargebee site.

Subscription Cancellation and Reactivation (Dunning)

When subscriptions are canceled due to the dunning rules that are set, addons on trial will follow suit. However, there are two scenarios to consider during the reactivation of the subscription:

1. In-term Reactivation

If the subscription is reactivated before the renewal date or time, the addon will continue to function upon reactivation. The trial end date or time set originally will not change.

Say, the billing cycle for subscription is from January 15 to February 15. Subscription got canceled on January 30 and reactivated on February 10. There are two addons, Addon 1 and Addon 2, linked to the subscription and on trial for 15 days.

AddonsTrial PeriodWill the addon be on trial when the subscription reactivates?Charge on reactivation
Addon 1January 20 - February 5NoProrated charge from February 5 - February 15
Addon 2January 27 - February 12YesNo charge, the addon is still on trial.

2. Out-of-term Reactivation

If the subscription is reactivated after the renewal date or time, the term of the addon will be reset and the trial will no longer apply. The customer will have to pay for the subscription and the addons, regardless of the completion of the trial period.

Say, the billing cycle for subscription is from January 15 to February 15. Subscription got canceled on February 12 and reactivated on February 22.

AddonsTrial PeriodWill the addon be on trial when the subscription reactivates?Charge on reactivation
Addon 1February 5 - February 20NoFull
Addon 2February 10 - February 25NoFull

For both addons, a full charge will be raised on the date of reactivation of the subscription.

Note

If Calendar Billing is enabled for your site, the charge can be prorated from the date or time of reactivation to the upcoming billing date or time.

Subscription Cancellation/Reactivation (Manual)

When a subscription is canceled manually, the subscription term is not retained. The addons on trial linked to the same subscription will also be canceled.

When the same subscription is reactivated, both the subscription and the addons will move to Active state and will be charged in full.

Limitations

  • Only recurring addons can have a trial period added to them. Non-recurring addons are not supported.
  • Addons with a trial period can be added only for subscriptions in Active state.
  • Once set, the trial_end of an addon cannot be modified. To change it, the addon must be removed and added again with a new trial_end.
  • When the addon is going through the trial period, values of all fields except for the trial_end value can be modified.
  • Addons going through the trial period will move to Active state only when the trial period ends.
  • Changes for the addon will be applied immediately and cannot be scheduled for the end of the subscription term.
  • For advance invoicing, the addon on trial feature will not function.

Was this article helpful?