# Stripe three_d_secure webhook events

Stripe sends 7 three_d_secure events, including `three_d_secure.authentication.canceled`, `three_d_secure.authentication.challenge_started` and `three_d_secure.authentication.errored`. Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/stripe/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill stripe-webhooks` ([details](https://hookdeck.com/webhooks/stripe/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Stripe's official docs](https://docs.stripe.com/event-destinations).

[Overview](https://hookdeck.com/webhooks/stripe) · [Webhook events (246)](https://hookdeck.com/webhooks/stripe/events) · [MCP events](https://hookdeck.com/webhooks/stripe/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/stripe/verify) · [Production guide](https://hookdeck.com/webhooks/stripe/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/stripe/skill)

## three_d_secure.authentication.canceled

Confidence: documented · Schema: official schema

3DS authentication canceled

Identified by: type field in the body · Object: `three_d_secure`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "object": "three_d_secure.authentication",
      "channel": { … },
      "created": 1028554472,
      "directory_server": "american_express",
      "id": "obj_123",
      "livemode": true,
      "message_category": "non_payment_authentication",
      "metadata": null,
      "payment_method": { … },
      "status": "canceled",
      "acquirer_details": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "three_d_secure.authentication.canceled"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-canceled.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.status` | string | `canceled` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-canceled.json)

## three_d_secure.authentication.challenge_started

Confidence: documented · Schema: official schema

3DS challenge page loaded

Identified by: type field in the body · Object: `three_d_secure`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "object": "three_d_secure.authentication",
      "channel": { … },
      "created": 1028554472,
      "directory_server": "american_express",
      "id": "obj_123",
      "livemode": true,
      "message_category": "non_payment_authentication",
      "metadata": null,
      "payment_method": { … },
      "status": "canceled",
      "acquirer_details": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "three_d_secure.authentication.challenge_started"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-challenge-started.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.status` | string | `canceled` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-challenge-started.json)

## three_d_secure.authentication.errored

Confidence: documented · Schema: official schema

3DS authentication hits an error

Identified by: type field in the body · Object: `three_d_secure`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "object": "three_d_secure.authentication",
      "channel": { … },
      "created": 1028554472,
      "directory_server": "american_express",
      "id": "obj_123",
      "livemode": true,
      "message_category": "non_payment_authentication",
      "metadata": null,
      "payment_method": { … },
      "status": "canceled",
      "acquirer_details": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "three_d_secure.authentication.errored"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-errored.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.status` | string | `canceled` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-errored.json)

## three_d_secure.authentication.failed

Confidence: documented · Schema: official schema

3DS authentication fails

Identified by: type field in the body · Object: `three_d_secure`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "object": "three_d_secure.authentication",
      "channel": { … },
      "created": 1028554472,
      "directory_server": "american_express",
      "id": "obj_123",
      "livemode": true,
      "message_category": "non_payment_authentication",
      "metadata": null,
      "payment_method": { … },
      "status": "canceled",
      "acquirer_details": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "three_d_secure.authentication.failed"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-failed.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.status` | string | `canceled` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-failed.json)

## three_d_secure.authentication.requires_challenge

Confidence: documented · Schema: official schema

3DS authentication needs a challenge

Identified by: type field in the body · Object: `three_d_secure`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "object": "three_d_secure.authentication",
      "channel": { … },
      "created": 1028554472,
      "directory_server": "american_express",
      "id": "obj_123",
      "livemode": true,
      "message_category": "non_payment_authentication",
      "metadata": null,
      "payment_method": { … },
      "status": "canceled",
      "acquirer_details": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "three_d_secure.authentication.requires_challenge"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-requires-challenge.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.status` | string | `canceled` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-requires-challenge.json)

## three_d_secure.authentication.requires_submission

Confidence: documented · Schema: official schema

3DS authentication needs submission

Identified by: type field in the body · Object: `three_d_secure`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "object": "three_d_secure.authentication",
      "channel": { … },
      "created": 1028554472,
      "directory_server": "american_express",
      "id": "obj_123",
      "livemode": true,
      "message_category": "non_payment_authentication",
      "metadata": null,
      "payment_method": { … },
      "status": "canceled",
      "acquirer_details": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "three_d_secure.authentication.requires_submission"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-requires-submission.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.status` | string | `canceled` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-requires-submission.json)

## three_d_secure.authentication.succeeded

Confidence: documented · Schema: official schema

3DS authentication succeeds

Identified by: type field in the body · Object: `three_d_secure`

```json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "object": "three_d_secure.authentication",
      "channel": { … },
      "created": 1028554472,
      "directory_server": "american_express",
      "id": "obj_123",
      "livemode": true,
      "message_category": "non_payment_authentication",
      "metadata": null,
      "payment_method": { … },
      "status": "canceled",
      "acquirer_details": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "three_d_secure.authentication.succeeded"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-succeeded.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `obj_123` |
| `data.object.status` | string | `canceled` |
| `data.object.created` | integer | `1028554472` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/three-d-secure-authentication-succeeded.json)

---

Not affiliated with Stripe. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/stripe.json) · [Report a correction](https://hookdeck.com/contact)
