Release v3.30.0

[cb-alish]

v3.30.0 (2026-07-30)

New Resources:

• CreditUnit has been added.
• LedgerEntry has been added.

New Actions:

• allocate has been added to LedgerOperation.

New Attributes:

• unit_id has been added to Alert.
• subscription_id has been added to GrantBlock.
• modified_at has been added to GrantBlock.
• resource_version has been added to GrantBlock.
• created_at has been added to LedgerAccountBalance.
• resource_version has been added to LedgerAccountBalance.

New Parameters:

• account_type has been added as query parameter to list_grant_blocks in GrantBlock.
• unit_id has been added as request body parameter to create_an_alert in Alert.
• include_cancellation_day_in_billing has been added as request body parameter to cancel_subscription_for_items_estimate in Estimate.
• subscription_id has been added as request body parameter to allocate in LedgerOperation.
• unit_id has been added as request body parameter to allocate in LedgerOperation.
• amount has been added as request body parameter to allocate in LedgerOperation.
• expires_at has been added as request body parameter to allocate in LedgerOperation.
• metadata has been added as request body parameter to allocate in LedgerOperation.
• include_cancellation_day_in_billing has been added as request body parameter to cancel_subscription_for_items in Subscription.

New Events:

• grant_blocks_created has been added.
• ledger_updated has been added.
• ledger_account_balance_updated has been added.
• grant_blocks_updated has been added.

New Enums:

• ledger_account_balance_updated, grant_blocks_created, grant_blocks_updated, and ledger_updated have been added as new values enum EventType.
• dana, touch_n_go, tamara, and qpay have been added as new values enum PaymentMethod.
• dana, touch_n_go, tamara, and qpay have been added as new values enum PaymentMethodType.
• dana, touch_n_go, tamara, qpay, credit_balance_dropped, credit, debit, hold, and unhold have been added as new values enum Type.
• active and archived have been added as new values to enum attribute status in CreditUnit.
• grant_renewal and subscription_renewed have been added as new values to enum attribute grant_source in GrantBlock.
• provisioned and overdraft have been added as new values to enum attribute account_type in LedgerEntry.
• credit_unit has been added as a new value to enum attribute unit_type in LedgerEntry.
• dana, touch_n_go, tamara, and qpay have been added as new values to enum attribute payment_method_type in PaymentIntent.
• dana, touch_n_go, tamara, and qpay have been added as new values to enum attribute active_payment_attempt.payment_method_type in PaymentIntent.
• archived and active have been added as new values to enum query parameter status.in in list_credit_units of CreditUnit.
• archived and active have been added as new values to enum query parameter status.is in list_credit_units of CreditUnit.
• provisioned and overdraft have been added as new values to enum query parameter account_type.is in list_grant_blocks of GrantBlock.
• dana, touch_n_go, tamara, and qpay have been added as new values to enum request body parameter payment_method_type in update_a_payment_intent of PaymentIntent.
• dana, touch_n_go, tamara, and qpay have been added as new values to enum request body parameter payment_method_type in create_a_payment_intent of PaymentIntent.

Released v3.30.0 with CreditUnit and LedgerEntry resources, ledger allocation support, expanded payment methods and request attributes, new grant-block and ledger webhook events, updated enums and TypeScript typings, and synchronized package, client, and changelog versions.

