Release notes from killbill

killbill-0.24.16

2025-11-25T11:00:11Z

See git diff for a list of changes.

Bug Fixes

#2150 - Prevent any operation after a subscription has expired
#2159 - NullPointerException while retrieving base plans when there is no catalog
#2168 - Issue in creating multiple subscriptions with price overrides
#2158 - Fix wrong header information in pagination APIs and add relevant indices
killbill/killbill-platform#126 - SSE Logs - Error while closing the output stream in order to commit response

API Changes

N/A

Other Changes

#2146 - Changes for OSSRH migration
killbill/killbill-commons#189 - Improve getPropertiesBySource() Output

Database Migrations

Kill Bill 0.24.16 requires the following database migrations to be executed:

CREATE INDEX idx_accounts_tenant_record ON accounts (tenant_record_id, record_id);
CREATE INDEX idx_account_history_tenant_record ON account_history (tenant_record_id, record_id);

CREATE INDEX idx_invoices_tenant_record ON invoices (tenant_record_id, record_id);
CREATE INDEX idx_invoice_history_tenant_record ON invoice_history (tenant_record_id, record_id);

CREATE INDEX idx_payments_tenant_record ON payments (tenant_record_id, record_id);
CREATE INDEX idx_payment_history_tenant_record ON payment_history (tenant_record_id, record_id);
CREATE INDEX idx_payment_methods_tenant_record ON payment_methods (tenant_record_id, record_id);
CREATE INDEX idx_payment_method_history_tenant_record ON payment_method_history (tenant_record_id, record_id);

CREATE INDEX idx_bundles_tenant_record ON bundles (tenant_record_id, record_id);
CREATE INDEX idx_bundle_history_tenant_record ON bundle_history (tenant_record_id, record_id);

CREATE INDEX idx_custom_fields_tenant_record ON custom_fields (tenant_record_id, record_id);
CREATE INDEX idx_custom_field_history_tenant_record ON custom_field_history (tenant_record_id, record_id);
CREATE INDEX idx_tags_tenant_record ON tags (tenant_record_id, record_id);
CREATE INDEX idx_tag_history_tenant_record ON tag_history (tenant_record_id, record_id);

CREATE INDEX idx_tag_definitions_tenant_record ON tag_definitions (tenant_record_id, record_id);
CREATE INDEX idx_tag_definition_history_tenant_record ON tag_definition_history (tenant_record_id, record_id);

Full Changelog: killbill-0.24.15...killbill-0.24.16

killbill-0.24.15

2025-08-15T04:03:19Z

See git diff for a list of changes.

Bug Fixes

#1829 - Introduce plugin property for payment retries
#2102 - Regression in KillBillJndiLdapRealm
#2066 - Overriding usage price during plan change does not work
#1901 - Incomplete http response from plugin
#2116 - Catalog initialization from plugin leads to lots of contention
#2124 - StandaloneCatalogMapper does not handle well empty catalog
#2129 - IllegalAccessException in CatalogSafetyInitializer
#2133 - Invoice generated incorrectly when a subscription is created on the last day of the month

API Changes

N/A

Other Changes

#2098 - Export extra tables ( The org.killbill.export.extra.tables.prefix property can now be specified to specify additional tables that need to be included as part of account/kpm export)
#2094 - Removed killbill-flyway wrapper and all associated references
#2132 - Use service name to determine if there is a custom formatter
#2144 - created_date index of bus_ext* tables
#2145 - Improved support for showing where each config property comes from/Exposed a method to list properties grouped by their source.
killbill/killbill-platform#145 - Export HealthCheckRegistry as an OSGI service
killbill/killbill-platform#154 - Add configuration to disable queue healthcheck
SSE log Improvements
Ability to export all config properties
Help users to understand where properties are coming from.
The default value of the org.killbill.persistent.bus.${instanceName}.queue.mode property is changed to POLLING.

Full Changelog: killbill-0.24.15...killbill-0.24.13

killbill-0.24.14

2025-07-21T05:10:30Z

[maven-release-plugin] copy for tag killbill-0.24.14

killbill-0.24.13

2025-02-07T13:03:42Z

See git diff for a list of changes.

Bug Fixes

#2071 - Fix bug in usage price override.
#2073 - Fix slow invoice load
#1944 - Issue with catalog plugin API for optional fields
#2083 - Fix for killbill/killbill-aviate-plugin#336 - Add missing entitlement specifiers
#2091 - Infinite loop in some customized alignment scenario
killbill/killbill-platform#167 - Handle server response when downloading plugin properly
killbill/killbill-platform#161 - IllegalStateException : version null cannot be started when installing plugin
killbill/killbill-platform#170 - Additional joda packages to be exported by system bundle

API Changes

N/A

Other Changes

#2082 - Implement new plugin property USAGE_TRANSITIONS for usage plugins

Full Changelog: killbill-0.24.12...killbill-0.24.13

killbill-0.24.12

2025-02-07T04:56:26Z

See git diff for a list of changes.

Bug Fixes

