# Adds the ability to specify the intended submission method for Disputes ## What’s new Adds the [intended_submission_method](https://docs.stripe.com/api/disputes/object.md?api-version=2026-10-28.endive#dispute_object-intended_submission_method) property to the [Dispute](https://docs.stripe.com/api/disputes/object.md?api-version=2026-10-28.endive) object and a corresponding parameter to [update a dispute](https://docs.stripe.com/api/disputes/update.md?api-version=2026-10-28.endive). Use `intended_submission_method` to control whether you submit evidence manually or [Smart Disputes](https://docs.stripe.com/disputes/smart-disputes.md) submits a response. Supported values include: - `manual`: You submit any evidence manually. Smart Disputes doesn’t respond to the dispute. - `prefer_manual`: If you provide evidence, you submit it manually. Otherwise, Smart Disputes responds to the dispute. - `prefer_smart_disputes`: If Smart Disputes detects Stripe evidence, it submits the response. Otherwise, you submit evidence manually. - `smart_disputes`: If Smart Disputes detects Stripe evidence, it submits the response. You don’t submit evidence manually. For accounts without access to Smart Disputes, `intended_submission_method` is `null`. ## Impact Set `intended_submission_method` on a [Dispute](https://docs.stripe.com/api/disputes/object.md?api-version=2026-10-28.endive) to control whether you submit evidence manually or [Smart Disputes](https://docs.stripe.com/disputes/smart-disputes.md) submits a response. ## Changes #### REST API | Parameter | Change | Resources or endpoints | | --- | --- | --- | | `intended_submission_method` | Added | [Dispute](/api/disputes/object?api-version=2026-10-28.endive#dispute_object), [Dispute#update](/api/disputes/update?api-version=2026-10-28.endive#update_dispute) | #### Ruby | Parameter | Change | Resources or methods | | --- | --- | --- | | `intended_submission_method` | Added | [Dispute](/api/disputes/object?api-version=2026-10-28.endive#dispute_object), [DisputeUpdateParams](/api/disputes/update?api-version=2026-10-28.endive#update_dispute) | #### Python | Parameter | Change | Resources or methods | | --- | --- | --- | | `intended_submission_method` | Added | [Dispute](/api/disputes/object?api-version=2026-10-28.endive#dispute_object), [DisputeModifyParams](/api/disputes/update?api-version=2026-10-28.endive#update_dispute) | #### PHP | Parameter | Change | Resources or methods | | --- | --- | --- | | `intended_submission_method` | Added | [Dispute](/api/disputes/object?api-version=2026-10-28.endive#dispute_object), [Dispute.update().$params](/api/disputes/update?api-version=2026-10-28.endive#update_dispute) | #### Java | Parameter | Change | Resources or methods | | --- | --- | --- | | `intendedSubmissionMethod` | Added | [Dispute](/api/disputes/object?api-version=2026-10-28.endive#dispute_object), [DisputeUpdateParams](/api/disputes/update?api-version=2026-10-28.endive#update_dispute) | #### Node.js | Parameter | Change | Resources or methods | | --- | --- | --- | | `intended_submission_method` | Added | [Dispute](/api/disputes/object?api-version=2026-10-28.endive#dispute_object), [DisputeUpdateParams](/api/disputes/update?api-version=2026-10-28.endive#update_dispute) | #### Go | Parameter | Change | Resources or methods | | --- | --- | --- | | `IntendedSubmissionMethod` | Added | [Dispute](/api/disputes/object?api-version=2026-10-28.endive#dispute_object), [DisputeParams](/api/disputes/update?api-version=2026-10-28.endive#update_dispute) | #### .NET | Parameter | Change | Resources or methods | | --- | --- | --- | | `IntendedSubmissionMethod` | Added | [Dispute](/api/disputes/object?api-version=2026-10-28.endive#dispute_object), [DisputeUpdateOptions](/api/disputes/update?api-version=2026-10-28.endive#update_dispute) | ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/workbench/guides.md#view-api-versions) 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](https://docs.stripe.com/api-versions.md#how-versions-are-specified-in-requests) to include `Stripe-Version: 2026-10-28.endive` 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Ruby SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Python SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your PHP SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Java SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Node SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your Go SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 2. Upgrade your .NET SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). ## Related changes - [Adds payment intent data configuration when updating Checkout Sessions](https://docs.stripe.com/changelog/endive/2026-10-28/adds-payment-intent-data-configuration-when-updating-checkout-sessions.md) - [Adds Open USD (OUSD) as a supported token currency for crypto payments](https://docs.stripe.com/changelog/endive/2026-10-28/ousd-token-currency.md) - [Adds support for requesting Scalapay Payment Links](https://docs.stripe.com/changelog/endive/2026-10-28/scalapay-payment-method-support-payment-links.md) - [Adds the evidence submission method property to Disputes](https://docs.stripe.com/changelog/endive/2026-10-28/evidence-submission-method-property-disputes.md) - [Adds invoice settings parameters for Checkout Sessions and Payment Links subscriptions](https://docs.stripe.com/changelog/endive/2026-10-28/invoice-settings-parameters-checkout-sessions-payment-links-subscriptions.md) - [Adds support for submitting evidence to appeal dispute decisions](https://docs.stripe.com/changelog/endive/2026-10-28/evidence-submission-appeal-dispute-decisions.md) - [Adds refund reference tracking for Klarna, PayPal, and Afterpay Clearpay](https://docs.stripe.com/changelog/endive/2026-10-28/refund-reference-klarna-paypal-afterpay.md) - [Adds support for specifying card-on-file usage when saving or charging cards](https://docs.stripe.com/changelog/endive/2026-10-28/card-on-file-usage-indicators-support.md) - [Adds RTP and FedNow as US bank transfer network types for cash balance transactions](https://docs.stripe.com/changelog/endive/2026-10-28/rtp-fednow-support-us-bank-transfer-network-types.md) - [Adds webhook events and error messages for the Standalone 3DS API](https://docs.stripe.com/changelog/endive/2026-10-28/standalone-3ds-error-messages-and-webhook-events.md)