New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingCPQPaymentsRevRecGrowthReveal
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

Agentic AI


  • Chargebee Copilot
  • MCP Servers

Developer Resources


  • Developer Resources Overview
  • API Explorer
  • 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
  • Prepaid credits
  • Metered Billing
  • Articles and FAQ

Invoices and Credit Notes


  • 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
  • eInvoicing
  • 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. Usage Based Billing
  3. Articles and FAQ
  4. Metered Billing
  1. Billing
  2. Usage Based Billing
  3. Articles and FAQ
  4. Metered Billing

Is it possible for Chargebee to track customer's service usage with Metered Billing?

Problem Statement

You want to know if it is possible to for chargebee to track customer’s service usage with metered billing.## This article also covers

How to add usage charges to an invoice

How to Close a Pending invoice

Note : If you are using Latest Product Catalog with the new metered billing feature enabled, then it is possible to track the usage in Chargebee. Please refer to this link

Summary

Metered Billing is a feature that allows you to add usage-based charges to invoices, based on your customer's usage at the end of the term (by listening to the pending_invoice_created event). Chargebee allows you to add these charges to the invoice via non-recurring addons or the Add Charge option.

As the usage based charges will need to be accounted for outside of Chargebee, the recommended approach is to use this feature via our APIs.

Solution

To handle this, you would need to keep a record of the customer's usage at your end, and

  • When the subscription comes up for renewal, Chargebee will create an invoice in the draft (Pending) state.

  • This will fire the pending_invoice_created webhook, which you can listen to and update the usage charges to the invoice.

  • The charges can be added to the invoice using the Add One-Time Charge to a Pending Invoice API.

  • Another option of adding the charges are via the Add Non-Recurring Addon to a Pending Invoice API.

  • Once the charges are added, you can Close the invoice using the Close a Pending Invoice API.

  • When the invoice is closed, the status moves from Pending to Payment Due, which will make it available to your customers.

    All of the above API actions can be performed via the UI as well.

    The charges can only be added to the invoice after it is generated in the Pending state, so if you track usage charges on a daily basis, it is recommended to consolidate these charges and add it as a single line item at the term end.

Was this article helpful?