Public preview
Adds the ability to choose how you submit a dispute response Public preview
What’s new
Specify how you plan to submit your response to a dispute by setting the intended_submission_method parameter on a Dispute.
The options for intended_submission_method are:
- manual : You’ll submit the manual packet if you upload evidence and won’t ever use Smart Disputes to respond to the dispute.
- prefer _ manual : You’ll submit the manual packet if you upload evidence, but use Smart Disputes if you have no evidence to add to the dispute response.
- prefer _ smart _ disputes : You’ll let Smart Disputes submit the dispute response if it detects Stripe evidence, but use the manual packet otherwise.
- smart _ disputes : You’ll let Smart Disputes submit the dispute response if it detects Stripe evidence, and won’t use the manual packet.
Impact
Modify a dispute’s intended_submission_method to specify how you plan to submit your response to the dispute. This setting also impacts how Stripe behaves when a dispute reaches its due date. The value defaults to prefer_manual, which matches the timeout behavior prior to adding the new parameter.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| intended_submission_method | Added | Dispute Dispute#update |
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.