Карточка клиента
Всё об одном клиенте на одной странице: профиль, подписка, устройства и HWID, платежи, ключи, друзья и партнёрский процент, блокировка и удаление.
Карточка открывается из списка пользователей нажатием на строку, из ключа кнопкой «Профиль» или по прямой ссылке вида /admin/users/123456789. Стрелка слева от имени возвращает к списку, при этом фильтры и место в списке сохраняются.

Шапка
- Имя. Если задана метка администратора, вместо имени показывается она, а имя из Telegram — серым ниже.
- Статус: Активен, Истёк или Заблокирован. Метка «бот» или «бот?» — подозрение на бота по бот-скору.
- @username — ссылка на профиль в Telegram.
- ID — Telegram ID. Нажмите, чтобы скопировать.
- «с нами с» — дата регистрации.
- Присутствие: «в приложении» — клиент сейчас открыл Mini App или кабинет; «VPN подключён» — сейчас есть подключение к серверу. Если ни того ни другого — «последний визит …».
Кнопки справа:
- «Изменить данные» — метка, имя, username и Telegram ID. Подробнее ниже.
- «Продлить доступ» (или «Выдать доступ», если подписки нет) — окно выдачи. Описано на странице «Выдача и продление доступа».
Если клиент заблокирован, под шапкой висит красная плашка «Пользователь заблокирован» с кнопкой «Разблокировать».
Цифры сверху
| Плитка | Что показывает |
|---|---|
| Доход | Сумма всех оплаченных платежей клиента и их число. Сюда входят и покупки в магазине Stars/Premium |
| Осталось | Сколько дней до конца подписки и дата. У пробного — пометка «пробный». Оранжевым, если осталось 3 дня и меньше. Без подписки плитка называется «Подписка»: «Истекла» с датой или «Нет» |
| Устройства | Сколько устройств подключено из лимита пакета, например «2 из 5», и когда было последнее подключение. Оранжевым, если устройств больше лимита |
| Друзья | Сколько человек пришло по реферальной ссылке клиента и сколько они принесли ему дней или денег |
Доход в карточке и в списке считается по-разному
В списке пользователей колонка «Доход» — только VPN, без магазина и за вычетом возвратов. В карточке плитка «Доход» складывает все оплаченные платежи клиента. Если клиент покупал звёзды или Premium, цифры разойдутся.
Подписка
Блок «Подписка» показывает пакет, дату окончания, расход БС, запланированную смену пакета и автопродление. Здесь же кнопки смены пакета, «Изменить дату» и «Обнулить БС». Всё это описано на отдельной странице: «Выдача и продление доступа».
Устройства
Список устройств, которые забирали подписку клиента. Несколько VPN-приложений на одном телефоне показываются одним устройством.
У каждого устройства:
- модель, система и версия, приложения с версиями — например,
iPhone 15 · iOS 18.1 · Happ 3.2; - последний IP-адрес, сколько раз устройство запрашивало подписку и когда было в сети;
- красная метка «Заблокировано» — устройство подключилось сверх лимита пакета, и подписка ему не выдаётся.
В заголовке блока — «N из M» (устройств из лимита) и «Уникальных HWID». Метка «Больше лимита» — устройств больше, чем позволяет пакет.
Как считается лимит
Устройство учитывается, только если VPN-приложение прислало HWID. Места занимают устройства в порядке первого подключения. Если лимит «Плюс» — 5 устройств, шестое новое устройство получит отказ, а в карточке у него появится «Заблокировано».
Отвязать устройство
Кнопка «Отвязать» освобождает место. Нужна, когда клиент сменил телефон или переустановил систему.
Нажмите «Отвязать» у старого устройства.
Подтвердите в окне «Отвязать устройство?».
Попросите клиента обновить подписку на новом устройстве.
Отвязка не выключает VPN на старом устройстве
Отвязка только освобождает место в лимите. Если на старом устройстве подписка осталась, при следующем обновлении оно снова займёт место, если оно свободно. Чтобы старое устройство точно перестало работать, перевыпустите ключ в разделе «Ключи».
Платежи
Все платежи клиента, новые сверху. Показаны пять, кнопка «Показать все N» раскрывает остальные.
В строке: что оплачено (пакет, смена пакета, сброс БС, звёзды, Premium), дата и время, способ оплаты, номер платежа вида 7K3F-9QMZ и сумма. У неоплаченных справа статус: Ждёт оплаты, На проверке, Ошибка, Отменён или Возврат. Их суммы серые и в доход не входят.
Возвраты отмечаются в разделе «Платежи», см. «Каждый день: платежи и возвраты».
Ключи
Подписка клиента и локации, на которых выпущены его ключи.
- Название пакета, дата окончания и сколько дней осталось.
- Статус: Активна, Истекает (3 дня и меньше) или Истекла.
- Токен подписки — нажмите, чтобы скопировать.
- Список локаций. Зелёная точка — ключ на этой локации включён, серая — выключен.
Полную ссылку подписки, трафик и IP-адреса смотрите в карточке ключа в разделе «Ключи».
Профиль
| Строка | Что значит |
|---|---|
| Метка | Ваша пометка о клиенте. Видна только в админке |
| Имя в Telegram | Имя из Telegram |
| Username | Ссылка на профиль |
| Telegram ID | Нажмите, чтобы скопировать |
| Регистрация | Дата первого входа |
| Последний визит | Когда клиент последний раз был активен |
| Источник | Органика, Реферал, Реклама, Вручную или Сайт. У реферала — ссылка на карточку пригласившего, у рекламы — название ссылки |
| Пробный период | использован или ещё не брал |
| Бот-скор | Оценка от 0 до 100 и вывод: «стоит проверить» (от 25), «похоже на бота» (от 50), «подтверждён» |
| Открывал приложение | Сколько раз клиент открывал Mini App |
| Вход | Появляется, если клиент вошёл на сайте: Почта, Google или Яндекс |
| Язык | Язык интерфейса клиента |
| Сообщения бота | «бот заблокирован пользователем» — клиент остановил бота, сообщения и рассылки до него не дойдут |
Друзья
Партнёр
Переключатель «Партнёр» вверху блока. Включите его для блогеров и каналов: за оплаты приглашённых друзей партнёр получает процент деньгами на баланс с выводом, а не дни, даже если в программе у всех остальных дни.
- Поле процента — целое число от 0 до 100. Пустое поле — действует общий процент из настроек реферальной программы.
- Нажмите «Сохранить». «Отменить» возвращает прежнее значение.
- Новый режим действует со следующих оплат друзей. Уже начисленные дни и деньги не пересчитываются.
Общие настройки программы — в разделе «Маркетинг: реферальная программа».
Список друзей
Кто пришёл по ссылке клиента, с какой даты, сколько каждый принёс. «в пути» — бонус начислен, но ещё ждёт срок удержания. Нажмите на имя, чтобы открыть карточку друга. Показаны пятеро, «Показать все N» раскрывает остальных.
Блокировка и удаление
Заблокировать
Кнопка «Заблокировать» в блоке «Блокировка и удаление» или массово из списка.
Что происходит:
- статус становится «Заблокирован»;
- если подписка действовала, она заканчивается в ту же минуту;
- все ключи клиента отключаются.
«Разблокировать» снимает блокировку, но срок подписки не возвращает.
После разблокировки выдайте доступ заново
Окно подтверждения пишет, что клиент «снова получит доступ к VPN». На деле подписка после блокировки уже закончилась. Если блокировали по ошибке, после разблокировки нажмите «Выдать доступ» или поставьте прежнюю дату через «Изменить дату».
Удалить
Кнопка «Удалить» и подтверждение «Удалить навсегда».
- Клиенты удаляются с VPN-серверов, ключи, устройства, история подключений и трафика — из базы.
- Если у клиента были платежи или автосписания, он не удаляется полностью, а обезличивается: имя, username, Telegram ID и доступы стираются, платежи остаются для сверки. Автопродление отключается, ждущие заявки на вывод отклоняются. Сообщение будет «Пользователь удалён, финансовая история сохранена».
- Если платежей не было, клиент удаляется целиком вместе с реферальными начислениями и промокодами.
- Если этот человек потом снова придёт в бота, он будет новым пользователем: без подписки, истории и друзей.
Удаление нельзя отменить
Восстановить удалённого клиента можно только из резервной копии базы. Если нужно просто закрыть доступ, используйте блокировку.
Удаление не сработает, пока у клиента есть незавершённый платёж или проверка смены пакета. Панель напишет «Сначала дождитесь итогового статуса оплаты…». Обычный счёт сам отменяется через 15 минут, после этого удалите снова.
Изменить данные
Кнопка «Изменить данные» в шапке открывает окно «Данные пользователя».
| Поле | Что вводить | Ограничения |
|---|---|---|
| Метка администратора | Ваша пометка, например бабушка бухгалтера | До 500 символов. Видна только в админке и показывается вместо имени |
| Имя | Имя клиента | До 255 символов |
| Username | Без @, например ivan_petrov | Без пробелов. Имя или username — хотя бы одно обязательно |
| Telegram ID | Число, например 123456789 | Меняется только у пользователей, созданных вручную. Не 0, не занятый другим пользователем |
Нажмите «Сохранить».
Смена Telegram ID нужна, чтобы привязать созданного вручную клиента к его настоящему Telegram: после этого бот узнает его, а подписка, друзья и переписка в поддержке останутся при нём. Панель также переименует его клиентов на серверах 3x-ui. Если какой-то сервер не ответил, появится предупреждение «Данные сохранены, но часть 3x-ui клиентов не переименовалась».
Все действия записываются
Выдача доступа, смена пакета и даты, блокировка, удаление, правка профиля и отвязка устройств попадают в журнал Настройки → Логи с именем администратора.