Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

5282 articles

The Charges object no longer auto-expands refunds by default


Breaking changes

The Charges object no longer auto-expands refunds by default Breaking changes

What’s new

The Charge object no longer auto-expands refunds. While you can manually expand refunds, Stripe recommends against it for performance reasons.

Impact

This change improves API response times and reduces data transfer, but might require updates to existing code that relied on automatically expanded refund information.

Changes

FieldChangeFrom → to
Charge. refundsChangedapiList($Refund) → nullable(apiList($Refund))

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
  • If you don’t use an SDK, update your API requests to include Stripe-Version: 2022-11-15
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .

Learn more about Stripe API upgrades.

Last verified 2026-09-25

Is this helpful?