# Adds webhook events and error messages for the Standalone 3DS API

## What’s new

Adds webhook events and dedicated error codes for the [Standalone 3DS API](https://docs.stripe.com/payments/3d-secure/standalone-3d-secure.md). Stripe sends an event when a [3DS Authentication](https://docs.stripe.com/api/three-d-secure/authentication/object.md?api-version=2026-10-28.endive) changes status, from awaiting submission and the cardholder challenge through a final outcome of succeeded, failed, errored, or canceled. Stripe also sends a separate event when the cardholder loads the challenge page.

Also adds the `three_d_secure_authentication_upstream_error` [error code](https://docs.stripe.com/error-codes.md), which indicates that an authentication partner error prevented Stripe from completing the request. If a card doesn’t support 3DS2, Stripe doesn’t return an error. Instead, the created 3DS Authentication has a `status` of `error` and an `outcome` of `not_supported`.

## Impact

Subscribe to 3DS Authentication events through a [webhook endpoint](https://docs.stripe.com/webhooks.md) or [event destination](https://docs.stripe.com/events/how-events-work.md#event-destinations) instead of polling the object for status changes. For example, wait for `three_d_secure.authentication.succeeded` before authorizing the payment through your PSP.

If the created 3DS Authentication has an `outcome` of `not_supported`, skip authentication because the card doesn’t support 3DS2. Automatically retry requests that return `three_d_secure_authentication_upstream_error`.

## Changes

#### REST API

| Values | Change | Enums |
| --- | --- | --- |
| `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started`, `three_d_secure.authentication.errored`, `three_d_secure.authentication.failed`, `three_d_secure.authentication.requires_challenge`, `three_d_secure.authentication.requires_submission`, `three_d_secure.authentication.succeeded` | Added | [Event.type](/api/events/object?api-version=2026-10-28.endive#event_object-type), [WebhookEndpoint#update.enabled_events](/api/webhook_endpoints/update?api-version=2026-10-28.endive#update_webhook_endpoint-enabled_events), [WebhookEndpoint#create.enabled_events](/api/webhook_endpoints/create?api-version=2026-10-28.endive#create_webhook_endpoint-enabled_events) |

|  | Change | Event type |
| --- | --- | --- |
| `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started`, `three_d_secure.authentication.errored`, `three_d_secure.authentication.failed`, `three_d_secure.authentication.requires_challenge`, `three_d_secure.authentication.requires_submission`, `three_d_secure.authentication.succeeded` | Added | `ThreeDSecure.Authentication` |

| Codes | Change |  |
| --- | --- | --- |
| `three_d_secure_authentication_not_supported`, `three_d_secure_authentication_upstream_error` | Added | `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, `StripeError`, `Terminal.Reader.action.api_error` |

#### Ruby

This change doesn’t affect the Ruby SDK.

#### Python

| Values | Change | Enums |
| --- | --- | --- |
| `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started`, `three_d_secure.authentication.errored`, `three_d_secure.authentication.failed`, `three_d_secure.authentication.requires_challenge`, `three_d_secure.authentication.requires_submission`, `three_d_secure.authentication.succeeded` | Added | [Event.type](/api/events/object?api-version=2026-10-28.endive#event_object-type), [WebhookEndpointModifyParams.enabled_events](/api/webhook_endpoints/update?api-version=2026-10-28.endive#update_webhook_endpoint-enabled_events), [WebhookEndpointCreateParams.enabled_events](/api/webhook_endpoints/create?api-version=2026-10-28.endive#create_webhook_endpoint-enabled_events) |

|  | Change | Event type |
| --- | --- | --- |
| `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started`, `three_d_secure.authentication.errored`, `three_d_secure.authentication.failed`, `three_d_secure.authentication.requires_challenge`, `three_d_secure.authentication.requires_submission`, `three_d_secure.authentication.succeeded` | Added | `three_d_secure.Authentication` |

| Codes | Change |  |
| --- | --- | --- |
| `three_d_secure_authentication_not_supported`, `three_d_secure_authentication_upstream_error` | Added | `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, `StripeError`, `Terminal.Reader.Action.ApiError` |

#### PHP

| Values | Change | Enum |
| --- | --- | --- |
| `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started`, `three_d_secure.authentication.errored`, `three_d_secure.authentication.failed`, `three_d_secure.authentication.requires_challenge`, `three_d_secure.authentication.requires_submission`, `three_d_secure.authentication.succeeded` | Added | [Event.type](/api/events/object?api-version=2026-10-28.endive#event_object-type) |

|  | Change | Event type |
| --- | --- | --- |
| `THREE_D_SECURE_AUTHENTICATION_CANCELED`, `THREE_D_SECURE_AUTHENTICATION_CHALLENGE_STARTED`, `THREE_D_SECURE_AUTHENTICATION_ERRORED`, `THREE_D_SECURE_AUTHENTICATION_FAILED`, `THREE_D_SECURE_AUTHENTICATION_REQUIRES_CHALLENGE`, `THREE_D_SECURE_AUTHENTICATION_REQUIRES_SUBMISSION`, `THREE_D_SECURE_AUTHENTICATION_SUCCEEDED` | Added | `ThreeDSecure.Authentication` |

| Codes | Change |  |
| --- | --- | --- |
| `three_d_secure_authentication_not_supported`, `three_d_secure_authentication_upstream_error` | Added | `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, `StripeError`, `Terminal.Reader.action.api_error` |

#### Java

| Values | Change | Enums |
| --- | --- | --- |
| `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started`, `three_d_secure.authentication.errored`, `three_d_secure.authentication.failed`, `three_d_secure.authentication.requires_challenge`, `three_d_secure.authentication.requires_submission`, `three_d_secure.authentication.succeeded` | Added | [WebhookEndpointUpdateParams.enabledEvents](/api/webhook_endpoints/update?api-version=2026-10-28.endive#update_webhook_endpoint-enabled_events), [WebhookEndpointCreateParams.enabledEvents](/api/webhook_endpoints/create?api-version=2026-10-28.endive#create_webhook_endpoint-enabled_events) |

|  | Change | Event type |
| --- | --- | --- |
| `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started`, `three_d_secure.authentication.errored`, `three_d_secure.authentication.failed`, `three_d_secure.authentication.requires_challenge`, `three_d_secure.authentication.requires_submission`, `three_d_secure.authentication.succeeded` | Added | `threedsecure.Authentication` |

#### Node.js

| Values | Change | Enums |
| --- | --- | --- |
| `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started`, `three_d_secure.authentication.errored`, `three_d_secure.authentication.failed`, `three_d_secure.authentication.requires_challenge`, `three_d_secure.authentication.requires_submission`, `three_d_secure.authentication.succeeded` | Added | [Event.type](/api/events/object?api-version=2026-10-28.endive#event_object-type), [WebhookEndpointUpdateParams.enabled_events](/api/webhook_endpoints/update?api-version=2026-10-28.endive#update_webhook_endpoint-enabled_events), [WebhookEndpointCreateParams.enabled_events](/api/webhook_endpoints/create?api-version=2026-10-28.endive#create_webhook_endpoint-enabled_events) |

|  | Change | Event type |
| --- | --- | --- |
| `ThreeDSecureAuthenticationCanceledEvent`, `ThreeDSecureAuthenticationChallengeStartedEvent`, `ThreeDSecureAuthenticationErroredEvent`, `ThreeDSecureAuthenticationFailedEvent`, `ThreeDSecureAuthenticationRequiresChallengeEvent`, `ThreeDSecureAuthenticationRequiresSubmissionEvent`, `ThreeDSecureAuthenticationSucceededEvent` | Added | `ThreeDSecure.Authentication` |

| Codes | Change |  |
| --- | --- | --- |
| `three_d_secure_authentication_not_supported`, `three_d_secure_authentication_upstream_error` | Added | `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, `StripeError`, `Terminal.Reader.action.api_error` |

#### Go

| Values | Change | Enum |
| --- | --- | --- |
| `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started`, `three_d_secure.authentication.errored`, `three_d_secure.authentication.failed`, `three_d_secure.authentication.requires_challenge`, `three_d_secure.authentication.requires_submission`, `three_d_secure.authentication.succeeded` | Added | [Event.Type](/api/events/object?api-version=2026-10-28.endive#event_object-type) |

|  | Change | Event type |
| --- | --- | --- |
| `EventTypeThreeDSecureAuthenticationCanceled`, `EventTypeThreeDSecureAuthenticationChallengeStarted`, `EventTypeThreeDSecureAuthenticationErrored`, `EventTypeThreeDSecureAuthenticationFailed`, `EventTypeThreeDSecureAuthenticationRequiresChallenge`, `EventTypeThreeDSecureAuthenticationRequiresSubmission`, `EventTypeThreeDSecureAuthenticationSucceeded` | Added | `ThreeDSecureAuthentication` |

| Codes | Change |  |
| --- | --- | --- |
| `three_d_secure_authentication_not_supported`, `three_d_secure_authentication_upstream_error` | Added | `Error`, `InvoiceLastFinalizationError`, `PaymentIntentLastPaymentError`, `SetupAttemptSetupError`, `SetupIntentLastSetupError`, `StripeError`, `TerminalReaderActionApiError` |

#### .NET

|  | Change | Event type |
| --- | --- | --- |
| `ThreeDSecureAuthenticationCanceled`, `ThreeDSecureAuthenticationChallengeStarted`, `ThreeDSecureAuthenticationErrored`, `ThreeDSecureAuthenticationFailed`, `ThreeDSecureAuthenticationRequiresChallenge`, `ThreeDSecureAuthenticationRequiresSubmission`, `ThreeDSecureAuthenticationSucceeded` | Added | `ThreeDSecure.Authentication` |

## 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 the ability to specify the intended submission method for Disputes](https://docs.stripe.com/changelog/endive/2026-10-28/adds-intended-submission-method-for-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 validation for Smart Disputes availability when submitting a dispute](https://docs.stripe.com/changelog/endive/2026-10-28/smart-disputes-availability-validation.md)
