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
  • 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
    • Invoice Operations
    • Customizing Invoices
    • Invoice, Credit Note & Quote Numbering
    • Advance Invoices
    • Purchase Order Number
    • Consolidated Invoicing
    • Charges
    • Refunds
    • Invoice Notes
  • 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. Invoices, Credit Notes and Quotes
  3. Invoices
  4. Invoice Notes
  1. Billing
  2. Invoices, Credit Notes and Quotes
  3. Invoices
  4. Invoice Notes

Invoice Notes

The Invoice Notes option lets you add additional contextual notes to invoices for better clarity.

Invoice Notes specific to each customer or subscription can be provided. You can also set them up at the Plan, Addon, or Coupon level to ensure they are included only when that specific item is part of the invoice.

You may also provide a general Invoice Note under Settings > Configure Chargebee > Invoices, credit notes and quotes, and the note will appear on all invoices.

Adding Invoice Notes

Invoice Notes can be added to the following resources (Customer, Subscription, Plan, Addon, and Coupon) in their corresponding details pages.

When an invoice is generated, the Invoice Notes present in the resources associated with the invoice will be retrieved and stored within the invoice. For example, during an invoice generation, if Invoice Notes are present for the customer, subscription, and plan associated with the invoice, then the invoice will display them (refer to the image below).

Note

The notes added will not be reflected in the previously generated invoices. It will only be added to the upcoming invoices.

Editing/Deleting Invoice Notes

You can edit or delete the notes in the details page of the resources (Customer, Subscription, Plan, Addon, and Coupon). However, once the invoice has been generated, the notes that have been stored within the invoice cannot be edited.

Viewing Invoice Notes

Invoice Notes will be part of both the HTML and PDF invoices sent to the customer.

When Invoice Notes are present for multiple entities (Plans, Addons, etc.) of an invoice, it will be displayed in following order:

  • Plan
  • Addon
  • Coupon
  • Subscription
  • Customer
  • General Notes

Adding General Notes

If you want to add a note that is general for all invoices, use the Invoice Notes option available under Settings > Configure Chargebee > Invoices, credit notes and quotes > Invoices tab. For example, you can add terms and conditions or a "Thank You" note using this option.

Adding Invoice Notes via API

You can also add Invoice Notes using the API. This can be done using the Create and Update APIs for the desired resource.

  • Create operation: Add Invoice Notes while creating the resource.
  • Update operation:
    • Add Invoice Notes if not previously present.
    • Edit or delete existing notes.

For example, Invoice Notes for a subscription can be passed with the Create a subscription API request. You can also use the Update a subscription API request to create Invoice Notes if not added via the Create subscription API. The existing Invoice Notes of a subscription can be edited or deleted using the Update subscription API request.

You can obtain the list of notes stored with an invoice from the notes attribute under the invoice object.

Notes while Closing an Invoice

You can also add and remove existing notes while closing an invoice via API (metered billing). The list of parameters to configure this can be found in Close a Pending Invoice API.

Note

You cannot edit or delete the Invoice Notes for Coupons via API, as there is no Update API available for Coupons.

Classic UI users

The module-specific invoice notes configuration are displayed as shown here. The data entered can either be plain text or HTML content.

The Edit and Delete options are displayed as shown here:

Articles & FAQs

How to add notes to an invoice?
How can I introduce a break in the invoice notes and make them appear in multiple lines?
Why are the plan’s invoice notes not appearing on the invoice?

Was this article helpful?