Платежи и доход
Обзор раздела
Раздел Платежи --- центральный инструмент для отслеживания финансов вашего VPN-сервиса. Здесь вы видите все транзакции, статистику дохода и можете экспортировать данные для бухгалтерии.
Панель статистики
В верхней части страницы расположены четыре карточки с ключевыми метриками:
| Карточка | Описание |
|---|---|
| Общий доход | Сумма всех успешных платежей за всё время (в рублях) |
| Сегодня | Доход за текущий день. Показывает счётчик новых платежей в реальном времени |
| Ср. чек | Средняя сумма одного успешного платежа |
| Платежей | Общее количество успешных транзакций |
Карточка Общий доход показывает индикатор WebSocket-подключения. Зелёная молния означает, что данные обновляются в реальном времени.
Таблица платежей
Таблица содержит следующие столбцы:
- ID --- уникальный номер транзакции в системе
- Пользователь --- имя и Telegram ID покупателя. Клик по иконке ссылки откроет профиль в Telegram
- Тариф --- выбранный план подписки (1 месяц, 3 месяца, 6 месяцев, 1 год)
- Сумма --- сумма платежа в рублях. Для платежей через Telegram Stars отображается количество звёзд и эквивалент в рублях
- Метод --- платёжная система (YooKassa, YooMoney, CryptoBot, Telegram Stars)
- Статус --- текущее состояние платежа
- Дата --- дата и время проведения транзакции
Таблица поддерживает сортировку по каждому столбцу (клик по заголовку) и фильтрацию по тарифу, методу оплаты и статусу.
Статусы платежей
| Статус | Значение |
|---|---|
| Успешно (completed) | Платёж прошёл, подписка активирована |
| Ожидает (pending) | Платёж создан, но ещё не подтверждён платёжной системой |
| Отклонено (failed) | Платёж не прошёл --- отменён пользователем или отклонён системой |
Поиск и фильтрация
Используйте строку поиска для быстрого нахождения платежа. Поиск работает по:
- Имени пользователя
- Username в Telegram
- Telegram ID
- Номеру транзакции
Для фильтрации по конкретному столбцу используйте выпадающие фильтры в панели инструментов таблицы.
Поддерживаемые платёжные системы
Tunly поддерживает четыре платёжные системы. Подключить их можно в разделе Настройки.
| Система | Валюта | Особенности |
|---|---|---|
| Telegram Stars | Stars | Встроенная система оплаты Telegram. Не требует отдельной регистрации --- работает через бот-токен |
| YooKassa | RUB | Полноценный эквайринг: банковские карты, SberPay, ЮMoney. Требуется аккаунт в ЮКассе |
| YooMoney | RUB | Приём платежей на кошелёк ЮMoney. Подходит для быстрого старта без юрлица |
| CryptoBot | USDT, TON, BTC | Приём криптовалюты через Telegram-бота @CryptoBot. Автоматическая настройка вебхуков |
Конвертация Stars в рубли
Для платежей через Telegram Stars в таблице отображается эквивалент в рублях. Курс конвертации задаётся в Настройки -> поле Stars Rub Rate (по умолчанию 2.5 руб. за 1 Star).
Следите за актуальным курсом Stars. Telegram периодически меняет стоимость Stars, поэтому рекомендуется обновлять курс в настройках.
Экспорт платежей
Нажмите кнопку Экспорт (иконка загрузки) в верхней части страницы, чтобы скачать CSV-файл со всеми платежами. Файл содержит:
- ID транзакции
- Имя пользователя и Telegram ID
- Тариф
- Сумма (в рублях и в Stars, если применимо)
- Метод оплаты
- Статус
- Дата
CSV-файл использует кодировку UTF-8 с BOM и разделитель ”;” --- он корректно открывается в Excel и Google Sheets.
Уведомления о платежах
При поступлении нового платежа система автоматически:
- Обновляет таблицу в реальном времени через WebSocket --- новый платёж появляется в начале списка без перезагрузки страницы
- Показывает всплывающее уведомление с именем пользователя и суммой
- Обновляет счётчик в карточке Сегодня
Дополнительно, если у вас настроен Telegram-бот, администратор получает push-уведомление в Telegram при каждом успешном платеже.
График дохода
Под панелью статистики расположен график дохода, который визуализирует динамику платежей за выбранный период. Используйте его для анализа трендов и сезонности.