Stripe invoice webhook events
Stripe sends 17 invoice events across an invoice's life, from invoice.created to invoice.voided. invoice.paid is the usual signal that a payment went through.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
invoice.paid
verified from a captured delivery
invoice.paid Invoice payment succeeds
Identified by type field in the body
Resource invoice
{
"id": "evt_1MhUT7E0b6fckueShdwYrsWN",
"object": "event",
"api_version": "2022-11-15",
"created": 1677833999,
"data": {
"object": {
"id": "in_1MhUT5E0b6fckueSfPlY05Fw",
"object": "invoice",
"account_country": "US",
"account_name": "Example Company",
"account_tax_ids": null,
"amount_due": 0,
"amount_paid": 0,
"amount_remaining": 0,
"amount_shipping": 0,
"application": null,
"created": 1677833999,
"customer": "cus_NSPHp4fOlXGw8P",
"status": "paid"
}
},
"livemode": false,
"pending_webhooks": 4,
"request": { … },
"type": "invoice.paid"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1MhUT5E0b6fckueSfPlY05Fw |
data.object.status | string | paid |
data.object.amount_due | integer | 0 |
data.object.customer | string | cus_NSPHp4fOlXGw8P |
data.object.created | integer | 1677833999 |
Full schema: 174 fields.
Seen in a captured delivery
-
Content type
application/json; charset=utf-8 -
API version
2022-11-15 -
Headers
user-agent,content-type
invoice.payment_failed
documented official schema
invoice.payment_failed Invoice payment fails
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.payment_failed"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.created
verified from a captured delivery
invoice.created New invoice created
Identified by type field in the body
Resource invoice
{
"id": "evt_1MhUT7E0b6fckueStwy86nfu",
"object": "event",
"api_version": "2022-11-15",
"created": 1677833999,
"data": {
"object": {
"id": "in_1MhUT5E0b6fckueSfPlY05Fw",
"object": "invoice",
"account_country": "US",
"account_name": "Example Company",
"account_tax_ids": null,
"amount_due": 0,
"amount_paid": 0,
"amount_remaining": 0,
"amount_shipping": 0,
"application": null,
"created": 1677833999,
"customer": "cus_NSPHp4fOlXGw8P",
"status": "paid"
}
},
"livemode": false,
"pending_webhooks": 5,
"request": { … },
"type": "invoice.created"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1MhUT5E0b6fckueSfPlY05Fw |
data.object.status | string | paid |
data.object.amount_due | integer | 0 |
data.object.customer | string | cus_NSPHp4fOlXGw8P |
data.object.created | integer | 1677833999 |
Full schema: 174 fields.
Seen in a captured delivery
-
Content type
application/json; charset=utf-8 -
API version
2022-11-15 -
Headers
user-agent,content-type
invoice.deleted
documented official schema
invoice.deleted Draft invoice deleted
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.deleted"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.finalization_failed
documented official schema
invoice.finalization_failed Draft invoice can't be finalized
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.finalization_failed"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.finalized
verified from a captured delivery
invoice.finalized Draft invoice finalized and now open
Identified by type field in the body
Resource invoice
{
"id": "evt_1MhUT7E0b6fckueS9G2IKvN4",
"object": "event",
"api_version": "2022-11-15",
"created": 1677833999,
"data": {
"object": {
"id": "in_1MhUT5E0b6fckueSfPlY05Fw",
"object": "invoice",
"account_country": "US",
"account_name": "Example Company",
"account_tax_ids": null,
"amount_due": 0,
"amount_paid": 0,
"amount_remaining": 0,
"amount_shipping": 0,
"application": null,
"created": 1677833999,
"customer": "cus_NSPHp4fOlXGw8P",
"status": "paid"
}
},
"livemode": false,
"pending_webhooks": 4,
"request": { … },
"type": "invoice.finalized"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1MhUT5E0b6fckueSfPlY05Fw |
data.object.status | string | paid |
data.object.amount_due | integer | 0 |
data.object.customer | string | cus_NSPHp4fOlXGw8P |
data.object.created | integer | 1677833999 |
Full schema: 174 fields.
Seen in a captured delivery
-
Content type
application/json; charset=utf-8 -
API version
2022-11-15 -
Headers
user-agent,content-type
invoice.marked_uncollectible
documented official schema
invoice.marked_uncollectible Invoice marked uncollectible
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.marked_uncollectible"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.overdue
documented official schema
invoice.overdue Invoice past its due date, by the number of days set in Automations
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.overdue"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.overpaid
documented official schema
invoice.overpaid Invoice paid with more than the amount due
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.overpaid"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.payment_action_required
documented official schema
invoice.payment_action_required Invoice payment needs further action from the customer
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.payment_action_required"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.payment_attempt_required
documented official schema
invoice.payment_attempt_required Invoice needs a payment method Stripe can't process
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.payment_attempt_required"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.payment_succeeded
verified from a captured delivery
invoice.payment_succeeded Invoice payment attempt succeeds
Identified by type field in the body
Resource invoice
{
"id": "evt_1MhUT7E0b6fckueSTtEJC9R4",
"object": "event",
"api_version": "2022-11-15",
"created": 1677833999,
"data": {
"object": {
"id": "in_1MhUT5E0b6fckueSfPlY05Fw",
"object": "invoice",
"account_country": "US",
"account_name": "Example Company",
"account_tax_ids": null,
"amount_due": 0,
"amount_paid": 0,
"amount_remaining": 0,
"amount_shipping": 0,
"application": null,
"created": 1677833999,
"customer": "cus_NSPHp4fOlXGw8P",
"status": "paid"
}
},
"livemode": false,
"pending_webhooks": 5,
"request": { … },
"type": "invoice.payment_succeeded"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1MhUT5E0b6fckueSfPlY05Fw |
data.object.status | string | paid |
data.object.amount_due | integer | 0 |
data.object.customer | string | cus_NSPHp4fOlXGw8P |
data.object.created | integer | 1677833999 |
Full schema: 174 fields.
Seen in a captured delivery
-
Content type
application/json; charset=utf-8 -
API version
2022-11-15 -
Headers
user-agent,content-type
invoice.sent
documented official schema
invoice.sent Invoice email sent
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.sent"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.upcoming
documented official schema
invoice.upcoming Subscription invoice due to be created, ahead of time by your subscription settings
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.upcoming"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.updated
documented official schema
invoice.updated Invoice changes, such as its amount
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.updated"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.voided
documented official schema
invoice.voided Invoice voided
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.voided"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 fields.
From Stripe docs
-
Content type
application/json
invoice.will_be_due
documented official schema
invoice.will_be_due Invoice about to fall due, ahead of time by the days set in Automations
Identified by type field in the body
Resource invoice
{
"api_version": "2026-10-28.endive",
"created": 1234567890,
"data": {
"object": {
"account_country": "US",
"account_name": null,
"account_tax_ids": null,
"amount_due": 1000,
"amount_paid": 0,
"amount_paid_off_stripe": 0,
"amount_remaining": 1000,
"amount_shipping": 0,
"application": null,
"created": 1234567890,
"customer": "cus_QXg1o8vcGmoR32",
"id": "in_1Pgc6tB7WZ01zgkWu9fdqL6I",
"status": "draft"
}
},
"id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
"livemode": false,
"object": "event",
"pending_webhooks": 0,
"request": { … },
"type": "invoice.will_be_due"
} Key fields
| Field | Type | Example |
|---|---|---|
data.object.id | string | in_1Pgc6tB7WZ01zgkWu9fdqL6I |
data.object.status | string | draft |
data.object.amount_due | integer | 1000 |
data.object.customer | string | cus_QXg1o8vcGmoR32 |
data.object.created | integer | 1234567890 |
Full schema: 190 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.