Chargebee Release Notes

Chargebee has added support for Paystack as a payment gateway, enabling you to accept card payments in key African markets.

Why is this important?

Paystack is a widely used payment platform in Africa, offering secure, localized, and user-friendly payment experiences. With support for multiple currencies and strong regional coverage in South Africa, Kenya, Nigeria, and Ghana, this integration makes it easy to expand into fast-growing markets.

How can you use it?

You can now configure Paystack in Chargebee to accept card payments. Go to Settings > Configure Chargebee > Payment Gateways and add Paystack as a new gateway. In future phases, support for more payment methods may be added. Learn more about configuring Paystack in Chargebee.

Package pricing is a new pricing model in Chargebee that allows you to charge customers based on predefined blocks of usage called packages, instead of billing per individual unit. This model works with volume or tiered-based metered plans and addons.

Why is this important?

By aligning your billing with how customers actually consume your service such as per 1,000 API calls, credits, or messages you can make your pricing more predictable and easier for customers to understand. Grouping usage into logical billing units also gives you greater control over revenue.

How can you use it? To enable and configure this feature on your Chargebee site, contact Chargebee Support. Learn more.

Chargebee is now expanding its omnichannel subscriptions feature to support the Google Play Store. This addition allows you to create a single source of truth for subscription purchases across the Apple App Store, Google Play Store, and web storefronts, ensuring a flawless cross-platform experience for your users.

The omnichannel subscription resource unifies subscription data from various platforms, offering you a consolidated view of customers and subscriptions across multiple channels.

This solution builds upon the current mobile subscription functionality, where external marketplace subscriptions are decoupled from the subscriptions in Chargebee and solely managed with webhook events from external sources such as Apple and Google. Learn more about omnichannel events.

In the future, the omnichannel framework can represent subscriptions from external cloud marketplaces such as AWS, Azure, TV stores like Roku, Fire TV, or any other app marketplaces. Chargebee can assist you in building these integrations.

Why is this important? …

Chargebee is completing the final phase of migrating from Stripe's Sources API to the PaymentMethod API. As part of this, ACH Credit and SEPA Credit Transfers will now be processed as Bank Transfers.

Why is this important?

Stripe is deprecating the Sources API for local payment methods such as SEPA, Bancontact, iDEAL, ACH, ACH Credit, and SEPA Credit. To support this, Chargebee has been routing all new requests through Stripe's PaymentMethods API. This ensures continued reliability and access to updated Stripe features. Most local payment methods have already been migrated—ACH Credit and SEPA Credit Transfers are now being transitioned. If you use these methods, Stripe will now treat them as Bank Transfers (Automated Bank Transfers in Chargebee). Existing ACH or SEPA Credit Transfers will still show up with their original names in Chargebee, but Stripe will now process them as Automated or EUR Bank Transfers behind the scenes. This change applies even if you've only enabled ACH/SEPA Credit Transfer in Chargebee.

How can you use it? …

Audit logs are now available for rule creation and updates in Advanced Routing (currently in Private Beta). You can view a complete history of changes directly under each rule's details.

Why is this important?

This enhancement improves the visibility and traceability of your routing logic. Every time a rule is created or modified, an entry is recorded, helping you monitor changes, troubleshoot issues, and maintain control over your configurations.

How can you use it?

No setup is needed. If you have Advanced Routing enabled, go to Settings > Configure Chargebee > Payment Gateways > Advanced Routing, and click on a rule to view its audit log. All past events related to that rule will appear under the Rule Details section.

Chargebee has updated the terminology related to discounts and coupons in the Change Subscription preview during mid-term updates. Discounts are now shown as Adjusted rather than Refunded, making the estimates easier to interpret.

Why is this important?

Previously, manual or coupon discounts appeared as refunded amounts in the estimate preview. This created confusion for billing teams and could lead to end customers mistakenly believing they were owed a refund. The updated terminology helps prevent miscommunication and reduces the risk of billing disputes.

How can you use it?

You don't need to take any action. When you make mid-term changes to subscriptions that include discounts, the updated preview will now reflect the correct adjustment language.

When changing a subscription during trial period, you can now see any existing free period applied to it. Previously, free period was not displayed during subscription changes, making it unclear whether a customer still had time left before billing began.

Why is this important?

With this update, you get a clear view of the free period, ensuring better transparency and accurate billing adjustments. You can also edit the free period when the subscription is in trial state. This helps you make informed decisions when adjusting plans, billing dates, or discounts while ensuring customers receive the correct benefits.

How can you use it?

No action is needed. When editing an existing subscription during trial period, the free period will now be displayed in the change subscription preview.

The Invoice Template Builder now supports internationalization (i18N) for the Adjusted Amount label, allowing you to display it in different languages.

Why is this important?

If you serve customers in multiple regions, presenting invoice details in their preferred language enhances clarity and improves the billing experience.

How can you use it?

To enable translation for adjusted amount, follow the steps below:

1. Navigate to Settings > Configure Chargebee > Invoices, Credit Notes and Quotes.
2. Click General Settings > Invoice Templates > Manage.
3. Configure the Adjusted Amount label in your chosen language, ensuring your invoices align with your customers' localization needs.

You can now set custom field values for subscriptions in Pricing Tables. Instead of waiting for the subscription to be created before updating custom fields, you can pass these values upfront.

Why is this important?

This gives you greater control over subscription data from the start. Whether you're capturing user preferences, tracking campaign sources, or applying custom identifiers, you can now do it when creating the pricing table—saving time and reducing manual updates.

How can I use it?

Integrate Pricify.js, a JavaScript API for Pricing Tables, into your frontend. Then, call the function. Pass the required custom fields and their values as arguments, and they will be assigned when the subscription is created.

We've fixed an issue where the Next Renewal Date and Next Billing Date were incorrect for subscriptions using advanced invoicing. Previously, the subscription details and timeline showed conflicting dates, and the List Subscriptions API returned the billing date as the renewal date, leading to confusion and inaccurate custom reports. Now, the system clearly distinguishes between the two fields, so your reports and API calls reflect accurate renewal and billing timelines.