Chargebee Release Notes

You can now connect your favorite AI assistants like Cursor, Claude, and ChatGPT directly to Chargebee using the Model Context Protocol (MCP). This allows your AI tools to securely read, analyze, and act on your Chargebee data using real-time account context.

What can your AI assistants do with Chargebee MCP?

Interact with Chargebee data in plain English through three specialized servers. Chargebee MCP anchors its responses in your live account data and up-to-date documentation to ensure highly reliable, context-aware results.

• Knowledge Base Server: Instantly answers complex API and integration questions, and generates working integration code for the REST API and Chargebee.js.
• Onboarding Server: Automatically generates a product catalog directly from your pricing page, and builds features, entitlements, and branding inside a test sandbox for faster evaluation.
• Data Access Server: Retrieves live records—including customer profiles, subscriptions, invoices, events and transactions.

Secure Access Control …

Chargebee Copilot is a chat assistant built into Chargebee Billing that answers your questions without you leaving the application. It has two skills:

• It answers product questions using Chargebee docs.
• It looks up customer and billing data within your Chargebee site.

The skills available to you depend on your site configuration and access level.

Why is this important?

Copilot puts both skills a question away. Instead of searching the documentation to learn how a feature works, you get instant explanations, how-to guidance, and code examples in the chat. Instead of filtering through lists and records to resolve a support query, you ask for a customer's subscriptions, invoices, or latest transaction and get the answer back directly. Lookups respect the access privileges set for your user role, so Copilot surfaces only what you can already see.

How can you use it?

1. Log in to your Chargebee Billing site.
2. Click the Chargebee Copilot icon in the bottom-right corner, or open it from the ellipsis next to Need Help in the left navigation.
3. Ask a question about Chargebee, or ask Copilot to look up your data.

To connect external AI assistants with Chargebee, see Chargebee MCP servers.

The Chargebee Apps CLI lets you build private serverless applications that extend Chargebee Billing by responding to Chargebee events. Scaffold an app, implement and test event handlers locally, and package it into a ZIP file—with no server or infrastructure to provision, scale, or maintain.

Why is this important?

Custom apps let you add tailored automation and integrations on top of Chargebee without standing up and maintaining your own backend. You write only the handler logic; Chargebee runs it in its hosted environment whenever a matching event occurs.

How can you use it?

1. Install the CLI globally from npm using the package (see the CLI developer guide).
2. Create an app using with the standard or iParams template.
3. Implement your event handlers and test them locally using .
4. Package your app using , then contact support to publish it privately to your site.

The Apps CLI is in early access. Request access to enable it on your test site.

You can now update the recipient details, including email address, first name, and last name, on an unclaimed gift subscription using the Update a gift operation in the Gifts API. Once a gift has been claimed, these fields are locked and can't be changed.

Why is this important?

If the purchaser enters the wrong recipient email at checkout, the intended recipient can't claim the gift, because the claim flow validates the email against the stored value before allowing redemption. Previously, fixing a typo meant contacting Chargebee for a manual data update. Now you can correct the recipient details yourself through the API, so the right person can complete their redemption without delay.

How can you use it?

Call the Update a gift operation with the updated , , or values. The update is allowed only while the gift is unclaimed, and the claim flow then validates against the new values so the recipient can redeem normally. This updates the gift receiver details only, not the linked customer record; to change the customer record, update the customer separately.

You can now choose to invoice the final billing period in a prorated manner when a subscription is scheduled for mid-period cancellation during upcoming billing periods.

Why is this important?

Previously, when a subscription was scheduled to end mid-cycle, Chargebee Billing invoiced the full final period and then issued a credit note for the unused portion. The net amount was correct, but the extra credit note created accounting artefacts, complicated integrations, and incorrectly reported deferred revenue until the credit note was generated at cancellation. By billing the exact final period upfront, Billing eliminates the need for a credit note and simplifies billing.

How can you use it?

1. Go to Settings > Configure Chargebee > Billing LogIQ > Customers & Subscriptions > Subscription cancellation.
2. For "When a subscription is scheduled to be canceled after the current billing period, how do you want to bill the final period?", select Invoice only the remaining term.
3. Click Apply.

Chargebee Billing now supports multiple invoice numbering sequences on a single site. Instead of one global series for every invoice, you can set up several numbering configurations and link each one to a segment: a set of conditions based on invoice or customer attributes such as business line, region, or the invoice template used. When an invoice matches a segment, Chargebee applies that segment's numbering series; if no segment matches, it uses the default. Invoices in different categories then receive independent, non-overlapping number sequences.

Why is this important?

Many businesses need to distinguish invoices by type, business line, region, or customer segment, for accounting and compliance. For example, some tax regimes require a separate numbering format for simplified invoices, and finance teams often want distinct series for different brands or entities. A single shared number series makes this hard without workarounds. Segment-based numbering lets you meet reconciliation and compliance requirements for each invoice category without splitting your operations across multiple Chargebee sites.

How can you use it?

Contact Chargebee Support to have the multiple invoice numbering feature enabled for your site.

AI clients connected to Data Lookup MCP can now work with quote data (including PDF links), export jobs for large datasets, and subscription ramp lookups—alongside existing customer, subscription, invoice, and payment tools.

Why is this important?

Teams can investigate quotes, pull bulk exports, and inspect ramp schedules from the same AI client they already use for billing lookups.

How can you use it?

