Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Charges now specify the ID for the dispute associated with a transaction, which can be expanded


Breaking changes

Charges now specify the ID for the dispute associated with a transaction, which can be expanded Breaking changes

What’s new

Updates the dispute property on the Charge object to contain the ID of an associated dispute. Previously, dispute contained the entire Dispute object. You can expand this property when retrieving charges to render the full Dispute object as before.

Impact

This change simplifies the Charge object by replacing the full Dispute object with just its ID in the dispute property. You can now access the full dispute details by expanding the property when retrieving charges, giving you more control over data retrieval.

Changes

FieldChangeFrom → to
Charge. disputeChangedmap(string: string) → expandable($Dispute)

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: 2017-02-14
  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 .
  4. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Last verified 2026-09-24

Is this helpful?