Releases: chargebee/chargebee-python
Releases · chargebee/chargebee-python
Release list
v3.25.0
v3.25.0 (2026-07-01)
New Features
- Added an optional telemetry adapter hook for tracing Chargebee API calls via OpenTelemetry (or any APM). Configure it via
Chargebee(..., telemetry_adapter=adapter). When unconfigured, the SDK skips all telemetry work — no behavior change for existing integrations. - Each API call emits one CLIENT span (
chargebee.{resource}.{operation}) with OpenTelemetry HTTP semantic-convention attributes pluschargebee.*attributes. Adapters may inject W3C trace context (traceparent) into outbound request headers for distributed tracing. - Exposed the telemetry types (
TelemetryAdapter,RequestTelemetryContext,RequestTelemetryResult,RequestTelemetryError), theTelemetrySupporthelpers, and theTelemetryAttributeKeysconstants underchargebee.telemetry. OpenTelemetry is not bundled with the SDK; bring your own OTel packages in the host application.
v3.24.0
v3.24.0 (2026-06-12)
New Resources:
GrantBlockhas been added.LedgerAccountBalancehas been added.LedgerOperationhas been added.PromotionalGranthas been added.
New Attributes:
noteshas been added toCreditNote.layouthas been added toHostedPage.
New Parameters:
sort_byhas been added as query parameter tolist_omnichannel_subscriptionsinOmnichannelSubscription.
New Enums:
available,exhausted,scheduled, andin_grace_periodhave been added as new values enumStatus.subscription_created,subscription_changed,top_up,promotional_grants, androlloverhave been added as new values to enum attributegrant_sourceinGrantBlock.provisionedandoverdrafthave been added as new values to enum attributeaccount_typeinGrantBlock.credit_unithas been added as a new value to enum attributeunit_typeinGrantBlock.credit_unithas been added as a new value to enum attributeunit_typeinLedgerAccountBalance.allocation,capture,authorize,release_authorization,capture_authorization,expiry,void,rollover, andadjustmenthave been added as new values to enum attributetypeinLedgerOperation.credit_unithas been added as a new value to enum attributeunit_typeinLedgerOperation.expires_at,created_at, andeffective_fromhave been added as new values to enum query parametersort_by.ascinlist_grant_blocksofGrantBlock.expires_at,created_at, andeffective_fromhave been added as new values to enum query parametersort_by.descinlist_grant_blocksofGrantBlock.allocation,release_authorization,void,capture,rollover,adjustment,expiry,authorize, andcapture_authorizationhave been added as new values to enum query parametertype.isinlist_ledger_operationsofLedgerOperation.allocation,release_authorization,void,capture,rollover,adjustment,expiry,authorize, andcapture_authorizationhave been added as new values to enum query parametertype.ininlist_ledger_operationsofLedgerOperation.created_athas been added as a new value to enum query parametersort_by.ascinlist_ledger_operationsofLedgerOperation.created_athas been added as a new value to enum query parametersort_by.descinlist_ledger_operationsofLedgerOperation.updated_atandcreated_athave been added as new values to enum query parametersort_by.ascinlist_omnichannel_subscriptionsofOmnichannelSubscription.updated_atandcreated_athave been added as new values to enum query parametersort_by.descinlist_omnichannel_subscriptionsofOmnichannelSubscription.
v3.23.0
v3.23.0 (2026-06-08)
New Attributes:
purchased_athas been added toOmnichannelSubscription.updated_athas been added toOmnichannelSubscription.updated_athas been added toOmnichannelSubscriptionItem.
New Parameters:
customer_id.inhas been added as query parameter tolist_omnichannel_subscriptionsinOmnichannelSubscription.customer_id.not_inhas been added as query parameter tolist_omnichannel_subscriptionsinOmnichannelSubscription.idhas been added as query parameter tolist_omnichannel_subscriptionsinOmnichannelSubscription.id_at_sourcehas been added as query parameter tolist_omnichannel_subscriptionsinOmnichannelSubscription.updated_athas been added as query parameter tolist_omnichannel_subscriptionsinOmnichannelSubscription.purchased_athas been added as query parameter tolist_omnichannel_subscriptionsinOmnichannelSubscription.gift_receiverhas been added as request body parameter toupdate_a_giftinGift.layouthas been added as request body parameter tocheckout_gift_subscription_for_itemsinHostedPage.
Parameter Updates:
scheduled_athas been changed from required to optional inupdate_a_giftofGift.
New Events:
omnichannel_subscription_item_updatedhas been added.omnichannel_subscription_item_recoveredhas been added.
Deleted Resources:
- QuoteEntitlement has been removed.
Deleted Attributes:
entity_idhas been removed fromQuoteEntitlement.entity_typehas been removed fromQuoteEntitlement.feature_idhas been removed fromQuoteEntitlement.valuehas been removed fromQuoteEntitlement.is_enabledhas been removed fromQuoteEntitlement.start_datehas been removed fromQuoteEntitlement.end_datehas been removed fromQuoteEntitlement.created_athas been removed fromQuoteEntitlement.modified_athas been removed fromQuoteEntitlement.
Deleted Parameters:
excludehas been removed as query parameter fromlist_invoicesinInvoice.
New Enums:
omnichannel_subscription_item_updatedandomnichannel_subscription_item_recoveredhave been added as new values enumEventType.klarna,alipay_hk,paypay,gcash, andsouth_korean_cardshave been added as new values enumPaymentMethod.klarna,alipay_hk,paypay,gcash, andsouth_korean_cardshave been added as new values enumPaymentMethodType.klarna,alipay_hk,paypay,gcash, andsouth_korean_cardshave been added as new values enumType.klarna,alipay_hk,paypay,gcash, andsouth_korean_cardshave been added as new values to enum attributepayment_method_typeinPaymentIntent.klarna,alipay_hk,paypay,gcash, andsouth_korean_cardshave been added as new values to enum attributeactive_payment_attempt.payment_method_typeinPaymentIntent.klarna,alipay_hk,paypay,gcash, andsouth_korean_cardshave been added as new values to enum request body parameterpayment_method_typeinupdate_a_payment_intentofPaymentIntent.klarna,alipay_hk,paypay,gcash, andsouth_korean_cardshave been added as new values to enum request body parameterpayment_method_typeincreate_a_payment_intentofPaymentIntent.
v3.22.0
v3.21.0
v3.21.0 (2026-05-04)
New Resources:
QuoteEntitlementhas been added.
New Actions:
list_applicable_alerts_for_a_subscriptionhas been added toAlert.retrieve_an_alerthas been added toAlert.update_an_alerthas been added toAlert.delete_an_alerthas been added toAlert.list_alertshas been added toAlert.create_an_alerthas been added toAlert.list_alert_statuses_for_a_subscriptionhas been added toAlertStatus.list_alert_statuses_for_an_alerthas been added toAlertStatus.
New Attributes:
alarm_statushas been added toAlertStatus.
New Parameters:
limithas been added as query parameter tolist_applicable_alerts_for_a_subscriptioninAlert.offsethas been added as query parameter tolist_applicable_alerts_for_a_subscriptioninAlert.statushas been added as query parameter tolist_applicable_alerts_for_a_subscriptioninAlert.typehas been added as query parameter tolist_applicable_alerts_for_a_subscriptioninAlert.limithas been added as query parameter tolist_alertsinAlert.offsethas been added as query parameter tolist_alertsinAlert.idhas been added as query parameter tolist_alertsinAlert.typehas been added as query parameter tolist_alertsinAlert.subscription_idhas been added as query parameter tolist_alertsinAlert.statushas been added as query parameter tolist_alertsinAlert.limithas been added as query parameter tolist_alert_statuses_for_a_subscriptioninAlertStatus.offsethas been added as query parameter tolist_alert_statuses_for_a_subscriptioninAlertStatus.alarm_statushas been added as query parameter tolist_alert_statuses_for_a_subscriptioninAlertStatus.alert_idhas been added as query parameter tolist_alert_statuses_for_a_subscriptioninAlertStatus.limithas been added as query parameter tolist_alert_statuses_for_an_alertinAlertStatus.offsethas been added as query parameter tolist_alert_statuses_for_an_alertinAlertStatus.alarm_statushas been added as query parameter tolist_alert_statuses_for_an_alertinAlertStatus.excludehas been added as query parameter tolist_invoicesinInvoice.thresholdhas been added as request body parameter toupdate_an_alertinAlert.statushas been added as request body parameter toupdate_an_alertinAlert.thresholdhas been added as request body parameter tocreate_an_alertinAlert.filter_conditionshas been added as request body parameter tocreate_an_alertinAlert.typehas been added as request body parameter tocreate_an_alertinAlert.namehas been added as request body parameter tocreate_an_alertinAlert.descriptionhas been added as request body parameter tocreate_an_alertinAlert.metered_feature_idhas been added as request body parameter tocreate_an_alertinAlert.subscription_idhas been added as request body parameter to [create_an_alert](https://apidocs.chargebee.com/docs/a...
v3.20.0
v3.20.0 (2026-03-27)
New Resources:
Alerthas been added.AlertStatushas been added.CpqQuoteSignaturehas been added.
New Actions:
update_a_quote_signature_statushas been added toQuote.update_a_quote_signaturehas been added toQuote.retrieve_a_quote_signature_signed_pdfhas been added toQuote.retrieve_a_quote_signaturehas been added toQuote.create_a_quote_signaturehas been added toQuote.refresh_a_quote_signature_linkhas been added toQuote.
New Attributes:
reference_idhas been added toEinvoice.provider_referenceshas been added toEinvoice.created_athas been added toUnbilledCharge.
New Parameters:
include_usage_chargeshas been added as query parameter toupcoming_invoices_estimateinEstimate.business_entity_idhas been added as request body parameter tomanage_payment_sourcesinHostedPage.cpq_quote_signaturehas been added as request body parameter toupdate_a_quote_signature_statusinQuote.gateway_account_idhas been added as request body parameter tocreate_a_virtual_bank_accountinVirtualBankAccount.gateway_account_idhas been added as request body parameter tocreate_a_virtual_bank_account_using_permanent_tokeninVirtualBankAccount.
New Events:
alert_status_changedhas been added.
New Enums:
alert_statushas been added as a new value enumEntityType.alert_status_changedhas been added as a new value enumEventType.pixhas been added as a new value enumPaymentMethod.pixhas been added as a new value enumPaymentMethodType.pixandusage_exceededhave been added as new values enumType.enabledanddisabledhave been added as new values to enum attributestatusinAlert.globalandsubscriptionhave been added as new values to enum attributescopeinAlert.draft,active,signed,expired,cancelled, anddeclinedhave been added as new values to enum attributestatusinCpqQuoteSignature.esign_and_pay,esign, andpayhave been added as new values to enum attributecustomer_acceptance_methodinCpqQuoteSignature.consolidatedanddetailedhave been added as new values to enum attributequote_typeinCpqQuoteSignature.pixhas been added as a new value to enum attributepayment_method_typeinPaymentIntent.pixhas been added as a new value to enum attributeactive_payment_attempt.payment_method_typeinPaymentIntent.pixhas been added as a new value to enum request body parameterpayment_method_typeinupdate_a_payment_intentofPaymentIntent.pixhas been added as a new value to enum request body parameterpayment_method_typeincreate_a_payment_intentofPaymentIntent.expired,declined,draft,active,signed, andcancelledhave been added as new values to enum request body parametercpq_quote_signature.statusinupdate_a_quote_signature_statusofQuote.
v3.19.1
v3.19.0
v3.19.0 (2026-03-02)
New Resources:
UsageChargehas been added.UsageSummaryhas been added.
New Attributes:
free_periodhas been added toQuotedSubscription.free_period_unithas been added toQuotedSubscription.
New Parameters:
net_term_dayshas been added as request body parameter tocreate_invoice_for_items_and_one-time_chargesinInvoice.contract_termhas been added as request body parameter tocreate_pricing_page_for_existing_subscriptioninPricingPageSession.contract_termhas been added as request body parameter tocreate_pricing_page_for_new_subscriptioninPricingPageSession.subscription.free_periodhas been added as request body parameter tocreate_a_quote_for_a_new_subscription_itemsinQuote.subscription.free_period_unithas been added as request body parameter tocreate_a_quote_for_a_new_subscription_itemsinQuote.subscription.free_periodhas been added as request body parameter toedit_create_subscription_quote_for_itemsinQuote.subscription.free_period_unithas been added as request body parameter toedit_create_subscription_quote_for_itemsinQuote.
New Enums:
month,week,day,hour, andminutehave been added as new values enumWindowSize.cancel,renew_once,renew, andevergreenhave been added as new values to enum request body parametercontract_term.action_at_term_endincreate_pricing_page_for_existing_subscriptionofPricingPageSession.cancel,renew_once,renew, andevergreenhave been added as new values to enum request body parametercontract_term.action_at_term_endincreate_pricing_page_for_new_subscriptionofPricingPageSession.
v3.18.2
v3.18.2 (2026-02-19)
Bug Fixes:
- corrected the response schema for
add_item_entitlement. - corrected the response schema for
upsert_or_remove_item_entitlements_for_item.
v2.60.1
v2.60.1 (2025-12-30)
Bug Fixes
- Fixed an issue where empty parameters were incorrectly parsed as a JSON string for
Content-Type: application/jsonrequests. They are now correctly handled as an empty JSON object ({}) instead of an empty string.