Skip to content

v4.0.0

Choose a tag to compare

View all tags
@cb-alish cb-alish released this 13 Jan 06:22
· 6 commits to v4 since this release
v4.0.0
bb3969b

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.

Assets 2
Loading