[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

Changes

Chargebee v3.30.0 API surface

Layer / File(s)	Summary
Release metadata CHANGELOG.md, VERSION, package.json, src/environment.ts	Release metadata and client version are updated to v3.30.0.
Credit-unit and ledger API surface src/resources/api_endpoints.ts, src/schema/credit_unit.schema.ts, src/schema/ledger_operation.schema.ts, types/resources/*	Credit-unit routes and declarations, ledger-entry types, and ledger allocation request/response types are added.
Request schema expansion src/schema/*.schema.ts	Payment methods, webhook events, alert types, cancellation options, grant filters, and related query/body schemas are expanded.
Public resource declarations types/core.d.ts, types/resources/*.d.ts	Exported unions, resource fields, payment inputs, ledger models, and cancellation parameters are updated.
Webhook event contracts src/resources/webhook/*, src/schema/webhook_endpoint.schema.ts, types/resources/WebhookEvent.d.ts, types/resources/Event.d.ts	Four webhook event types and their typed payload mappings are added.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Client
  participant LedgerOperationResource
  participant ChargebeeAPI
  Client->>LedgerOperationResource: allocate(AllocateInputParam)
  LedgerOperationResource->>ChargebeeAPI: POST /ledger_operations/allocate
  ChargebeeAPI-->>LedgerOperationResource: AllocateResponse
  LedgerOperationResource-->>Client: typed ledger operation response

Loading

🚥 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: 2

🤖 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 `@types/core.d.ts`:
- Around line 750-765: Keep TypeEnum resource-specific by removing non-alert
literals from the shared alias used by Alert.type, or introduce a dedicated
alert-type alias and update types/resources/Alert.d.ts to use it. Ensure
Alert.type accepts exactly the values permitted by src/schema/alert.schema.ts,
while preserving unrelated resource-specific enums elsewhere.

In `@types/resources/Event.d.ts`:
- Line 31: Update the Event.content type around GrantBlocksCreatedContent and
the other added payload intersections so unrelated webhook events do not require
every event-specific field. Replace the unconditional & chain with a
discriminated union keyed by the event type, or make those payload fields
optional while preserving required fields for their matching events; apply the
same correction to the related additions.

🪄 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: Pro Plus

Run ID: 54e22f6f-dee8-4716-9add-b7be3a28e0f3

📥 Commits

Reviewing files that changed from the base of the PR and between 080a355 and 1bd87ee.

⛔ Files ignored due to path filters (1)

• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (53)

• CHANGELOG.md
• VERSION
• package.json
• src/environment.ts
• src/resources/api_endpoints.ts
• src/resources/webhook/content.ts
• src/resources/webhook/eventType.ts
• src/schema/alert.schema.ts
• src/schema/coupon.schema.ts
• src/schema/credit_note.schema.ts
• src/schema/credit_unit.schema.ts
• src/schema/customer.schema.ts
• src/schema/entitlement.schema.ts
• src/schema/estimate.schema.ts
• src/schema/event.schema.ts
• src/schema/export.schema.ts
• src/schema/gift.schema.ts
• src/schema/grant_block.schema.ts
• src/schema/index.ts
• src/schema/invoice.schema.ts
• src/schema/item.schema.ts
• src/schema/item_family.schema.ts
• src/schema/item_price.schema.ts
• src/schema/ledger_operation.schema.ts
• src/schema/meter.schema.ts
• src/schema/payment_intent.schema.ts
• src/schema/payment_source.schema.ts
• src/schema/price_variant.schema.ts
• src/schema/purchase.schema.ts
• src/schema/ramp.schema.ts
• src/schema/subscription.schema.ts
• src/schema/transaction.schema.ts
• src/schema/webhook_endpoint.schema.ts
• types/core.d.ts
• types/index.d.ts
• types/resources/Alert.d.ts
• types/resources/AttachedItem.d.ts
• types/resources/Content.d.ts
• types/resources/CreditUnit.d.ts
• types/resources/Customer.d.ts
• types/resources/Estimate.d.ts
• types/resources/Event.d.ts
• types/resources/Gift.d.ts
• types/resources/GrantBlock.d.ts
• types/resources/Invoice.d.ts
• types/resources/LedgerAccountBalance.d.ts
• types/resources/LedgerEntry.d.ts
• types/resources/LedgerOperation.d.ts
• types/resources/PaymentIntent.d.ts
• types/resources/PaymentSource.d.ts
• types/resources/Purchase.d.ts
• types/resources/Subscription.d.ts
• types/resources/WebhookEvent.d.ts