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
three_d_secure.authentication.canceled 3DS authentication canceled
Identified by type field in the body
Resource three_d_secure
{
"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
three_d_secure.authentication.challenge_started
documented official schema
three_d_secure.authentication.challenge_started 3DS challenge page loaded
Identified by type field in the body
Resource three_d_secure
{
"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
three_d_secure.authentication.errored
documented official schema
three_d_secure.authentication.errored 3DS authentication hits an error
Identified by type field in the body
Resource three_d_secure
{
"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
three_d_secure.authentication.failed
documented official schema
three_d_secure.authentication.failed 3DS authentication fails
Identified by type field in the body
Resource three_d_secure
{
"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
three_d_secure.authentication.requires_challenge
documented official schema
three_d_secure.authentication.requires_challenge 3DS authentication needs a challenge
Identified by type field in the body
Resource three_d_secure
{
"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
three_d_secure.authentication.requires_submission
documented official schema
three_d_secure.authentication.requires_submission 3DS authentication needs submission
Identified by type field in the body
Resource three_d_secure
{
"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
three_d_secure.authentication.succeeded
documented official schema
three_d_secure.authentication.succeeded 3DS authentication succeeds
Identified by type field in the body
Resource three_d_secure
{
"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
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.