Breaking changes
Disputes now include an evidence_details object for evidence documentation Breaking changes
What’s new
Updates the Dispute object so evidence can be provided as a hash of typed fields rather than a single block of text. Replaces the evidence_due_by property with the evidence_details hash, which includes due_by and submission_count for the number of times a dispute has been submitted.
Impact
Updating the Dispute object to accept structured evidence gives you more detailed evidence submission information.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| evidence | Added | Dispute#update |
| Fields | Change | From → to |
| Dispute. evidence | Changed | nullable(string) → DisputeEvidence |
| Dispute. evidence_details | Changed | nullable(map(string: string)) → DisputeEvidenceDetails |
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: 2014-12-08
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.