Stripe payment_intent webhook events
Stripe sends 8 PaymentIntent events as a payment progresses. payment_intent.succeeded means the payment completed, and payment_intent.payment_failed means an attempt failed.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
payment_intent.succeeded
documented official schema
payment_intent.succeeded Payment completes successfully
Identified by type field in the body
Resource payment_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1099,
"amount_capturable": 0,
"amount_details": { … },
"amount_received": 0,
"application": null,
"application_fee_amount": null,
"automatic_payment_methods": { … },
"canceled_at": 1234567890,
"cancellation_reason": null,
"capture_method": "automatic",
"id": "pi_1PgafyB7WZ01zgkWSjxsAJo3",
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_intent.succeeded"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pi_1PgafyB7WZ01zgkWSjxsAJo3 |
data.object.status | string | requires_payment_method |
data.object.amount | integer | 1099 |
data.object.canceled_at | integer | 1234567890 |
Full schema: 68 fields.
From Stripe docs
-
Content type
application/json
payment_intent.payment_failed
documented official schema
payment_intent.payment_failed Payment attempt fails
Identified by type field in the body
Resource payment_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1099,
"amount_capturable": 0,
"amount_details": { … },
"amount_received": 0,
"application": null,
"application_fee_amount": null,
"automatic_payment_methods": { … },
"canceled_at": 1234567890,
"cancellation_reason": null,
"capture_method": "automatic",
"id": "pi_1PgafyB7WZ01zgkWSjxsAJo3",
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_intent.payment_failed"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pi_1PgafyB7WZ01zgkWSjxsAJo3 |
data.object.status | string | requires_payment_method |
data.object.amount | integer | 1099 |
data.object.canceled_at | integer | 1234567890 |
Full schema: 68 fields.
From Stripe docs
-
Content type
application/json
payment_intent.amount_capturable_updated
documented official schema
payment_intent.amount_capturable_updated PaymentIntent has funds ready to capture
Identified by type field in the body
Resource payment_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1099,
"amount_capturable": 0,
"amount_details": { … },
"amount_received": 0,
"application": null,
"application_fee_amount": null,
"automatic_payment_methods": { … },
"canceled_at": 1234567890,
"cancellation_reason": null,
"capture_method": "automatic",
"id": "pi_1PgafyB7WZ01zgkWSjxsAJo3",
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_intent.amount_capturable_updated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pi_1PgafyB7WZ01zgkWSjxsAJo3 |
data.object.status | string | requires_payment_method |
data.object.amount | integer | 1099 |
data.object.canceled_at | integer | 1234567890 |
Full schema: 68 fields.
From Stripe docs
-
Content type
application/json
payment_intent.canceled
documented official schema
payment_intent.canceled PaymentIntent canceled
Identified by type field in the body
Resource payment_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1099,
"amount_capturable": 0,
"amount_details": { … },
"amount_received": 0,
"application": null,
"application_fee_amount": null,
"automatic_payment_methods": { … },
"canceled_at": 1234567890,
"cancellation_reason": null,
"capture_method": "automatic",
"id": "pi_1PgafyB7WZ01zgkWSjxsAJo3",
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_intent.canceled"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pi_1PgafyB7WZ01zgkWSjxsAJo3 |
data.object.status | string | requires_payment_method |
data.object.amount | integer | 1099 |
data.object.canceled_at | integer | 1234567890 |
Full schema: 68 fields.
From Stripe docs
-
Content type
application/json
payment_intent.created
documented official schema
payment_intent.created New PaymentIntent created
Identified by type field in the body
Resource payment_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1099,
"amount_capturable": 0,
"amount_details": { … },
"amount_received": 0,
"application": null,
"application_fee_amount": null,
"automatic_payment_methods": { … },
"canceled_at": 1234567890,
"cancellation_reason": null,
"capture_method": "automatic",
"id": "pi_1PgafyB7WZ01zgkWSjxsAJo3",
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_intent.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pi_1PgafyB7WZ01zgkWSjxsAJo3 |
data.object.status | string | requires_payment_method |
data.object.amount | integer | 1099 |
data.object.canceled_at | integer | 1234567890 |
Full schema: 68 fields.
From Stripe docs
-
Content type
application/json
payment_intent.partially_funded
documented official schema
payment_intent.partially_funded Funds applied to a customer balance PaymentIntent, changing the amount remaining
Identified by type field in the body
Resource payment_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1099,
"amount_capturable": 0,
"amount_details": { … },
"amount_received": 0,
"application": null,
"application_fee_amount": null,
"automatic_payment_methods": { … },
"canceled_at": 1234567890,
"cancellation_reason": null,
"capture_method": "automatic",
"id": "pi_1PgafyB7WZ01zgkWSjxsAJo3",
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_intent.partially_funded"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pi_1PgafyB7WZ01zgkWSjxsAJo3 |
data.object.status | string | requires_payment_method |
data.object.amount | integer | 1099 |
data.object.canceled_at | integer | 1234567890 |
Full schema: 68 fields.
From Stripe docs
-
Content type
application/json
payment_intent.processing
documented official schema
payment_intent.processing PaymentIntent starts processing
Identified by type field in the body
Resource payment_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1099,
"amount_capturable": 0,
"amount_details": { … },
"amount_received": 0,
"application": null,
"application_fee_amount": null,
"automatic_payment_methods": { … },
"canceled_at": 1234567890,
"cancellation_reason": null,
"capture_method": "automatic",
"id": "pi_1PgafyB7WZ01zgkWSjxsAJo3",
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_intent.processing"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pi_1PgafyB7WZ01zgkWSjxsAJo3 |
data.object.status | string | requires_payment_method |
data.object.amount | integer | 1099 |
data.object.canceled_at | integer | 1234567890 |
Full schema: 68 fields.
From Stripe docs
-
Content type
application/json
payment_intent.requires_action
documented official schema
payment_intent.requires_action PaymentIntent needs customer action
Identified by type field in the body
Resource payment_intent
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"amount": 1099,
"amount_capturable": 0,
"amount_details": { … },
"amount_received": 0,
"application": null,
"application_fee_amount": null,
"automatic_payment_methods": { … },
"canceled_at": 1234567890,
"cancellation_reason": null,
"capture_method": "automatic",
"id": "pi_1PgafyB7WZ01zgkWSjxsAJo3",
"status": "requires_payment_method"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_intent.requires_action"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pi_1PgafyB7WZ01zgkWSjxsAJo3 |
data.object.status | string | requires_payment_method |
data.object.amount | integer | 1099 |
data.object.canceled_at | integer | 1234567890 |
Full schema: 68 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.