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.

v4.0.0-beta.3

What's Changed

• Testcase for transport and url pattern by @cb-karthikp in #59
• Next version update by @cb-karthikp in #63
• exception handling, webhook handler by @cb-karthikp in #65

Full Changelog: v4.0.0-beta.1...v4.0.0-beta.3

v3.39.0

v3.39.0 (2025-11-26)

---

New Resources:

• Einvoice has been added.
• QuotedDeltaRamp has been added.

New Attributes:

• line_items_next_offset has been added to CreditNote.
• line_items_next_offset has been added to Invoice.
• credit_lines has been added to SalesOrder.
• billable_unit_price has been added to SalesOrder#LineItem.
• billable_quantity has been added to SalesOrder#LineItem.
• billable_amount has been added to SalesOrder#LineItem.

New Endpoint:

• move has been added to ItemPrice.

New Parameters:

• line_items_limit has been added to CreditNote#RetrieveRequest.
• line_items_offset has been added to CreditNote#RetrieveRequest.
• line_items_limit has been added to Invoice#RetrieveRequest.
• line_items_offset has been added to Invoice#RetrieveRequest.
• item_tiers has been added to Estimate#GiftSubscriptionForItemsRequest.
• unit_price has been added to Estimate#SubscriptionItems#GiftSubscriptionForItemsRequest.
• unit_price_in_decimal has been added to Estimate#SubscriptionItems#GiftSubscriptionForItemsRequest.
• item_tiers has been added to Gift#CreateForItemsRequest.
• meta_data has been added to Gift#CreateForItemsRequest.
• unit_price has been added to Gift#SubscriptionItems#CreateForItemsRequest.
• unit_price_in_decimal has been added to Gift#SubscriptionItems#CreateForItemsRequest.
• item_tiers has been added to HostedPage#CheckoutGiftForItemsRequest.
• unit_price has been added to HostedPage#SubscriptionItems#CheckoutGiftForItemsRequest.
• unit_price_in_decimal has been added to HostedPage#SubscriptionItems#CheckoutGiftForItemsRequest.
• auto_select_local_currency has been added to PricingPageSession#CreateForNewSubscriptionRequest.

New Enums:

• EZIDEBIT has been added to GatewayEnum.
• BUSINESS_RULE has been added to EntityTypeEnum.
• RULESET has been added to EntityTypeEnum.

v3.38.0

New Attributes:

• reference_transactions has been added to Invoice.
• payment_attempts[] has been added to PaymentIntent.
• checkout_details has been added to PaymentIntent#PaymentAttempt.
• line_item_id has been added to CreditNoteEstimate#Discount.
• line_item_id has been added to CreditNote#Discount.
• line_item_id has been added to InvoiceEstimate#Discount.
• line_item_id has been added to Invoice#Discount.
• line_item_id has been added to InvoiceEstimate#Discount.
• line_item_id has been added to Quote#Discount.
• line_item_id has been added to QuoteLineGroup#Discount.

Modified Attributes:

• omnichannel_subscription_item_offers has been made optional attribute from required attribute.

New Input Parameters:

• discount[line_item_id] has been added to CreditNote#ImportCreditNoteRequest.
• discount[line_item_id] has been added to CreditNote#ImportInvoiceRequest.

New Enums:

• OMNICHANNEL_TRANSACTION_CREATED has been added to EventTypeEnum.
• DEUTSCHE_BANK has been added to Gateway.

v4.0.0-beta.1

v4.0.0-beta.1