v4.1.1

v4.1.1 (2026-02-10)

---

Bug Fixes:

• Corrected the generation of StringFilter for EnumFilter and BooleanFilter parameters in GET list APIs.

v4.1.0

v4.1.0 (2026-02-06)

---

New Attributes:

• subscription_id has been added to EntitlementOverride.
• is_enabled has been added to EntitlementOverride.
• decommissioned has been added to Subscription.

New Parameters:

• omnichannel_subscription_item has been added as query parameter to list_omnichannel_subscriptions in OmnichannelSubscription.
• entitlement_overrides.entity_id has been added as request body parameter to upsert_or_remove_entitlement_overrides_for_a_subscription in EntitlementOverride.
• entitlement_overrides.entity_type has been added as request body parameter to upsert_or_remove_entitlement_overrides_for_a_subscription in EntitlementOverride.
• entitlement_overrides.is_enabled has been added as request body parameter to upsert_or_remove_entitlement_overrides_for_a_subscription in EntitlementOverride.
• payment_method_save_policy has been added as request body parameter to collect_now in HostedPage.
• decommissioned has been added as request body parameter to cancel_subscription_for_items in Subscription.

Parameter Updates:

• pricing_page has been changed from required to optional in create_pricing_page_for_existing_subscription of PricingPageSession.

New Events:

• payment_due_reminder has been added.

New Enums:

• charge has been added as a new value enum EntityType.
• payment_due_reminder has been added as a new value enum EventType.
• tempus has been added as a new value enum Gateway.
• kakao_pay, naver_pay, revolut_pay, and cash_app_pay have been added as new values enum PaymentMethod.
• always, ask, and never have been added as new values enum PaymentMethodSavePolicy.
• kakao_pay, naver_pay, revolut_pay, and cash_app_pay have been added as new values enum PaymentMethodType.
• kakao_pay, naver_pay, revolut_pay, and cash_app_pay have been added as new values enum Type.
• accepted, rejected, message_acknowledgement, in_process, under_query, conditionally_accepted, and paid have been added as new values to enum attribute einvoice.status in CreditNote.
• accepted, rejected, message_acknowledgement, in_process, under_query, conditionally_accepted, and paid have been added as new values to enum attribute status in Einvoice.
• accepted, rejected, message_acknowledgement, in_process, under_query, conditionally_accepted, and paid have been added as new values to enum attribute einvoice.status in Invoice.
• kakao_pay, naver_pay, revolut_pay, cash_app_pay, wechat_pay, and alipay have been added as new values to enum attribute payment_method_type in PaymentIntent.
• kakao_pay, naver_pay, revolut_pay, cash_app_pay, wechat_pay, and alipay have been added as new values to enum attribute active_payment_attempt.payment_method_type in PaymentIntent.
• kakao_pay, naver_pay, revolut_pay, cash_app_pay, wechat_pay, and alipay have been added as new values to enum request body parameter payment_method_type in update_a_payment_intent of PaymentIntent.
• kakao_pay, naver_pay, revolut_pay, cash_app_pay, wechat_pay, and alipay have been added as new values to enum request body parameter payment_method_type in create_a_payment_intent of PaymentIntent.

v3.43.0

v3.43.0 (2026-02-06)

---

New Attributes:

• subscription_id has been added to EntitlementOverride.
• is_enabled has been added to EntitlementOverride.
• decommissioned has been added to Subscription.

New Parameters:

• omnichannel_subscription_item has been added as query parameter to list_omnichannel_subscriptions in OmnichannelSubscription.
• entitlement_overrides.entity_id has been added as request body parameter to upsert_or_remove_entitlement_overrides_for_a_subscription in EntitlementOverride.
• entitlement_overrides.entity_type has been added as request body parameter to upsert_or_remove_entitlement_overrides_for_a_subscription in EntitlementOverride.
• entitlement_overrides.is_enabled has been added as request body parameter to upsert_or_remove_entitlement_overrides_for_a_subscription in EntitlementOverride.
• payment_method_save_policy has been added as request body parameter to collect_now in HostedPage.
• decommissioned has been added as request body parameter to cancel_subscription_for_items in Subscription.

Parameter Updates:

• pricing_page has been changed from required to optional in create_pricing_page_for_existing_subscription of PricingPageSession.

New Events:

• payment_due_reminder has been added.

New Enums:

