billing.invoice_overdue

Wired only to Stripe's invoice.marked_uncollectible signal. Stripe does not send that for every overdue scenario, so gaps are possible. Pair this event with billing.payment_failed and billing.grace_period_warning to cover overdue states reliably.

When this fires

The creator's invoice is marked uncollectible by the payment provider. Coverage is partial — providers do not always send this signal for every overdue scenario.

Required ability

billing:read — token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "billing.invoice_overdue",
  "created_at": "2026-04-18T10:05:00Z",
  "api_version": "2026-05-01",
  "project_id": null,
  "data": {
    "creator_id": "cre_01HX...",
    "invoice_id": "in_1Nxy..",
    "amount": "49.00",
    "currency": "USD",
    "hosted_invoice_url": "https://invoice.stripe.com/.."
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `billing.invoice_overdue` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	null	Always `null` — account-level event.
`data.creator_id`	string ULID	Creator the invoice was addressed to.
`data.invoice_id`	string	Provider invoice id.
`data.amount`	string	Invoice amount in major units of `currency`.
`data.currency`	string	ISO 4217 currency code.
`data.hosted_invoice_url`	string	URL to the provider-hosted invoice page.

Caveats

DEFERRED in practice — coverage depends on Stripe sending invoice.marked_uncollectible. For full coverage of overdue states, listen for billing.payment_failed and billing.grace_period_warning.
The internal cadence command the billing overdue policy drives lockdowns; see billing.account_locked.

billing.payment_failed — typical earlier signal.
billing.grace_period_warning, billing.account_locked — downstream signals.
Billing events overview — back to family overview.