Каталог событий MCN Telecom — Состояние счёта
0 просмотра
Создано 28.08.2026
Обновлено 28.08.2026Состояние счёта
События (вебхуки и триггеры), связанные с изменением состояния счёта.
Единый Envelope используется для всех событий: один channel соответствует одному event_type.
Содержание
Также см.:
«Каталог событий MCN Telecom — Виртуальная АТС (Звонки ВАТС, Переадресация и внутренние номера)»;
«Каталог событий MCN Telecom — Виртуальная АТС (Очереди, Другие события ВАТС)»;
«Каталог событий MCN Telecom — Работа с речью»;
Общий формат события
Все события используют общую обёртку Envelope:
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
account_id | integer | ✓ | ID аккаунта в системе |
event_type | string | ✓ | Тип события |
created_at | string (date-time) | ✓ | Момент события (UTC) |
idempotencyKey | string (uuid) | — | Ключ идемпотентности; одинаков при повторных доставках и используется для дедупликации |
data | object | ✓ | Данные, специфичные для event_type |
✓— обязательное поле;—— необязательное.
Для события приведены описание полей data и пример Payload.
Состояние счёта
Balance - Состояние счёта
Событие: Блокировка ЛС и состояние счёта
Payload: allOf — общий Envelope + данные события.
Envelope
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
account_id | integer | ✓ | ID аккаунта в системе |
event_type | string | ✓ | Тип события — см. components/messages |
created_at | string (date-time) | ✓ | Момент события (UTC) |
idempotencyKey | string (uuid) | — | Ключ идемпотентности; используется для дедупликации повторных доставок |
data | object | ✓ | Данные, специфичные для event_type |
data
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
accountId | number | ✓ | Номер лицевого счёта; дублирует account_id из Envelope |
sum_total | number | ✓ | Общая сумма |
is_blocked | boolean | ✓ | Состояние блокировки |
account_id | number | ✓ | Номер ЛС |
balance | number | ✓ | Баланс лицевого счёта |
balance_available | number | ✓ | Доступный баланс |
daily_available | number | ✓ | Ежедневный доступный баланс |
eventType | string | ✓ | Тип события |
credit | number | ✓ | Кредитный лимит лицевого счёта |
balance_without_credit | number | ✓ | Баланс лицевого счёта без учёта кредитного лимита |
✓— обязательное поле;—— необязательное.
Пример: Payload
{
"account_id": 10001,
"event_type": "Balance",
"created_at": "2026-07-01T23:40:29.931Z",
"idempotencyKey": "5b133904-6192-49d2-abbc-f95be887fb70",
"data": {
"accountId": 10001,
"sum_total": -5026.35,
"is_blocked": false,
"account_id": 10001,
"balance": -9000000,
"balance_available": 15994973.65,
"stats": [
{
"amount_day": "2026-07-01 00:00:00.000",
"account_id": 10001,
"amount_month": "2026-07-01 00:00:00.000",
"sum": -357.66,
"server_id": 99,
"amount_date": "2026-07-01 00:00:00.000"
},
{
"amount_day": "2026-07-01 00:00:00.000",
"account_id": 10001,
"amount_month": "2026-07-01 00:00:00.000",
"sum": -19.2,
"server_id": 1001,
"amount_date": "2026-07-01 00:00:00.000"
},
{
"amount_day": "2026-07-01 00:00:00.000",
"account_id": 10001,
"amount_month": "2026-07-01 00:00:00.000",
"sum": -1362.86,
"server_id": 9,
"amount_date": "2026-07-01 00:00:00.000"
},
{
"amount_day": "2026-07-01 00:00:00.000",
"account_id": 10001,
"amount_month": "2026-07-01 00:00:00.000",
"sum": -1842.73,
"server_id": 7,
"amount_date": "2026-07-01 00:00:00.000"
},
{
"amount_day": "2026-07-01 00:00:00.000",
"account_id": 10001,
"amount_month": "2026-07-01 00:00:00.000",
"sum": -1443.9,
"server_id": 6,
"amount_date": "2026-07-01 00:00:00.000"
},
{
"amount_day": "2026-05-13 00:00:00.000",
"account_id": 10001,
"amount_month": "2026-05-01 00:00:00.000",
"sum": 0,
"server_id": 1002,
"amount_date": "2026-07-01 00:00:00.000"
}
],
"client": {
"timezone_offset": 3,
"anti_fraud_disabled": false,
"voip_limit_day": 1000000,
"voip_limit_month": 0,
"price_include_vat": true,
"effective_vat_rate": 20,
"is_blocked": false,
"account_version": 5,
"balance": -9000000,
"last_payed_month": "",
"organization_id": 1,
"currency": "RUB",
"id": 10001,
"voip_limit_mn_day": 10000,
"credit": 25000000,
"voip_disabled": false,
"amount_date": "2026-07-01 00:00:00.000"
},
"daily_available": 994973.65,
"eventType": "Balance",
"credit": 25000000,
"balance_without_credit": -9005026.35
}
}