invoice.payment_failed

{
  "id": "evt_mi4f0oda6x9m7gcsvjk0ole1",
  "timestamp": "2026-01-15T10:30:00.000Z",
  "topic": "invoice.payment_failed",
  "context": {
    "invoice": "inv_mi4f0oda6x9m7gcsvjk0ole1",
    "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1"
  }
}

Available from API version 2026-05-27.curie onwards.

Triggered when a payment attempt against an invoice fails (e.g. SEPA rejection, insufficient funds). Limited to usage and prepayment invoices. Fires once per failed payment attempt; a single invoice may emit this event multiple times if Nomos retries collection. Use invoice.uncollectible to detect the terminal failure after dunning is exhausted.

Response body parameters

string

required

Unique event identifier (starts with evt_).

string

required

ISO 8601 timestamp when the event was created.

literal

required

Always invoice.payment_failed for this event.

object

required

Event-specific data containing related resource IDs.

Hide properties

string

required

ID of the related invoice (starts with inv_).

string

required

ID of the related subscription (starts with sub_).Fetch the full record via GET /subscriptions/{id}.

{
  "id": "evt_mi4f0oda6x9m7gcsvjk0ole1",
  "timestamp": "2026-01-15T10:30:00.000Z",
  "topic": "invoice.payment_failed",
  "context": {
    "invoice": "inv_mi4f0oda6x9m7gcsvjk0ole1",
    "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1"
  }
}

Subscriptions

Invoices

Meter Orders

invoice.payment_failed

Response body parameters

​Response body parameters

Response body parameters