March 2025

Chargebee now supports Paystack

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.

Introducing package pricing

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.

Introducing Omnichannel solution for Google Play subscriptions (EAP)

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?

Expanding your business across multiple marketplaces can be challenging. You need to understand each store's billing nuances and build backend infrastructure to deliver a unified experience for users accessing your offering from any store. This also creates difficulties in reporting and real-time customer support.

Chargebee's Omnichannel Subscriptions simplify these processes, helping you address these challenges and go live quickly on various marketplaces. Learn more about the use cases you can solve using this solution.

How can you use it?

To leverage this capability, follow the steps below:

• Connect your Apple App Store and Google Play Store accounts to Chargebee.
• Record a purchase made on Apple or Google Play using the Record a Purchase API.
• Consume the omnichannel subscription webhook events to provision the content and generate reports.
• View all your omnichannel subscriptions for Apple and Google in Chargebee.

Note: Omnichannel Subscription is in Early Access. Submit a request to enable this feature.

ACH/SEPA Credit Transfers now processed through PaymentMethods API

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?

- Use Automated Bank Transfer as the label when filtering offline payment methods. - For EU Bank Transfers, if the customer's billing address is not in Belgium, Germany, Netherlands, Ireland, or France, their virtual bank account number (VBAN) will be created in Ireland. - Ensure that the Stripe webhook event customer_cash_balance_transaction.created is enabled to receive Bank Transfer events.

Audit logs now available in Advanced Routing

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.

Clearer discount messaging in subscription updates

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.

See existing free period while modifying subscription during trial period

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.

Invoice templates now support translations for adjusted amount

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.

Set custom field values upfront in Pricing Tables

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 setSubscriptionAttributes() function. Pass the required custom fields and their values as arguments, and they will be assigned when the subscription is created.

Fixed Moldova ZIP code validation

Previously, valid ZIP codes such as MD-2005 were incorrectly flagged as invalid, preventing address updates. With this fix, you can now successfully use Moldova ZIP codes in the MD-XXXX format when creating or updating customer billing addresses via the API.

Only applicable charges show up in subscription creation

While creating or editing a subscription, when you select the Specific addons and charges are applicable option at the plan level without attaching any charges, you will no longer see unrelated charges. Previously, charges from the same product family still appeared, even though none were selected—making it harder to control what gets added.

Accurate contract value for backdated subscriptions

The Total Contract Value (TCV) calculator now correctly includes the first invoice for backdated subscriptions. Previously, the first invoice was skipped, causing the reported TCV to be lower than the expected value. With this fix, your revenue projections and contract reporting will reflect the full value of all active subscriptions, regardless of start date.

Checkout no longer reverts changes during tax calculation

Previously, on Full-Page Checkout, if a customer updated tax-related fields like VAT number or address while taxes were still being calculated, those changes could be lost—replaced by earlier values once the calculation completed. Now, Checkout preserves the latest input, even during ongoing tax calculations.

Accurate next renewal and billing dates for advanced invoicing

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.

Credit note preview now shows tax and discount breakdown

The credit note preview now displays a clear breakdown of taxes and manual discounts as expected. You'll see the unit amount, the amount after discounts or coupons, and the final amount after taxes, giving you full visibility into how the credit total is calculated. This makes it easier to double-check your numbers and share accurate credit details with your customers.

Credit note preview now reflects correct term details

We've fixed multiple issues with how billing periods were displayed on the credit note preview screen. Earlier, reducing a subscription's billing period or upgrading the plan, especially to higher frequencies like annual, semi-annual, or quarterly could result in inaccurate start or end times shown at the line-item level. With this update, the credit note preview now shows accurate unused periods for all change scenarios, giving you better clarity during mid-term subscription updates.

Accurate date range for unused period in subscription changes

