invoice.paid

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

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

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

Triggered when an invoice is fully paid. Limited to usage and prepayment invoices. Use this to reconcile your own ledger and mark the invoice as settled.

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.paid 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.paid",
  "context": {
    "invoice": "inv_mi4f0oda6x9m7gcsvjk0ole1",
    "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1"
  }
}

Subscriptions

Invoices

Meter Orders

invoice.paid

Response body parameters