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 payment succeeds

Identified by type field in the body Resource invoice

stripe-invoice-paid.json
{
  "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

Send example to Inspect → View as JSON

invoice.payment_failed

documented official schema

Invoice payment fails

Identified by type field in the body Resource invoice

stripe-invoice-payment-failed.json
{
  "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

Send example to Inspect → View as JSON

invoice.created

verified from a captured delivery

New invoice created

Identified by type field in the body Resource invoice

stripe-invoice-created.json
{
  "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

Send example to Inspect → View as JSON

invoice.deleted

documented official schema

Draft invoice deleted

Identified by type field in the body Resource invoice

stripe-invoice-deleted.json
{
  "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

Send example to Inspect → View as JSON

invoice.finalization_failed

documented official schema

Draft invoice can't be finalized

Identified by type field in the body Resource invoice

stripe-invoice-finalization-failed.json
{
  "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

Send example to Inspect → View as JSON

invoice.finalized

verified from a captured delivery

Draft invoice finalized and now open

Identified by type field in the body Resource invoice

stripe-invoice-finalized.json
{
  "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

Send example to Inspect → View as JSON

invoice.marked_uncollectible

documented official schema

Invoice marked uncollectible

Identified by type field in the body Resource invoice

stripe-invoice-marked-uncollectible.json
{
  "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

Send example to Inspect → View as JSON

invoice.overdue

documented official schema

Invoice past its due date, by the number of days set in Automations

Identified by type field in the body Resource invoice

stripe-invoice-overdue.json
{
  "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

Send example to Inspect → View as JSON

invoice.overpaid

documented official schema

Invoice paid with more than the amount due

Identified by type field in the body Resource invoice

stripe-invoice-overpaid.json
{
  "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

Send example to Inspect → View as JSON

invoice.payment_action_required

documented official schema

Invoice payment needs further action from the customer

Identified by type field in the body Resource invoice

stripe-invoice-payment-action-required.json
{
  "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

Send example to Inspect → View as JSON

invoice.payment_attempt_required

documented official schema

Invoice needs a payment method Stripe can't process

Identified by type field in the body Resource invoice

stripe-invoice-payment-attempt-required.json
{
  "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

Send example to Inspect → View as JSON

invoice.payment_succeeded

verified from a captured delivery

Invoice payment attempt succeeds

Identified by type field in the body Resource invoice

stripe-invoice-payment-succeeded.json
{
  "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

Send example to Inspect → View as JSON

invoice.sent

documented official schema

Invoice email sent

Identified by type field in the body Resource invoice

stripe-invoice-sent.json
{
  "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

Send example to Inspect → View as JSON

invoice.upcoming

documented official schema

Subscription invoice due to be created, ahead of time by your subscription settings

Identified by type field in the body Resource invoice

stripe-invoice-upcoming.json
{
  "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

Send example to Inspect → View as JSON

invoice.updated

documented official schema

Invoice changes, such as its amount

Identified by type field in the body Resource invoice

stripe-invoice-updated.json
{
  "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

Send example to Inspect → View as JSON

invoice.voided

documented official schema

Invoice voided

Identified by type field in the body Resource invoice

stripe-invoice-voided.json
{
  "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

Send example to Inspect → View as JSON

invoice.will_be_due

documented official schema

Invoice about to fall due, ahead of time by the days set in Automations

Identified by type field in the body Resource invoice

stripe-invoice-will-be-due.json
{
  "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

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.