1. In the Chargebee Billing app, go to Settings > Configure Chargebee > Agentic AI > MCP Servers.
2. Open Chargebee Data Lookup MCP Server.
3. Enable quote, export, and subscription-ramp tools.
4. In your AI client, ask for quote details, start or check an export job, or retrieve ramp data for a subscription.

This release introduces key updates to In-App Checkout to make the purchase flow more intuitive, reduce failed transactions, and boost conversion rates for your business.

Instant order completion after payment authorization

Chargebee now creates or updates the subscription the moment a payment is authorized, even if your customer doesn't make it back to the original checkout page. Many payment methods redirect customers to an external banking app or link for authorization. On mobile devices especially, customers often do not return to the original checkout page once the payment is approved. Chargebee now updates the subscription the moment authorization is received—ensuring a successful transaction even if the customer closes the window or navigates away.

Fixed total confirmation before payment

The payment authorization step now occurs immediately after the order review step. This locks in the exact final total—including taxes and shipping adjustments—before the customer authorizes the payment. This prevents total mismatches and failed transactions that previously occurred if a customer modified their address late in the checkout flow after an early authorization had already taken place.

Other improvements to the checkout flow …

Chargebee now sends richer email notifications to your customers for BECS Direct Debit payments processed through GoCardless. Pre-payment notifications for recurring payments now include the debit amount, currency, the charge date, and a charge description.

Why is this important?

GoCardless enforces BECS compliance regulations for Direct Debit payment notifications. These notifications give your customers more detail about upcoming debits and changes to their Direct Debit Request (DDR).

How can you use it?

To stay compliant, enable Direct Debit email notifications for your customers either in Chargebee or GoCardless.

When proration is re-enabled after being disabled, updating a subscription mid-term now automatically generates a credit note for the unused portion of the current term charges.

Why is this important?

Businesses running periodic price increases often turn proration off during a mid-cycle change so existing subscribers aren't charged right away. Previously, if a subscriber then upgraded or changed their subscription later in the same term with proration on, Chargebee did not credit what they had already paid for that term, which could overcharge them. This enhancement credits the unused current-term charges correctly, so your subscribers pay only the incremental difference for the remaining days.

How can you use it?

No additional setup is required.

You can now assign an Avalara location code to individual price points in Chargebee Billing. When a location code is set on a price point, Chargebee sends the matching origin address to AvaTax for Sales at the line-item level during tax calculation, instead of applying the site-level organization address to every item.

Why is this important?

Some businesses ship goods from more than one location, or sell products tied to different physical origins. Applying a single site-level origin address to every line item produces the wrong tax for any item whose origin differs from your primary address. By passing a per-item origin address to Avalara, Chargebee applies the correct jurisdiction and rate to each line item based on where that product or service originates.

How can you use it?

1. Go to Product Catalog > Plans (or Addons), and open the item price you want to edit. …

The Create Subscription and Update Subscription APIs now enforce validation rules specific to automated metered billing. Previously, certain invalid configurations could be submitted without returning an error, leading to inconsistent subscription states downstream. Requests that violate automated metered billing constraints will now receive a clear API error at the point of submission, making it easier to identify and correct configuration issues before they affect billing.

You can now accept Pix, Brazil's most popular instant payment method, directly within Chargebee Billing via the dLocal gateway.

Why is this important for your growth in Brazil?

• Bypass Credit Card Declines: Cross-border credit cards in Brazil suffer from high failure rates due to aggressive anti-fraud blocks. Pix runs directly through bank accounts, offering higher authorization rates and drastically reducing involuntary churn.
• Zero Local Friction: Via dLocal, you can accept local Brazilian payments seamlessly without the legal, operational, and tax overhead of establishing a local regional entity.
• Automated Subscription Workflows: Built-in webhooks automatically track payment status, verify transactions asynchronously

How can you use it?

Follow these steps to configure Pix as a payment method for dLocal in your Chargebee Billing site:

1. Go to Settings > Configure Chargebee > Payment Gateways > dLocal.
2. Enable Pix on the Configure dLocal page.
3. Click Apply to save your changes.

Once enabled, you can start accepting Pix payments. To learn more, refer to the documentation.

You can now configure a site-level redirect URL for subscription Checkout sessions that is distinct from the URL configured for one-time Checkout. If your site is migrated from the legacy Checkout suite, your existing site-level redirect URL is copied to the new configuration.

Why is this important?

You can use this URL as a fallback destination after a subscription checkout is completed, while continuing to set separate redirect URLs at the API session and plan levels. This gives you more control over where customers are sent after completing subscription checkout. Chargebee applies redirect URLs in the following order of precedence: API or session-level URL first, plan-level URL next, and site-level URL last.

How can you use it?

1. Sign in to Chargebee Billing.
2. Navigate to Settings > Configure Chargebee > Checkout & Self-Serve Portal > Configuration tab. …

You can now leverage location-based customer segments to target subscription renewal reminders to specific geographies, ensuring seamless adherence to local regulations.

Why is this important for your global compliance and revenue operations?

Strict consumer regulations, such as those in the UK and EU, require advance notice before a subscription auto-renews. With this update, you can isolate these notifications to a location or country, ensuring local compliance without over-notifying global subscribers.

How can you use it?

1. Sign in to Chargebee Billing site.
2. Navigate to the Subscriptions or Customers list page.
3. Use the filter to define a segment with billing country as a condition. Save this segment and apply it when configuring renewal reminder notifications. You can attach different segments to notification workflows and schedule reminders at required intervals, ensuring that only customers in the selected locations receive the communication at the right time.