The confirmation screen shown during a subscription change now displays the correct start and end dates for the unused period on the credit note. Previously, these dates were incorrect, which could cause confusion when validating proration or refund details. With this fix, you can confidently review and communicate unused period credits during mid-cycle changes.

Refundable credit date now accurate in proration preview

When updating a subscription mid-cycle, especially after downgrading and then switching back to the original plan, you'll now see the correct date for refundable credits in the proration preview. Previously, even though the credit amount was accurate, the displayed date caused confusion during billing reviews. With this fix, you can confidently share estimates with customers, knowing both the values and dates reflect the correct billing logic.

You can now process offline refunds without errors

We've fixed an issue that was preventing offline refunds from being processed. You can now issue offline refunds without any interruptions—helping you stay flexible with your refund workflows and maintain accurate financial records, even when handling transactions outside your payment gateway.

Store credits now reflected in customer balance

We've fixed an issue where store credits were not being reflected in the customer's balance. With this update, any store credits you apply will now correctly appear in the customer's available balance, ensuring accurate account records and reducing confusion during billing or refunds.

Accurate billing for tiered addons using multiple frequencies

Proration for tiered addons now works as expected when Multi-frequency Addons (MFA) is enabled. Earlier, when you scheduled quantity changes for bi-monthly or monthly tiered addons, the billing period was miscalculated, leading to incorrect unit rates and invoice amounts. This fix ensures that subscription changes reflect the right billing period and pricing, so your invoicing stays accurate and aligned with your addon configurations.

Subscription Addon export now includes billing and term details

The Subscription Addon export CSV file now includes the Term Start, Term End, and Next Billing At fields. Previously, this key information was missing from exports, making it harder to track addon lifecycles and billing schedules. With these fields now added, get better visibility into addon details for reporting, audits, and downstream analysis.

Invoice total now reflects exact discount amount

We've fixed a rounding issue that caused a one-cent discrepancy in the final invoice amount when applying fixed amount discounts. Discounts will now be calculated with improved accuracy, ensuring your invoices reflect the intended amounts down to the last cent.

Accurate quantity retained when editing subscriptions

When changing a subscription's unit-based plan or billing cycle, the quantity field will now retain its original value instead of resetting to 1. Previously, this reset could lead to incorrect billing and manual corrections. With this fix, your updates are more accurate and require less rework, saving time and reducing the risk of billing errors. Contact Chargebee Support to avail this setting.

Proration fixed for metered addons in day-based billing

We've fixed an issue where proration for metered addons appeared in milliseconds instead of days on sites using day-based billing. This was caused by the invoice line item's date_to field being incorrectly set to the job execution time, rather than the addon's actual term end date. This fix ensures proration is accurately calculated and displayed based on the correct billing period, so your invoices reflect the intended usage and timing, especially with Multi-frequency Addons enabled.

Fix for PayPal button misalignment in Checkout

We have fixed an issue where the PayPal payment button would occasionally appear out of place, overlapping with other elements in the Checkout interface.

Checkout behaviour error now fixed

When a customer created a subscription via Checkout using a 100% off coupon on a metered plan, they were sometimes blocked by an 'Invalid Payless Checkout Behaviour' error—even though no payment was actually required. We have fixed this issue.

Subscription export now works with ramp filters

You can now successfully export subscriptions using ramp filters such as Ramp Status or Ramp Start Date without any hiccups. Previously, these filters caused exports to fail in some cases, but that's been fixed. You can additionally now filter subscriptions by the Succeeded Ramp Status, something that was previously unavailable.

Address autocomplete now works correctly for Northern Ireland

When customers entered Northern Ireland addresses in Checkout, address autocompletion would fail with an error. This issue has now been fixed.

Full-page Checkout now retains billing address from API

Previously, when you created a Checkout page using the API with the full-page layout, the billing address you passed was not reflected in the resulting subscription if billing fields were disabled for your customer. This issue did not affect the in-app layout. We've now fixed this, ensuring that your API-passed billing details are accurately captured, even when billing fields are turned off for the Checkout UI.

