Release v2.77.0

[cb-alish]

v2.77.0 (2026-07-21)

New Resources:

• AsyncResponse has been added.
• AsyncResponseList has been added.
• ColumnDefinition has been added.
• Meter has been added.
• MeteredFeature has been added.

New Attributes:

• currency_code has been added to Alert.
• threshold has been added to Alert.
• filter_conditions has been added to Alert.
• exchange_rates has been added to CreditNote.
• metered has been added to Feature.
• exchange_rates has been added to Invoice.
• payment_intent_metadata has been added to PaymentIntent.

New Parameters:

• metered has been added as query parameter to list_features in Feature.
• decommissioned has been added as query parameter to list_subscriptions in Subscription.
• currency_code has been added as request body parameter to create_an_alert in Alert.
• line_items.proration_mode has been added as request body parameter to import_credit_note in CreditNote.
• item_prices.description has been added as request body parameter to create_invoice_for_items_estimate in Estimate.
• item_prices.entity_description has been added as request body parameter to create_invoice_for_items_estimate in Estimate.
• charges.entity_description has been added as request body parameter to create_invoice_for_items_estimate in Estimate.
• subscription.decommissioned has been added as request body parameter to export_subscriptions in Export.
• item_prices.description has been added as request body parameter to create_invoice_for_items_and_one-time_charges in Invoice.
• item_prices.entity_description has been added as request body parameter to create_invoice_for_items_and_one-time_charges in Invoice.
• charges.entity_description has been added as request body parameter to create_invoice_for_items_and_one-time_charges in Invoice.
• create_pending_invoice has been added as request body parameter to create_invoice_for_items_and_one-time_charges in Invoice.
• line_items.proration_mode has been added as request body parameter to import_invoice in Invoice.
• paid_at has been added as request body parameter to import_invoice in Invoice.
• discounts_to_add.quantity has been added as request body parameter to create_a_ramp in Ramp.
• discounts_to_add.quantity has been added as request body parameter to update_a_subscription_ramp in Ramp.
• customer.email has been added as request body parameter to record_a_purchase in RecordedPurchase.
• customer.first_name has been added as request body parameter to record_a_purchase in RecordedPurchase.
• customer.last_name has been added as request body parameter to record_a_purchase in RecordedPurchase.

Parameter Updates:

• metered_feature_id has been changed from required to optional in create_an_alert of Alert.

New Events:

• payment_source_business_entity_changed has been added.

Deleted Attributes:

• start_balance has been removed from LedgerOperation.
• end_balance has been removed from LedgerOperation.

New Enums:

• real_time_payments has been added as a new value enum DunningType.
• payment_source_business_entity_changed has been added as a new value enum EventType.
• paynow, bizum, and promptpay have been added as new values enum PaymentMethod.
• paynow, bizum, and promptpay have been added as new values enum PaymentMethodType.
• active, archived, and deleted have been added as new values enum Status.
• zero_rated, region_non_taxable, product_exempt, high_value_physical_goods, zero_value_item, and tax_not_configured_external_provider have been added as new values enum TaxOverrideReason.
• paynow, bizum, promptpay, simple, compound, and spend_exceeded have been added as new values enum Type.
• success and failed have been added as new values to enum attribute status in AsyncResponse.
• number and string have been added as new values to enum attribute data_type in ColumnDefinition.
• simple and compound have been added as new values to enum attribute type in Meter.
• active, archived, and deleted have been added as new values to enum attribute status in Meter.
• paynow, bizum, and promptpay have been added as new values to enum attribute payment_method_type in PaymentIntent.
• paynow, bizum, and promptpay have been added as new values to enum attribute active_payment_attempt.payment_method_type in PaymentIntent.
• cb_js, components_fields, checkout_v3, paynow_v3, portal_v3, gift_v3, checkout_v4, payment_component, pc_inapp_v4, and pc_fpc_v4 have been added as new values to enum attribute payment_intent_metadata.source in PaymentIntent.
• adjusted_term, service_period_revision, delta, and reset have been added as new values to enum request body parameter line_items.proration_mode in import_credit_note of CreditNote.
• true and false have been added as new values to enum query parameter metered.is in list_features of Feature.
• adjusted_term, service_period_revision, delta, and reset have been added as new values to enum request body parameter line_items.proration_mode in import_invoice of Invoice.
• updated_at, name, created_at, and id have been added as new values to enum query parameter sort_by.asc in list_all_available_meters of Meter.
• updated_at, name, created_at, and id have been added as new values to enum query parameter sort_by.desc in list_all_available_meters of Meter.
• number and string have been added as new values to enum request body parameter column_definitions.data_type in create_a_metered_feature of MeteredFeature.
• paynow, bizum, and promptpay have been added as new values to enum request body parameter payment_method_type in update_a_payment_intent of PaymentIntent.
• paynow, bizum, and promptpay have been added as new values to enum request body parameter payment_method_type in create_a_payment_intent of PaymentIntent.
• true and false have been added as new values to enum query parameter decommissioned.is in list_subscriptions of Subscription.

Releases v2.77.0 with five new resources, metering support, expanded attributes and filtering, proration options, payment method and enum updates, payment intent metadata, a new webhook event, and LedgerOperation field removals. Updates request telemetry wiring across API models and registers the new models and result accessors.

[snyk-io]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues
✅	Licenses	0	0	0	0	0 issues
✅	Code Security	0	0	0	0	0 issues
✅	Secrets	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

[coderabbitai]

Walkthrough

Version 2.77.0 adds asynchronous response, metering, column-definition, and nested resource models; updates result mappings and model attributes; migrates API request metadata arguments across model methods; and updates package loading, manifests, changelog, and version metadata.