#2057 - Address performance issues in catalog overrides code
#1599 - Race condition during invoice payment and Janitor
#2064 - Strengthen nodes info code

API Changes

N/A

Other Changes

#2014 - Ability to control invoice id

Full Changelog: killbill-0.24.11...killbill-0.24.12

0.24.11

2024-09-09T13:01:01Z

See git diff for a list of changes.

Bug Fixes

#1989 - Invoice plugins not called on commit/void
#1990 - Invoice plugins not called on refund
#1995 - search: allow advanced filters
#1975 - Stream closed for application/x-www-form-urlencoded request
#2005 - Verify behavior of invoicing system with DAILY billing period
#2004 - Relax invoicing rules around additional items received from plugins
#1841 - Create a new ExtBusEventType corresponding to UNDO_CHANGE (Workaround added, ticket still open)
#2017 - When a catalog plugin is used, some pretty name fields are not returned in an invoice
#2000 - Retrieve invoice by number returns incorrect balance for written off invoice
#2038 - Fix error while creating simple plan from Kaui
#1739 - Charged Through Date Not updating for FixedTerm phase
#2044 - Add missing equals() and hashCode() method to DefaultRawUsage
#1930 - Issues with Fixed Term subscriptions showing Active after Expiry
#2048 - Issue with RawUsageRecord comparator
#2033 - Fix equality check for recurring items

API Changes

N/A

Other Changes

KB 0.24.11 has introduced a new behavior as part of the fix for #1739:

End-date for FIXED invoice items - Before KB 0.24.11, invoice items corresponding to TRIAL/FIXEDTERM/DISCOUNT phases had a null end date. So, if a subscription was created corresponding to a plan with a 1-month TRIAL phase on 2024-04-01, the corresponding invoice item would have start_date=2024-04-01 and end_date=NULL. After KB 0.24.11, such invoice items will have an appropriate end date. So, in the example above, the invoice item would have start_date=2024-04-01 and end_date=2024-05-01.
CTD is updated for non-recurring phases - Before KB 0.24.11, the subscription Charged Through Date (CTD) was not updated during the TRIAL, FIXEDTERM, or DISCOUNT phases. It remained set to the subscription's start date. For instance, if a subscription was created on 2024-04-01 with a plan that included a 1-month trial phase, the CTD would remain 2024-04-01 until the TRIAL phase ended. When the phase changed on 2024-05-01, the CTD would then be updated to 2024-06-01. Starting with KB 0.24.11, the CTD is now updated even while the subscription is in the TRIAL, FIXEDTERM, or DISCOUNT phases. Using the same example, during the trial phase, the CTD would be updated to 2024-05-01. After the phase changes on 2024-05-01, the CTD would be updated to 2024-06-01.
Cancellations with EOT policy for subscriptions in TRIAL phase happen at END_OF_TERM - Before KB version 0.24.11, if a subscription was in the TRIAL phase and a cancellation request was made with the END_OF_TERM policy, the cancellation would occur immediately, regardless of the policy. So, if a subscription was created corresponding to a plan with a 1-month TRIAL phase on 2024-04-01, and a cancel request was issued on 2024-04-11 with END_OF_TERM policy, the cancellation would still take place on 2024-04-11. However, starting with version 0.24.11, cancellations made during the TRIAL phase with the END_OF_TERM policy will now occur at the end of the trial phase as intended. Using the same example, the cancellation would now happen on 2024-05-01.

0.24.10

2024-03-18T14:54:37Z

See git diff for a list of changes.

Bug Fixes

killbill/killbill-platform#157 (extra slash in default org.killbill.billing.plugin.kpm.*)

API Changes

N/A

Other Changes

N/A

0.24.9

2024-03-04T05:44:56Z

See git diff for a list of changes.

Bug Fixes

#1951 - Perf issue for computing repair map
#1966 - Discrepancy in the invoice start date for usage items when the account is in PST time zone
#1959 - Inconsistency in catalog endpoints
#1981 - Difference in behavior for UTC and PST account
killbill/killbill-platform#154 - Add configuration to disable queue healthcheck

API Changes

N/A

Other Changes

A new feature has been introduced that allows customizing the data in an HTML invoice via a plugin. See #1972. We provide a sample custom invoice formatter plugin that can be used as the starting point to develop a custom plugin. This feature can be enabled by setting the org.killbill.template.invoiceFormatterFactoryPluginName property. As part of this change, the org.killbill.template.invoiceFormatterFactoryClass property is deleted.
A CI failure started occurring due to an extra / in the sonatype URL. This is addressed in killbill/killbill-platform#156

killbill-0.24.8

2024-02-28T11:33:55Z

[maven-release-plugin] copy for tag killbill-0.24.8

0.24.7

2024-02-06T08:26:00Z

See git diff for a list of changes.

Bug Fixes

#1950 - Perf issue when committing an invoice

API Changes

N/A

Other Changes

Updated versions of some dependencies as follows (see 6e67a2f):

Updated snappy-java to 1.1.10.4
Excluded protobuf dependency from mysql-connector-java
Updated logback to 1.3.14 and slf4j to 2.0.9