Chargebee Release Notes

You can now include an introductory free period when creating subscriptions that combine different billing frequencies (such as an annual plan with monthly addons).

Why is this important?

Chargebee now automatically extends the first billing term for all items in the subscription by the duration of the free period, keeping invoices and renewal schedules aligned.

• Unified Renewal Dates: The free period applies seamlessly across all plans and addons, regardless of their individual billing frequencies.
• Fixed Trial Windows: The free period end date is set at creation. Any addon added while the free period is active will only use the remaining free days.
• Backdated Support: It is fully compatible with backdated subscription starts while maintaining accurate initial billing dates.

How can you use it?

1. On your Chargebee Billing site, confirm that Free Period and Multi-Frequency Billing are enabled.
2. Go to Subscriptions > Create New Subscription.
3. Add the plan and addons as required.
4. In Billing Info, set the Free period duration and unit, then create the subscription.

Note: …

For multi-frequency subscriptions, where plans and addons are billed on different schedules (such as an annual plan with monthly addons), Chargebee Billing now generates a single, consolidated invoice whenever a Subscription Ramp or scheduled change coincides with an item's renewal.

Why is this important?

Instead of generating separate invoices when scheduled price or quantity adjustments fall on the same day an item renews, Chargebee now merges all charges into a single, clean invoice.

How can you use it?

No additional setup is required.

You can now create a Trial Extension + Discount offer in Chargebee Growth that extends a subscriber's trial and applies a Chargebee Billing coupon in one action.

Why is this important?

This offer serves two goals at once: it gives hesitant trial users more time to explore the product, and it gives them a reason to convert by applying a discount when their trial ends. Because trial extension and discount used to be separate offer actions, combining them means both now apply together through a single Chargebee update instead of two.

How can you use it?

1. Confirm that Chargebee Growth is connected to your Chargebee Billing site, and your application where you'll run the offer.
2. Create coupons you want to offer in Chargebee Billing.
3. In Chargebee Growth, go to Offers > + New Offer, choose objective Acquisition, and select Extension + Discount.
4. Configure the Trial extension for Button 1 and the Coupon settings for Button 2. Configure processing via the Billing integration and save.
5. Place the offer in your Acquisition experience / Play, then accept it on a trial subscription and confirm both the new trial end date and the coupon in Chargebee Billing.

You can now set cancel timing in Chargebee Growth to Immediate, End of Current Term, or End of Billing Term, matching Chargebee Billing's cancel options, including support for advance invoices and contract-term subscriptions.

Why is this important?

The new option, End of Billing Term, schedules the cancellation at the end of the last billing period the customer has been invoiced for, including any future period covered by an advance invoice. This keeps their access aligned with the date they've actually paid through, even when the billing term and the current subscription term don't match. When there are no advance invoices, it behaves the same as End of Current Term.

For example, say a customer on a monthly plan is invoiced on March 1 and, through advance invoices, has paid through May 31. If you cancel while the March 1-March 31 cycle is in progress, End of Current Term ends access on March 31, the close of the current billing cycle, while End of Billing Term keeps access until May 31, the last date they've been invoiced for.

For contract-term subscriptions, both options resolve inside the contract period: …

You can now manage multiple custom domains in Chargebee Growth and assign them to specific applications.

Why is this important?

You can keep test and live apps on separate branded URLs without sharing a company-wide custom domain. Previously, a custom domain was applied at the company level, so test and live apps shared the same branded URL. Each app can now serve retention and cancel experiences on its own domain; apps without an assignment continue to use the company default domain.

How can you use it?

1. In Chargebee Growth, go to Settings > Custom domain.
2. Add any additional domains you need, complete DNS verification, and activate them.
3. Open a domain and assign the applications that should use it (for example, map your test app to a test subdomain, and your live app to your production domain).
4. Leave apps on the company default unassigned if they should keep the original domain.
5. Start a test cancel / pre-cancel session for each app and confirm the session URL uses the expected domain.

Previously, your customers could hit a payment error when accepting and paying for a quote through the acceptance page. This happened when taxes were hidden on the quote, but a tax integration still applied tax at conversion: the payment was authorized for the pre-tax total while the conversion tried to collect the taxed total, so the two amounts did not match, and payment failed. This is now fixed. When taxes apply to a quote, the acceptance page shows and charges the taxed amount, so the amount your customer authorizes matches the amount collected at conversion.

