Skip to main content
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

​
id
string
required
Unique event identifier (starts with evt_).
​
timestamp
string
required
ISO 8601 timestamp when the event was created.
​
topic
literal
required
Always invoice.payment_failed for this event.
​
context
object
required
Event-specific data containing related resource IDs.
{
  "id": "evt_abc123def456ghi789jkl012",
  "timestamp": "2026-01-15T10:30:00.000Z",
  "topic": "invoice.payment_failed",
  "context": {
    "invoice": "inv_abc123def456ghi789jkl012"
  }
}