LuniPay Docs

API Reference

Events

Events are the immutable, append-only log of everything that happens in your account. Every webhook delivery is a rendering of an event — you can also query them directly for reconciliation or replay.

Events are never mutated after write, so they are safe to cache, index, and replay. Each event carries a full snapshot of the resource at the time the event fired, so you never need to GET the resource to understand what changed. Retained for 30 days.

The event object

idstring

Unique identifier, prefixed with `evt_`.

objectstring

Always `"event"`.

livemodeboolean

True if the event was produced in live mode.

typestring

The event name, in dot notation. Examples: `checkout.session.completed`, `payment.succeeded`, `invoice.sent`.

api_versionstring

API version the event payload is rendered in.

dataobject

Event payload. Contains `object`, a full snapshot of the resource at the moment the event fired.

createdinteger

Creation timestamp (unix).

{
  "id": "evt_01JRZKD1KMN8RZJX4QV5W7YEFH",
  "object": "event",
  "livemode": false,
  "type": "checkout.session.completed",
  "api_version": "2026-04-14",
  "data": {
    "object": {
      "id": "cs_01JRZK8WV3FYMPEQRXJ9HA5NTB",
      "object": "checkout_session",
      "status": "COMPLETE",
      "payment_status": "paid",
      "amount_cents": 5000,
      "currency": "usd"
    }
  },
  "created": 1713100900
}

Endpoints