Stripe payment_method webhook events
Stripe sends 4 payment_method events, including payment_method.attached, payment_method.automatically_updated and payment_method.detached.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
payment_method.attached
verified from a captured delivery
payment_method.attached Payment method attached to a customer
Identified by type field in the body
Resource payment_method
{
"id": "evt_1MhUT6E0b6fckueSb5uPJGPA",
"object": "event",
"api_version": "2022-11-15",
"created": 1677833998,
"data": {
"object": {
"id": "pm_1MhUT1E0b6fckueSV6KgiBFn",
"object": "payment_method",
"billing_details": { … },
"card": { … },
"created": 1677833996,
"customer": "cus_NSPHp4fOlXGw8P",
"livemode": false,
"metadata": { … },
"type": "card"
}
},
"livemode": false,
"pending_webhooks": 3,
"request": { … },
"type": "payment_method.attached"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pm_1MhUT1E0b6fckueSV6KgiBFn |
data.object.type | string | card |
data.object.customer | string | cus_NSPHp4fOlXGw8P |
data.object.created | integer | 1677833996 |
Full schema: 50 fields.
Seen in a captured delivery
-
Content type
application/json; charset=utf-8 -
API version
2022-11-15 -
Headers
user-agent,content-type
payment_method.automatically_updated
documented official schema
payment_method.automatically_updated Card network updates a payment method's details
Identified by type field in the body
Resource payment_method
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"allow_redisplay": "unspecified",
"billing_details": { … },
"card": { … },
"created": 1234567890,
"customer": null,
"id": "pm_1Pgc75B7WZ01zgkWlHVgdEGJ",
"livemode": false,
"metadata": { … },
"object": "payment_method",
"type": "card",
"customer_account": null
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_method.automatically_updated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pm_1Pgc75B7WZ01zgkWlHVgdEGJ |
data.object.type | string | card |
data.object.created | integer | 1234567890 |
Full schema: 62 fields.
From Stripe docs
-
Content type
application/json
payment_method.detached
documented official schema
payment_method.detached Payment method detached from a customer
Identified by type field in the body
Resource payment_method
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"allow_redisplay": "unspecified",
"billing_details": { … },
"card": { … },
"created": 1234567890,
"customer": null,
"id": "pm_1Pgc75B7WZ01zgkWlHVgdEGJ",
"livemode": false,
"metadata": { … },
"object": "payment_method",
"type": "card",
"customer_account": null
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_method.detached"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pm_1Pgc75B7WZ01zgkWlHVgdEGJ |
data.object.type | string | card |
data.object.created | integer | 1234567890 |
Full schema: 62 fields.
From Stripe docs
-
Content type
application/json
payment_method.updated
documented official schema
payment_method.updated Payment method changed through the API
Identified by type field in the body
Resource payment_method
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"allow_redisplay": "unspecified",
"billing_details": { … },
"card": { … },
"created": 1234567890,
"customer": null,
"id": "pm_1Pgc75B7WZ01zgkWlHVgdEGJ",
"livemode": false,
"metadata": { … },
"object": "payment_method",
"type": "card",
"customer_account": null
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "payment_method.updated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | pm_1Pgc75B7WZ01zgkWlHVgdEGJ |
data.object.type | string | card |
data.object.created | integer | 1234567890 |
Full schema: 62 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.