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

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

credits.low

Кредити закінчуються

Баланс кредитів за період перетнув поріг використання (data.threshold — відсоток використаного обсягу). Надсилається один раз для кожного порогу й періоду.

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

Вміст події

Об’єкт: EventCreditsLow

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

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

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

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

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

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

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

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

  • sequenceinteger

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

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

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

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

  • dataobject
    Поля
    • thresholdintegerобов’язково

      Поріг у відсотках використаного обсягу: 80 або 100.

    • period_startstring (date)обов’язково
    • balancenumber
    • allowancenumber
  • testbooleanобов’язково

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

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

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "credits.low",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "org",
    "id": "1"
  },
  "payload": "full",
  "data": {
    "threshold": 80,
    "period_start": "2026-10-01",
    "balance": 1000,
    "allowance": 5000
  },
  "test": false
}

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

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

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

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