• charge has been added as a new value enum EntityType.
• payment_due_reminder has been added as a new value enum EventType.
• tempus has been added as a new value enum Gateway.
• kakao_pay, naver_pay, revolut_pay, and cash_app_pay have been added as new values enum PaymentMethod.
• always, ask, and never have been added as new values enum PaymentMethodSavePolicy.
• kakao_pay, naver_pay, revolut_pay, and cash_app_pay have been added as new values enum PaymentMethodType.
• kakao_pay, naver_pay, revolut_pay, and cash_app_pay have been added as new values enum Type.
• accepted, rejected, message_acknowledgement, in_process, under_query, conditionally_accepted, and paid have been added as new values to enum attribute einvoice.status in CreditNote.
• accepted, rejected, message_acknowledgement, in_process, under_query, conditionally_accepted, and paid have been added as new values to enum attribute status in Einvoice.
• accepted, rejected, message_acknowledgement, in_process, under_query, conditionally_accepted, and paid have been added as new values to enum attribute einvoice.status in Invoice.
• kakao_pay, naver_pay, revolut_pay, cash_app_pay, wechat_pay, and alipay have been added as new values to enum attribute payment_method_type in PaymentIntent.
• kakao_pay, naver_pay, revolut_pay, cash_app_pay, wechat_pay, and alipay have been added as new values to enum attribute active_payment_attempt.payment_method_type in PaymentIntent.
• kakao_pay, naver_pay, revolut_pay, cash_app_pay, wechat_pay, and alipay have been added as new values to enum request body parameter payment_method_type in update_a_payment_intent of PaymentIntent.
• kakao_pay, naver_pay, revolut_pay, cash_app_pay, wechat_pay, and alipay have been added as new values to enum request body parameter payment_method_type in create_a_payment_intent of PaymentIntent.

v4.0.3

v4.0.3 (2026-02-05)

---

New Features:

• Add custom field support for sub-resources in HostedPage, PricingPageSession, Quote, Subscription, and Gift operations.

v4.0.2

v4.0.2 (2026-01-30)

---

New Features:

• Add custom field filtering support for list operations using type-safe filters.

v4.0.1

v4.0.1 (2026-01-19)

---

New Parameters:

• applicable_item_price_ids has been added to Coupon#CouponListRequest.
• applicable_item_price_ids has been added to Export#CouponRequest.

New Enums:

• Twikey has been added to GatewayEnum.

Deleted Action:

• move action has been removed from the ItemPrice.

New Features:

• add util method for export and 'Time Machine' async handler.

v3.42.0

v3.42.0 (2026-01-16)

---

New Parameters:

• applicable_item_price_ids has been added to Coupon#CouponListRequest.
• applicable_item_price_ids has been added to Export#CouponRequest.

New Enums:

• Twikey has been added to GatewayEnum.

Deleted Action:

• move action has been removed from the ItemPrice.

v4.0.0

Releasing v4.x.x 🎉 🎉

v4.0.0 (2026-01-13)

---

⚠️ Breaking changes:

• This is a complete rewrite of the Chargebee Java SDK with a new package namespace (com.chargebee.v4).
• The client library now uses an immutable ChargebeeClient with a fluent builder pattern instead of static Environment configuration.
• All request and response models are now type-safe and immutable.

See the migration guide for details.

New Features:

• Immutable ChargebeeClient with fluent builder configuration.
• Type-safe request parameter models and responses.
• Sync and async APIs with built-in retry and exponential backoff support.
• Per-request options for custom headers and retry configuration.
• Enhanced exception hierarchy with strongly-typed error enums (ErrorType, ApiErrorCode).
• Webhook handler support for event processing.
• Helper methods in response objects to get raw response and headers.

---

🔴 Attention: The support for v3 will eventually be discontinued on December 31st 2026 and will no longer receive any further updates. We strongly recommend upgrading to v4 as soon as possible. See our migration guide for detailed upgrade instructions.

💡 Rest assured: Your existing v3 integrations will continue to function. After December 31st 2026, v3 will no longer receive updates for new API features, but all current functionality will remain operational.

---

v3.41.0

v3.41.0 (2026-01-12)

---

New Parameters:

• invoice_usages has been added to HostedPage#CheckoutExistingForItemsInputParam.

v3.40.0

v3.40.0 (2025-12-30)

---

New Attributes:

• retry_engine has been added to Invoice#DunningAttempt.

New Endpoint:

• move action has been added to ItemPrice.

New Parameters:

• exclude_tax_type has been added to Estimate#RenewalEstimateInputParam.
• variant_id has been added to ItemPrice#MoveInputParam.
• custom has been added to PricingPageSession#CreateForNewSubscriptionInputParam.
• custom has been added to PricingPageSession#CreateForExistingSubscriptionInputParam.

New Enums:

• ELECTRONIC_PAYMENT_STANDARD has been added to PaymentMethodTypeEnum.
• KBC_PAYMENT_BUTTON has been added to PaymentMethodTypeEnum.
• PAY_BY_BANK has been added to PaymentMethodTypeEnum.
• TRUSTLY has been added to PaymentMethodTypeEnum.
• STABLECOIN has been added to PaymentMethodTypeEnum.