Перейти до вмісту
Sursa Developers

Події · Оплата

invoice.paid

Рахунок оплачено

Рахунок оплачено.

Тип об’єкта
invoice
Кому доставляється
Вебхукам із роллю адміністратора

Вміст події

Об’єкт: EventInvoicePaid

  • idstringобов’язково

    ID події (evt_…), також надсилається в заголовку webhook-id. За ним відкидайте дублікати доставок.

  • typestringобов’язково

    Допустимі значення: invoice.paid

  • created_atstring (date-time)обов’язково

    Коли сталася зміна (UTC).

  • org_idintegerобов’язково
  • api_versionstringобов’язково

    Версія договору для схеми data.

  • sequenceinteger

    Порядковий номер доставки в межах вебхука (немає для тестової події).

  • objectWebhookEventObjectобов’язково
  • payloadstringобов’язково

    thin означає, що data немає: читайте об’єкт через API.

    Допустимі значення: fullthin

  • dataobject
    Поля
    • invoiceEventInvoiceобов’язково
    • actor_idinteger | nullобов’язково

      Користувач, який виконав дію; null для ключа API організації або самої платформи.

  • testbooleanобов’язково

    Тестова подія, надіслана через POST /v1/webhooks/{webhook_id}/test.

Приклад доставки

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "invoice.paid",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "invoice",
    "id": "301"
  },
  "payload": "full",
  "data": {
    "invoice": {
      "id": 301,
      "number": "INV-2026-000301",
      "amount": 1250,
      "currency": "EUR",
      "status": "paid",
      "period_start": "2026-10-01T00:00:00Z",
      "period_end": "2026-11-01T00:00:00Z",
      "issued_at": "2026-10-24T10:00:00Z",
      "due_at": "2026-11-07T10:00:00Z",
      "paid_at": "2026-10-25T09:00:00Z"
    },
    "actor_id": null
  },
  "test": false
}

Отримання подій

Кожна доставка — це запит POST із таким тілом JSON на адресу вашого вебхука. Перш ніж довіряти тілу, перевірте заголовок webhook-signature (Standard Webhooks), відповідайте статусом 2xx протягом кількох секунд, а саму роботу виконуйте вже після відповіді. Доставки на один вебхук зберігають порядок подій; невдала доставка повторюється зі зростаючими паузами.

Нові типи подій і нові поля можуть з’явитися будь-коли: пропускайте типи й поля, яких ви не знаєте.

Ті самі події 30 днів зберігаються в стрічці подій →