You can now offer Klarna, a popular Buy Now, Pay Later (BNPL) method, through the Stripe gateway. During checkout, your customers can choose to pay in full, pay later, or split the cost into interest-free installments, based on their eligibility and region.

Why is this important?

Offering Klarna gives shoppers more flexible payment options and can improve conversion in regions with high BNPL adoption. Because it runs through your existing Stripe connection, you can start accepting Klarna without adding a new gateway. Klarna via Stripe supports both one-time payments and recurring subscriptions using subscription-scoped mandates.

How can you use it?

1. Prerequisite: Enable Klarna in your Stripe account.
2. This feature is in Beta — contact Chargebee Support to get it enabled for your live and test sites.
3. Once enabled by Chargebee Support, turn on Klarna under Settings > Configure Chargebee > Payment Gateway > Stripe.
4. Under Smart Routing, assign your Stripe account to Klarna for the relevant currency, and then click Apply. …

You can now collect New Zealand Dollar (NZD) direct debit payments using the BECS NZ scheme through the Stripe gateway. Previously, BECS NZ was available only via GoCardless.

Why is this important?

You can now keep Stripe as your primary gateway for both cards and direct debit in New Zealand, simplifying reconciliation and reporting while offering customers a low-friction local bank debit option. This extends Chargebee's Direct Debit coverage alongside ACH, SEPA, BACS, BECS AU, PAD, and Autogiro.

How can you use it?

1. Prerequisite: Enable BECS NZ in your Stripe account.
2. This feature is in Beta — contact Chargebee Support to get it enabled.
3. Once enabled by Chargebee Support, turn on BECS Direct Debit (for the NZ region only) under Settings > Configure Chargebee > Payment Gateways > Stripe.
4. Enter your business name, email, and contact number, then click Save and Apply.

New Zealand customers paying in NZD can then add a bank account and accept the mandate at checkout, and recurring charges are collected via BECS NZ direct debit.

You can now accept PayPay, a leading QR-code-based mobile wallet in Japan, through the Stripe gateway. Customers are redirected to authorize the payment and returned to Chargebee once it completes. PayPay via Stripe supports one-time payments in JPY only.

Why is this important?

PayPay is one of Japan's most widely used wallets. Offering it gives your Japanese customers a familiar local checkout experience and can improve conversion, all through your existing Stripe connection.

How can you use it?

1. Prerequisite: Enable PayPay in your Stripe account.
2. This feature is in Beta — contact Chargebee Support to get it enabled.
3. Once enabled by Chargebee Support, turn on PayPay under Settings > Configure Chargebee > Payment Gateway > Stripe and click Apply.

You can now accept South Korean cards through the Stripe gateway during checkout. Customers authenticate with their South Korean card credentials on the provider's page and then return to Chargebee once the process is complete. This method supports both one-time and recurring payments in KRW.

Why is this important?

South Korean cards rely on local authentication and processing rails. Native support lets you serve customers in South Korea natively, with local authentication, and can improve conversion using your existing Stripe connection.

How can you use it?

1. Prerequisite: Enable South Korean cards in your Stripe account.
2. This feature is in Beta — contact Chargebee Support to get it enabled.
3. Once enabled by Chargebee Support, turn on South Korean cards under Settings > Configure Chargebee > Payment Gateway > Stripe and click Apply.

You can now accept Alipay and Alipay HK, leading digital wallets in China and Hong Kong, through the Adyen gateway. Customers authorize payments in the Alipay or Alipay HK app on mobile, or by scanning a QR code on desktop. Both are one-time payment methods: Alipay supports CNY, AUD, CAD, EUR, GBP, HKD, JPY, SGD, MYR, NZD, and USD, while Alipay HK supports HKD.

Why is this important?

Alipay and Alipay HK are preferred wallets for many shoppers in China and Hong Kong. Offering them through Adyen expands your local payment coverage and can improve conversion in supported regions.

How can you use it?

1. Prerequisite: Enable Alipay and Alipay HK in your Adyen account.
2. This feature is in Beta — contact Chargebee Support to get it enabled.
3. Once enabled by Chargebee Support, turn on Alipay and Alipay HK under Settings > Configure Chargebee > Payment Gateways for your Adyen instance and click Apply.