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

How can I override unbilled charges for a specific customer?

Problem Statement

You want to know how can I override unbilled charges for a specific customer.

Scope

Override Unbilled Charges setting for a customer

Summary

Unbilled Charges are created when there are specific manual events created such as when a subscription is created, Subscription is changed, Subscription is reactivated, Subscription term is extended, One-time charge, Advance charges are created with Charges.

This can be configured under site-level settings from Settings > Configure Chargebee > Billing LogIQ > Unbilled Charges. Also, it can be overridden from the Subscription/Customer level using Allow overriding via Chargebee interface toggle from the Unbilled Charges settings.

Note

Total Unbilled charges for a specific customer We have updated our summary box to provide a more streamlined and elegant user experience. With this upgrade, hyperlinks have been added to the summary box, allowing users to easily access related information. The Total Unbilled charges on Summary Section is available at the top of the Customer details page which provides a total amount due of a customer and hyperlink that directs to the details. Refer to this link for more details.

Solution

Configuration

Chargebee allows you to configure how unbilled charges are handled in your site. Navigate to Settings > Configure Chargebee > Unbilled Charges and ensure that the proper settings are in place.

image

You can choose the site defaults as either invoice immediately or add them to unbilled charges for the following cases:

  • When a subscription is created and there are charges
  • When a subscription is changed, and there are charges
  • When a subscription is reactivated and there are charges
  • When subscription term is extended, and there are charges
  • When one-time charges are created
  • When advance charges are created

Users can choose to override these default settings while creating charges on the Chargebee interface. However, if you wish to prevent them from doing so, click on the more options (vertical ellipsis) menu to the right of the setting and disable the Allow overriding via Chargebee interface toggle.

image

Say for example, if you have enabled Override option, you will see one of the option be selected by default, however you can choose to change the options.

image

Via API

Creating Actual Charges Here are the API calls you can use while adding a charge to the list of unbilled charges:

Note

set the invoice_immediately parameter to false to keep the charge as unbilled

  • Create a subscription
  • Create a subscription for customer
  • Update a subscription
  • Add charge at term end
  • Charge addon at term end
  • Reactivate a subscription

Related Articles

Metered Add-ons not included in MRR calculations.Why?
Currency code error while using chargebee.UnbilledCharge.create API call

Was this article helpful?