Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Application fees now include a sublist of refunds through the refunds field


Breaking changes

Application fees now include a sublist of refunds through the refunds field Breaking changes

What’s new

Changes the refunds property on the Application Fee object from an array to a sublist object, which contains the data, has_more, and url properties. This makes application fee refunds consistent with charge refunds.

Impact

Changing the refunds property on the Application Fee object from an array to a sublist aligns better with the charge refund structure.

Changes

FieldChangeFrom → to
ApplicationFee. refundsChangednullable(array(string) | apiList($FeeRefund)) → apiList($FeeRefund)

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: 2014-07-26
  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?