Subscription ID now visible in credit notes for account hierarchy

Previously, credit notes in account hierarchy setups did not display the Subscription ID, when a subscription was canceled, making it difficult to track cancellations. This issue has been fixed. When a subscription is canceled under a child account, the generated credit note now includes the Subscription ID, helping you quickly identify which subscription was canceled, reducing confusion and improving visibility for both you and your customers.

Trial addons now renew correctly after activation

We've fixed an issue where trial addons were not renewing immediately after activation, leading to missed billing periods and duplicate invoices after the first plan renewal. With this update, trial addons now renew as expected without skipped or extra charges, ensuring accurate invoicing and predictable billing for your customers.

Payment schedule bug resolved for accurate processing

We've fixed a bug that caused multiple payment attempts for a single invoice when using payment schedules. Previously, this issue led to excessive transaction initiations due to a processing loop. With this fix, scheduled payments now trigger only once as intended, preventing unnecessary transaction failures and ensuring a more reliable payment experience.

Credit note previews now display correct values

We've fixed an issue where credit note previews incorrectly displayed discounts being returned instead of them being adjusted. Now, the Charges on Renewal section has been removed, ensuring your credit note previews reflect only relevant details. This gives you a clearer and more accurate view of adjustments before finalizing them.

Resolved 'term_start is greater than term_end' error for metered items

We've fixed an issue where metered items in canceled subscriptions showed a 'term_start is greater than term_end' error due to incorrect term pair changes. Now, the billing term values are correctly assigned, ensuring accurate billing data and preventing unexpected errors in subscription records.

Accurate unbilled charges preview during term reduction

We've fixed an issue where voided items were incorrectly included in the unbilled charges preview when reducing a subscription term, leading to an inaccurate total amount. Now, voided items are excluded from the summary, ensuring you see the correct unbilled charges before making any changes.

Accurate discount display in unbilled charges preview

We've fixed an issue where the preview of unbilled charges did not reflect applied discounts when the next billing date was extended. Now, the preview correctly displays the final amount after applying discounts or coupons, ensuring accurate charge estimates and better alignment with previous versions.

Accurate invoice and billing dates for addon trials

We've fixed an issue where addon trial end dates and invoice start dates were incorrectly calculated. Previously, trial addons were assigned an end date at the end of the day, but the billing period was misaligned due to a function that adjusted the term start incorrectly. With this fix, addon trial periods now end at the correct time, ensuring invoices and billing periods reflect the expected dates.

Future invoices no longer impact current term MRR

We've fixed an issue where generating future invoices incorrectly affected the current term's Monthly Recurring Revenue(MRR) due to misapplied line discounts. Previously, discounts meant for the next term were included in the current term's calculations, leading to inaccurate MRR values. With this fix, MRR calculations now correctly reflect discounts only in their intended billing term, ensuring more accurate revenue reporting.

Promotional credits now display correctly in invoice previews

We've fixed an issue where promotional credits were incorrectly displayed twice in upcoming invoice previews. Now, when you preview multiple invoices, the correct promotional credit amount applies to each estimate without duplication. This ensures you get a precise view of how credits impact your invoices.

Improved handling of scheduled changes for non-renewing subscriptions

We've fixed an issue where scheduled changes for non-renewing subscriptions remained scheduled instead of taking effect. This was caused by a misalignment between the cancellation date and the term end date. We've introduced a new site setting to ensure that when a subscription's cancellation is extended, scheduled changes can apply up to the new cancellation date. You can test this on your sandbox site before enabling it in production to ensure accurate subscription updates.

Accurate line credits in List Invoice API response

We've fixed an issue where the List Invoice API didn't return credits at line item level. Now, when you retrieve invoices via the API, you'll see accurate credit details at the line item level. This ensures better visibility into applied credits, helping you maintain accurate billing records and financial reporting.