Restructures Smart Disputes recommended evidence fieldBreaking changes

What’s new

We’ve changed the structure of the recommended_evidence field to group relevant evidence fields together. You can now identify which evidence fields must be provided together to use Smart Disputes.

Why is this a breaking change?

The previous structure of recommended_evidence was an array of strings. The new structure is an array of arrays containing strings.

Impact

If you are using the recommended_evidence array to determine which evidence to provide for Smart Disputes, you need to update your integration to use the new nested array structure.

Changes

Field	Change	From → to
Dispute.smart_disputes.recommended_evidence	Changed	`string → array(string)`

Upgrade

View your current API version in Workbench.
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: 2025-09-30.preview
Upgrade the API version used for webhook endpoints.
Test your integration against the new version.
If you use Connect, test your Connect integration.
In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.