Releases · chargebee/chargebee-php · GitHub

03 Mar 06:25

cb-alish

v4.18.0 Latest

Latest

v4.18.0 (2025-03-03)

PSR-18 / PSR-17 HTTP client injection (backward compatible):

Direct PSR-18 injection: You can now inject a Psr\Http\Client\ClientInterface (PSR-18) directly into ChargebeeClient without implementing the Chargebee-specific HttpClientFactory interface.
Optional PSR-17 factories: When using a PSR-18 client, you may optionally pass RequestFactoryInterface and StreamFactoryInterface (PSR-17). When omitted, php-http/discovery auto-discovers any installed PSR-17 implementation.
New adapter: Chargebee\HttpClient\PsrClientAdapter wraps a PSR-18 client and builds PSR-7 requests using the injected or discovered PSR-17 request/stream factories.
Backward compatibility: The existing HttpClientFactory injection path and the default GuzzleFactory are unchanged.

New dependencies (require):

php-http/discovery ^1.0
psr/http-factory ^1.0

Assets 2

02 Mar 09:51

cb-alish

v4.17.0

v4.17.0 (2026-03-02)

New Resources:

UsageCharge has been added.
UsageSummary has been added.

New Attributes:

free_period has been added to QuotedSubscription.
free_period_unit has been added to QuotedSubscription.

New Parameters:

net_term_days has been added as request body parameter to create_invoice_for_items_and_one-time_charges in Invoice.
contract_term has been added as request body parameter to create_pricing_page_for_existing_subscription in PricingPageSession.
contract_term has been added as request body parameter to create_pricing_page_for_new_subscription in PricingPageSession.
subscription.free_period has been added as request body parameter to create_a_quote_for_a_new_subscription_items in Quote.
subscription.free_period_unit has been added as request body parameter to create_a_quote_for_a_new_subscription_items in Quote.
subscription.free_period has been added as request body parameter to edit_create_subscription_quote_for_items in Quote.
subscription.free_period_unit has been added as request body parameter to edit_create_subscription_quote_for_items in Quote.

New Enums:

month, week, day, hour, and minute have been added as new values enum WindowSize.
cancel, renew_once, renew, and evergreen have been added as new values to enum request body parameter contract_term.action_at_term_end in create_pricing_page_for_existing_subscription of PricingPageSession.
cancel, renew_once, renew, and evergreen have been added as new values to enum request body parameter contract_term.action_at_term_end in create_pricing_page_for_new_subscription of PricingPageSession.

Assets 2

06 Feb 09:33

cb-alish

v4.16.0

v4.16.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.

Assets 2

20 Jan 10:42

cb-alish

v4.15.1

v4.15.1 (2026-01-19)

Regression Bug Fixes:

Fix list fields to accept JSON objects with explicit numeric keys. Reference.

Tests:

Added PHPUnit test case coverage workflow on pull request.
Added tests suits for JsonParamEncoder.

Assets 2

16 Jan 07:01

cb-alish

v4.15.0

v4.15.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.

Assets 2

12 Jan 08:42

cb-alish

v4.14.0

v4.14.0 (2026-01-12)

New Parameters:

invoice_usages has been added to HostedPage#CheckoutExistingForItemsInputParam.

Assets 2

30 Dec 09:17

cb-alish

v4.13.0

v4.13.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.

Assets 2

30 Dec 09:21

cb-alish

v3.51.0

v3.51.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.

Assets 2

15 Dec 08:37

cb-alish

v4.12.1

v4.12.1 (2025-12-15)

Bug Fixes:

Fix empty json attributes arrays being sent incorrectly; now encoder encodes empty json attribute[] as {} using JSON_FORCE_OBJECT.(resolves #115)

Assets 2

26 Nov 09:54

cb-alish

v4.12.0

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.

Assets 2