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 →

three_d_secure.authentication.canceled

documented official schema

3DS authentication canceled

Identified by type field in the body Resource three_d_secure

stripe-three-d-secure-authentication-canceled.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"
}

Key fields

Field Type Example
data.object.id string obj_123
data.object.status string canceled
data.object.created integer 1028554472

Full schema: 45 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

three_d_secure.authentication.challenge_started

documented official schema

3DS challenge page loaded

Identified by type field in the body Resource three_d_secure

stripe-three-d-secure-authentication-challenge-started.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"
}

Key fields

Field Type Example
data.object.id string obj_123
data.object.status string canceled
data.object.created integer 1028554472

Full schema: 45 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

three_d_secure.authentication.errored

documented official schema

3DS authentication hits an error

Identified by type field in the body Resource three_d_secure

stripe-three-d-secure-authentication-errored.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"
}

Key fields

Field Type Example
data.object.id string obj_123
data.object.status string canceled
data.object.created integer 1028554472

Full schema: 45 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

three_d_secure.authentication.failed

documented official schema

3DS authentication fails

Identified by type field in the body Resource three_d_secure

stripe-three-d-secure-authentication-failed.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"
}

Key fields

Field Type Example
data.object.id string obj_123
data.object.status string canceled
data.object.created integer 1028554472

Full schema: 45 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

three_d_secure.authentication.requires_challenge

documented official schema

3DS authentication needs a challenge

Identified by type field in the body Resource three_d_secure

stripe-three-d-secure-authentication-requires-challenge.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"
}

Key fields

Field Type Example
data.object.id string obj_123
data.object.status string canceled
data.object.created integer 1028554472

Full schema: 45 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

three_d_secure.authentication.requires_submission

documented official schema

3DS authentication needs submission

Identified by type field in the body Resource three_d_secure

stripe-three-d-secure-authentication-requires-submission.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"
}

Key fields

Field Type Example
data.object.id string obj_123
data.object.status string canceled
data.object.created integer 1028554472

Full schema: 45 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

three_d_secure.authentication.succeeded

documented official schema

3DS authentication succeeds

Identified by type field in the body Resource three_d_secure

stripe-three-d-secure-authentication-succeeded.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"
}

Key fields

Field Type Example
data.object.id string obj_123
data.object.status string canceled
data.object.created integer 1028554472

Full schema: 45 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

Route Stripe events by type.

Event Gateway receives every Stripe delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Stripe. Facts are compiled from public sources and linked inline.