Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

5282 articles

Charges now specify the ID for the rule blocking a transaction, which can be expanded


Breaking changes

Charges now specify the ID for the rule blocking a transaction, which can be expanded Breaking changes

What’s new

Updates the outcome[rule] property on the Charge object to contain the ID of the rule that blocked the charge. Previously, outcome[rule] contained the entire Rule object. You can expand this property when retrieving charges to render the full Rule object as before.

Impact

The Charge object outcome[rule] and dispute properties now contain IDs instead of full objects, supporting expandable fields.

Changes

ChangeResource
AddedRuleset
FieldsChangeFrom → to
Charge. outcome. ruleChangednullable(map(string: string)) → expandable($Radar.Rule)
Charge. outcome. rulesetChangednullable(map(string: string)) → expandable($Ruleset)

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 .

Learn more about Stripe API upgrades.

Last verified 2026-09-25

Is this helpful?