Chargebee Release Notes

You can now use Chargebees Usage APIs to bring usage visibility directly into your portal and product experiences. The new Usage Summary API helps you show how usage changes over time with aggregated views across minute, hour, day, week, or month. The new Usage Charges API helps you show where a subscription stands in the current cycle, including total usage, included usage, overage exposure, and current unbilled charges. The enhanced Upcoming Invoice Estimate API can now include usage-based line items.

Why is this important?

This helps you give customers better clarity before an invoice is generated. Instead of waiting until invoicing is complete, you can show historical usage trends, current-cycle usage and overages, and expected invoice impact in one experience. That can reduce invoice surprise, improve billing transparency, and make it easier for customers to understand how their usage is translating into charges.

How can you use it? …

You can now create subscriptions with multiple plans in a single Checkout session as long as they share the same billing frequency. This removes the earlier limitation of one plan per subscription and lets you sell multiple independent products together. The plans can be across different product families.

Why is this important?

If you sell multiple standalone products, you no longer need to create separate subscriptions or rely on workarounds like zero-currency plans and addons. Instead, you can consolidate purchases into a single checkout, subscription, and invoice, as long as all selected plans share the same billing frequency. It also reduces catalog setup effort and better reflects how you package and sell your offerings.

How can you use it?

Contact Chargebee Support to enable the following:

1. Multi-Plan Subscriptions (MPS).
2. Support for the MPS feature in Checkout.

Chargebee now supports Twikey as a payment gateway, allowing you to accept SEPA Direct Debit payments across Europe.

Why is this important?

Twikey is designed for recurring payments and direct debit workflows, making it well-suited for businesses operating in the EU and SEPA region. It helps you manage mandates efficiently and improves payment success rates for subscription billing. - Collect payments directly from customer bank accounts at lower transaction costs. - Increase payment success rates compared to card payments. - Reduce churn by offering a widely preferred payment method across Europe.

How can you use it?

Configure Twikey as a payment gateway in Chargebee and enable SEPA Direct Debit to start collecting bank payments from your customers.

Learn more about Twikey: Twikey configuration Learn more about configuring SEPA via Twikey: SEPA Direct Debit

Chargebee now supports Level 2 and Level 3 data for Bluesnap and Braintree, enabling you to send enhanced transaction details for B2B and B2G credit card payments.

Why is this important?

Level 2 and Level 3 data allow you to include additional transaction details such as tax, customer, and line-item information during payment processing. This helps reduce interchange fees, improve authorization rates, and provide better visibility into transaction data.

How can you use it?

When using BlueSnap or Braintree as your payment gateway in Chargebee, you can enable this feature by selecting the Level 2 option while following the common configuration steps. For sending Level 3 data, follow the steps outlined in this section.

Learn more about Level 2/ 3 data support in BlueSnap. Learn more about Level 2/3 data support in Braintree.

You can now make billing address fields mandatory while creating or updating customer records.

Why is this important?

Missing billing address information can lead to incorrect tax calculation and compliance issues. By capturing this detail upfront, you reduce the risk of tax errors and ensure that every customer record is complete and reliable for downstream billing and reporting.

How can you use it?

1. Navigate to Settings > Configure Chargebee > Advanced > Mandatory Fields.
2. On the Mandatory Fields page, navigate to the Billing Address section, and use the toggle to mark required fields as mandatory.
3. Click Apply > Confirm.

Once enabled, this information must be provided when creating or updating a customer record, helping maintain consistent data quality across all customer profiles.

Quote Form Builder in Chargebee CPQ now supports generating invoices upfront. Earlier, you could only generate invoices at the time of renewal through billing cycles. This made it challenging to plan your cash flow, share a clear billing schedule upfront so your customers can anticipate upcoming charges and avoid surprises, or ensure your invoices match agreed contract terms, especially for longer commitments.

Why is this important?

Upfront visibility reduces miscommunication and gives your customers a clear view of upcoming charges and timelines before they commit, building trust. For you, this means better cash flow planning with predictable invoicing and reduced operational effort by eliminating the need to review, adjust, or trigger invoices at each renewal.

How can you use it?

You can choose to enable this option for all customer quotes or for individual customers.