Changes

API model and request update

Layer / File(s)	Summary
Release metadata and model loading CHANGELOG.md, VERSION, chargebee.gemspec, lib/chargebee.rb	Release metadata is updated to 2.77.0, and new model files are packaged and required.
Model contracts and result mappings lib/chargebee/models/*, lib/chargebee/result.rb	Async response, metering, column definition, exchange-rate, payment-intent metadata, alert subtype, proration, and other resource attributes are added and wired into result construction.
Request dispatch migration lib/chargebee/models/*	Model API methods replace telemetry keyword arguments with positional resource and operation identifiers while retaining endpoint and request behavior.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

• chargebee/chargebee-ruby#125: Adds the telemetry request metadata that this change migrates to positional arguments.

Suggested reviewers: cb-karthikp

🚥 Pre-merge checks | ✅ 1

✅ Passed checks (1 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

---

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@lib/chargebee/models/async_response.rb`:
- Line 12: Align the AsyncResponse model’s accessors with the singular mapping
used by Result#async_response: expose request_async_api and error alongside the
existing shared fields, and update the corresponding result mapping so nested
request/error values are available through the model API. Add a regression test
covering singular-response access to both fields.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Enterprise

Run ID: e9a762c9-b32a-46b1-be29-bf5c272bc5a3

📥 Commits

Reviewing files that changed from the base of the PR and between 58f0744 and 22819cb.

⛔ Files ignored due to path filters (1)

• Gemfile.lock is excluded by !**/*.lock

📒 Files selected for processing (85)

• CHANGELOG.md
• VERSION
• chargebee.gemspec
• lib/chargebee.rb
• lib/chargebee/models/addon.rb
• lib/chargebee/models/address.rb
• lib/chargebee/models/alert.rb
• lib/chargebee/models/alert_status.rb
• lib/chargebee/models/async_response.rb
• lib/chargebee/models/async_response_list.rb
• lib/chargebee/models/attached_item.rb
• lib/chargebee/models/business_entity.rb
• lib/chargebee/models/card.rb
• lib/chargebee/models/column_definition.rb
• lib/chargebee/models/comment.rb
• lib/chargebee/models/configuration.rb
• lib/chargebee/models/coupon.rb
• lib/chargebee/models/coupon_code.rb
• lib/chargebee/models/coupon_set.rb
• lib/chargebee/models/credit_note.rb
• lib/chargebee/models/credit_note_estimate.rb
• lib/chargebee/models/currency.rb
• lib/chargebee/models/customer.rb
• lib/chargebee/models/customer_entitlement.rb
• lib/chargebee/models/differential_price.rb
• lib/chargebee/models/entitlement.rb
• lib/chargebee/models/entitlement_override.rb
• lib/chargebee/models/estimate.rb
• lib/chargebee/models/event.rb
• lib/chargebee/models/export.rb
• lib/chargebee/models/feature.rb
• lib/chargebee/models/gift.rb
• lib/chargebee/models/grant_block.rb
• lib/chargebee/models/hosted_page.rb
• lib/chargebee/models/in_app_subscription.rb
• lib/chargebee/models/invoice.rb
• lib/chargebee/models/invoice_estimate.rb
• lib/chargebee/models/item.rb
• lib/chargebee/models/item_entitlement.rb
• lib/chargebee/models/item_family.rb
• lib/chargebee/models/item_price.rb
• lib/chargebee/models/ledger_account_balance.rb
• lib/chargebee/models/ledger_operation.rb
• lib/chargebee/models/meter.rb
• lib/chargebee/models/metered_feature.rb
• lib/chargebee/models/non_subscription.rb
• lib/chargebee/models/offer_event.rb
• lib/chargebee/models/offer_fulfillment.rb
• lib/chargebee/models/omnichannel_one_time_order.rb
• lib/chargebee/models/omnichannel_subscription.rb
• lib/chargebee/models/omnichannel_subscription_item.rb
• lib/chargebee/models/order.rb
• lib/chargebee/models/payment_intent.rb
• lib/chargebee/models/payment_schedule_scheme.rb
• lib/chargebee/models/payment_source.rb
• lib/chargebee/models/payment_voucher.rb
• lib/chargebee/models/personalized_offer.rb
• lib/chargebee/models/plan.rb
• lib/chargebee/models/portal_session.rb
• lib/chargebee/models/price_variant.rb
• lib/chargebee/models/pricing_page_session.rb
• lib/chargebee/models/promotional_credit.rb
• lib/chargebee/models/promotional_grant.rb
• lib/chargebee/models/purchase.rb
• lib/chargebee/models/quote.rb
• lib/chargebee/models/quote_line_group.rb
• lib/chargebee/models/quoted_charge.rb
• lib/chargebee/models/ramp.rb
• lib/chargebee/models/recorded_purchase.rb
• lib/chargebee/models/resource_migration.rb
• lib/chargebee/models/rule.rb
• lib/chargebee/models/site_migration_detail.rb
• lib/chargebee/models/subscription.rb
• lib/chargebee/models/subscription_entitlement.rb
• lib/chargebee/models/time_machine.rb
• lib/chargebee/models/transaction.rb
• lib/chargebee/models/unbilled_charge.rb
• lib/chargebee/models/usage.rb
• lib/chargebee/models/usage_charge.rb
• lib/chargebee/models/usage_event.rb
• lib/chargebee/models/usage_file.rb
• lib/chargebee/models/usage_summary.rb
• lib/chargebee/models/virtual_bank_account.rb
• lib/chargebee/models/webhook_endpoint.rb
• lib/chargebee/result.rb