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
  • 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
  • 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. Articles and FAQ
  4. Billing
  1. Billing
  2. Subscriptions
  3. Articles and FAQ
  4. Billing

Proration calculation logic

Problem Statement

This article helps you understand proration calculation logic.

Solution

Scope

How Proration is calculated when a sub is upgraded/downgraded?

Formula to calculate proration.

Calculate Proration when calendar billing is ON

Is there a default setting for proration?

Summary

Proration is calculated in two types: day-based and milli-second based. To enable proration, head to Settings > Configure Chargebee > Billing LogIQ and check the "Enable Proration" checkbox.

image

Then you can manage the proration settings from Billing Mode.

image

The Formula to calculate proration : (Prorated Term / Regular Term) * Plan Amount (OR) (Plan Amount / Regular Term) * Prorated Term

We have migrated to new Self-Serve Calendar Billing configuration from 23 March 2023. Self-Serve Calendar Billing allows you to add multiple Site-level & Plan-level configurations also supports Yearly billing frequency. With this new configuration, you can manage both SaaS and E-Commerce business. Besides, the Advance trigger allows you to set calendar billing for specific events. Reach out to our support to enable this feature on your site.
Refer to this link on how to configure Self-Serve Calendar Billing for SaaS business
Refer to this link on how to configure Self-Serve Calendar Billing for E-Commerce business

Solution

Use-case: Calendar billing is set to 1st to every month and prorate immediately. Now I start a sub with 649$ on 31st JAN . Now my renewal will be 1st of FEB. So my first invoice generated will be prorated. the prorated amount for 1 day is accounting to 23.18$

The Formula to calculate proration : (Prorated Term / Regular Term) * Plan Amount (OR) (Plan Amount / Regular Term) * Prorated Term

Now according to the above formula if we calculate the above use case then -

In this case, the prorated term is Jan 31st to Feb 1st. Internally, we calculate the per-day amount by converting that to a regular term which is Jan 31st to Feb 28th. The number of days between Jan 31st to Feb 28th is 28 so 649/28 = 23.1785.

The per-day amount is then multiplied by the number of days in the prorated term which is 1 day in this case. So the final amount charged was $23.18.

Related Articles

How can I override unbilled charges for a specific customer?
Metered Add-ons not included in MRR calculations.Why?
Currency code error while using chargebee.UnbilledCharge.create API call
Does Chargebee support recurring billing?
How to manage billing address of a customer?
What is the impact of changing site timezone on subscription's Next billing dates?
What happens when Calendar billing is removed or disabled for the site?

Show more

Was this article helpful?