For all customers:

1. Navigate to Settings > Configure Chargebee > Chargebee CPQ
2. Click Quote Form Builder.
3. Navigate to Billing and Terms > Generate Advance Invoice.

For individual customers: Select the Generate Advance Invoices option while creating a quote or from the Edit Quote page.

You can now search attached addons and charges directly within the UI using a dedicated search bar that filters items by Item name and Item ID.

Why is this important?

As your list of attached items grows, manually scanning through them can take time and increase the likelihood of selecting the wrong item. This update helps you quickly narrow down results, improving accuracy and reducing effort when working with large catalogs.

How can you use it?

Navigate to the section with attached add-ons and charges, and use the search bar at the top to enter a name or ID. The list updates instantly, allowing you to identify and select the required item with ease.

An issue where removed charges continued to appear in the Hosted Checkout for CPQ quotes has now been resolved. Earlier, even if you removed an Addon while creating or updating a quote, it could still show up on the checkout page because it was originally tied to the plan. This created a mismatch between the quote, its PDF, and the checkout page, which could confuse customers, block them from completing the purchase, or lead to unintended extra charges. With this fix, the checkout now reflects only the items currently included in the quote, so your customers see the correct total and can proceed with confidence.

The Paystack payment gateway and ACH payments via Checkout.com are now generally available in Chargebee. These additions expand your payment capabilities by supporting region-specific payment methods and bank-based transactions.

Why is this important?

Adding Paystack and ACH through Checkout.com helps you support local payment preferences and improve payment success rates across different regions. - Paystack is widely used across Africa, especially in markets such as Nigeria and Ghana where local cards and bank transfers are common. - ACH payments via Checkout.com allow direct bank payments in the US, offering a cost-effective alternative to card transactions. - Supporting these payment methods helps you reach new customer segments and optimize transaction costs in key markets.

How can you use it?

Follow these steps in your Chargebee site to configure these payment gateways and payment methods:

1. Log in to your Chargebee Billing site.
2. Go to Settings > Configure Chargebee > Payment Gateways.
3. Add Paystack as a new payment gateway or enable ACH under your configured Checkout.com gateway.
4. Enter the required credentials and save your changes.

Chargebee requires you to migrate from Razorpay's UPI Collect flow to the UPI Intent flow due to recent compliance updates from the National Payments Corporation of India (NPCI). The UPI Collect flow, which supports payments through UPI ID or VPA (Virtual Payment Address) entry, is being sunset and will no longer be supported for one-time or recurring payments.

Why is this important?

If UPI Collect remains enabled, transactions may fail once the flow is deprecated. Migrating to UPI Intent keeps your checkout compliant and ensures uninterrupted payments. - UPI Intent automatically opens a customer's preferred UPI app instead of requiring manual VPA entry. - This reduces payment failures caused by deprecated flows. - The experience is faster and better aligned with current NPCI guidelines.

How can you use it?

Follow this tutorial to set up the UPI Intent flow for Razorpay. When calling handlePayment(), do not pass the vpa parameter. This triggers the default payment flow for both desktop and mobile web automatically. For additional control, you can also use the **** function to retrieve the list of supported UPI apps.

Chargebee Billing now lets you block the deletion of a customer's last saved payment method. When enabled, Chargebee prevents a payment method from being removed if it is the only valid payment method on the customer's profile. This rule is enforced across the Chargebee app, Self-serve Portal, and API endpoints to ensure consistent behavior across all interfaces.

Why is this important?

Deleting the only valid payment method on a customer's profile can cause subscription renewals to fail and interrupt billing cycles. - Ensures at least one valid payment method is always available for upcoming renewals. - Reduces the risk of payment failures and revenue loss. - Maintains billing continuity across the app, portal, and APIs.

How can you use it?

Follow these steps in your Chargebee site:

1. Log in to your Chargebee Billing site.
2. Go to Settings > Configure Chargebee > Payment Gateways.
3. Click Manage Settings in the Payment Preferences section.
4. Under Common Settings, enable the Block Deletion of the Last Saved Payment Method option.

Once enabled, Chargebee automatically restricts attempts to remove a customer's only valid payment method across the app, self-serve portal, and API endpoints.