- Breaking changes
- Public preview
Restructures Smart Disputes recommended evidence field Breaking changes Public preview
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.