Раздел Events в PayStar — единый журнал платежей, лимитов и Issues с уведомлениями в Telegram/Slack и вебхуками. Ускоряет расследование инцидентов.

Events — это единый журнал всего, что происходит с платежами, лимитами, Issues и настройками в PayStar.
Те же события можно:

смотреть в интерфейсе (раздел Events),

получать в Telegram и Slack,

забирать на свой HTTP-endpoint в виде вебхуков (подробности: https://apidoc.paystar.uk/events).

Сейчас раздел Events доступен в админке PayStar и используется для мониторинга и расследований внутри команды; вебхуки и уведомления уже доступны мерчантам по документации.

Зачем нужен Events

Events помогает быстро ответить на три вопроса:

Что происходит в системе?
Лимиты срабатывают? Появились неизвестные статусы от PSP? Насыпались Issues?

Кто что сделал и когда?
Какой менеджер создал или обновил Issue, изменил канал, поправил routing?

Почему возник конкретный инцидент?
Можно восстановить цепочку: от статуса платежа и срабатывания лимита до заведённого Issue.

Events особенно полезен:

саппорту и аккаунт-менеджерам — при работе с жалобами мерчантов;

риск-команде — при контроле лимитов и блэклистов;

интеграционной команде — при отладке и мониторинге PSP.

Интерфейс раздела Events

Раздел Events состоит из двух вкладок: Charts и History. Сверху — фильтр по дате и по пользователю.

Фильтр периода и пользователя

Дата — в левом верхнем углу выбирается диапазон дат. Все графики и список событий показывают только то, что произошло в этот период.

User — поле поиска по пользователю.
Вводите имя/логин, и в History остаются только события, инициированные этим пользователем (строки с его аватаркой). Автоматические события (лимиты, статусы, PSP Integration) этим фильтром не отсекаются.

Переключатели Daily / Weekly / Monthly меняют масштаб времени: по дням, неделям или месяцам.

Charts: агрегированная картинка

Вкладка Charts отвечает за быстрый обзор. Здесь собраны donut-диаграммы по категориям:

Payments — события по статусам платежей (ORDER STATUS UPDATED, ORDERS UNKNOWN и др.),

Limits — срабатывания лимитов,

Routing (pipeline rule) — изменения в правилах маршрутизации,

Pipeline, Channels, Merchants, Cashiers, Commission, Settlements, Issues — активность по настройкам и инцидентам.

Сверху — линейный график по времени, показывающий динамику событий.

По выбранному периоду (Daily / Weekly / Monthly) видно:

есть ли всплески ошибок/лимитов,

когда именно накапливается больше всего событий,

какие категории сейчас «шумят» больше остальных.

History: подробная лента событий

Вкладка History — это хронологический список всех событий за выбранный период.

Каждая строка содержит:

слева — иконку источника: аватарку пользователя или, например, метку PSP Integration,

по центру — краткий заголовок (LIMIT EXCEEDED, ORDER STATUS UPDATED, ISSUE ADDED, ORDERS UNKNOWN и т.п.),

справа — точное время события.

Автоматические и пользовательские события

Строки с аватаркой и именем — это действия реальных пользователей в админке (создание/обновление Issues, изменения настроек и т.д.).

Строки без имени или с пометкой PSP Integration — автоматические события системы и платёжных провайдеров: срабатывания лимитов, статусы от PSP, системные апдейты.

Раскрытие деталей события

Клик по строке раскрывает карточку с подробностями:

тип события (LIMIT EXCEEDED, ORDER STATUS UPDATED, NEW ISSUES - … и др.),

ключевые параметры (мерчант, тип и значение лимита; тип операции и переход статуса для платежа),

точное время в формате UTC,

технические идентификаторы (UUID ордера, лимита, Issue),

текстовые теги (#Limit, #OrderStatus, #Issue, #PSP Integration и др.).

Пока переход к сущностям осуществляется через копирование ID и использование его в других разделах (Order, Issue, Limits и т.п.).

Какие события логируются

На момент написания в Events попадают, в частности:

Платежи

ORDER STATUS UPDATED — изменение статуса депозита или выплаты;

ORDERS UNKNOWN — ответы от PSP, которые не удалось сопоставить с ожидаемыми статусами.

Лимиты и блэклисты

LIMIT EXCEEDED — срабатывание лимитов (например, по количеству реквизитов или обороту мерчанта).

Issues

ISSUE ADDED, ISSUE UPDATED;

агрегированные записи вида NEW ISSUES - 64.

Интеграции

события от PSP Integration — всё, что прилетает с уровня интеграции.

Настройки

действия по Pipeline и Routing (pipeline rule),

изменения в Channels, Merchants, Cashiers, Commission, Settlements — как через счётчики на Charts, так и отдельными событиями в History, если были изменения.

Типичные сценарии использования

1. Разбор жалобы мерчанта на депозит

В фильтре дат выбираете нужный диапазон.

Поиск по Order ID или тегам в описании (#OrderStatus, #Issue и т.д.).

В History видите цепочку событий:

изменение статуса (ORDER STATUS UPDATED),

возможное LIMIT EXCEEDED,

связанные Issues.

По идентификаторам переходите в ордер или Issue и собираете полную картину.

2. Обнаружение проблем с PSP

На Charts видите всплеск ORDERS UNKNOWN или рост ошибок по Payments.

Переходите в History и смотрите, какие PSP-интеграции чаще всего фигурируют в этих событиях.

На основании этих данных корректируете routing, поднимаете Issue или связывайтесь с PSP.

3. Контроль работы команды

В поле User выбираете нужного менеджера.

В History видите его действия: какие Issues создавались, какие изменения вносились в настройки.

По временной ленте можно оценить скорость реакции и нагрузку.

Подписки на Events: Telegram, Slack и вебхуки

Интерфейс — не единственный способ работать с Events.
Те же самые события можно получать во внешние системы.

Telegram и Slack

Events может отправлять выбранные типы событий в:

рабочий чат в Telegram (через бота),

канал в Slack.

Так вы будете видеть, например:

срабатывания лимитов (LIMIT EXCEEDED),

неизвестные статусы от PSP (ORDERS UNKNOWN),

новые Issues и другие важные события — прямо в привычных мессенджерах.

Формат сообщений адаптирован под быстрый просмотр: краткий заголовок, ключевые поля и идентификаторы.

Вебхуки на ваш endpoint

Если нужно подключить собственный мониторинг или автоматические действия, можно настроить вебхуки:

указываете HTTP-endpoint на своей стороне,

выбираете, какие типы Events на него отправлять,

получаете JSON-payload с нужной информацией.

Детали формата, примеры payload и рекомендации по обработке описаны в мерчант-документации:
https://apidoc.paystar.uk/events

Итог

Events — это:

единый журнал событий по платежам, лимитам, Issues, настройкам и интеграциям;

интерфейс с двумя режимами — Charts для обзора и History для деталей;

единый поток данных, который можно дублировать в Telegram, Slack и свои системы через вебхуки.

С его помощью расследование инцидентов и мониторинг качества работы платёжной инфраструктуры занимают минуты, а не часы.

Events в PayStar: единый журнал событий

Зачем нужен Events#

Интерфейс раздела Events#

Фильтр периода и пользователя#

Charts: агрегированная картинка#

History: подробная лента событий#

Автоматические и пользовательские события#

Раскрытие деталей события#

Какие события логируются#

Типичные сценарии использования#

1. Разбор жалобы мерчанта на депозит#

2. Обнаружение проблем с PSP#

3. Контроль работы команды#

Подписки на Events: Telegram, Slack и вебхуки#

Telegram и Slack#

Вебхуки на ваш endpoint#

Итог#