Личный кабинет

Обзор интерфейса

• Боковое меню: «Панель», «Файлы», «Выплаты», «Настройки», переключатель языка RU/EN.
• Шапка/мобайл: offcanvas-меню, быстрые действия: «Создать выплату», «Загрузить файл».
• Панель: карточки метрик, график успех/ошибка выплат, последние файлы.

Дашборд

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

• Карточки метрик: количество файлов, число выплат, суммарная сумма, конверсия (успешные/все).
• График: тренд успешных и неуспешных выплат по периодам; легенда позволяет сопоставлять кривые.
• Недавние файлы: таблица с названием, датой, статусом обработки, краткой статистикой и суммой.

Авторизация и сессия

• Вход через страницу входа. При успешном входе — редирект в кабинет.
• Таймаут бездействия: 30 минут; после — выход и сообщение о завершении сессии.
• CSRF‑токен для защищённых операций, регенерация ID сессии после входа.

Загрузка файлов с выплатами

Процесс загрузки

1. Нажмите «Загрузить файл» (кнопка доступна на Панели, в «Файлы», «Выплаты», а также в мобильном меню).
2. Выберите CSV файл в одном из поддерживаемых форматов и подтвердите отправку. Индикатор загрузки покажет процесс.
3. После загрузки появится запись в списке файлов со статусом: created → processing → completed.

Подсказки: drag&drop доступен на поддерживаемых экранах; недавние файлы видны на панели.

Поддерживаемые форматы файлов

Система поддерживает загрузку CSV файлов с тремя различными форматами в зависимости от ваших потребностей:

- файл для загрузки выплат только на номера карт получателей;

- файл для загрузки выплат только через Систему быстрых платежей (СБП);

- файл для загрузки выплат на номера карт и через СБП в одном файле.

Параметры используемые в файлах:

• card_number - номер карты получателя;
• sbp_phone - номер телефона получателя;
• sbp_bank_id - идентификатор банка получателя;
• sbp_full_name - полное имя получателя;
• amount - сумма выплаты;
• description - описание выплаты.

Примеры файлов

card_number;amount;description
4111111111111111;1500,50;Возврат за товар
5555555555554444;2300,00;Компенсация расходов

sbp_phone;sbp_bank_id;sbp_full_name;amount;description
79001234567;100000000004;Иванов Иван Иванович;1500,50;Возврат расходов
79123456789;100000000008;Петрова Мария Сергеевна;2300,00;Компенсация доставки

type;pan;sbp_phone;sbp_bank_id;sbp_full_name;amount;description
card;4111111111111111;;;;1500,50;Возврат за товар
sbp;;79001234567;100000000004;Иванов Иван Иванович;2300,00;Компенсация расходов

Валидация и ограничения

Карточные выплаты

• Номер карты: 13-19 цифр, проходит проверку по алгоритму Луна
• Сумма: от 1,00 до 9 999 999,99 рублей
• Описание: до 256 символов

СБП выплаты

• Номер телефона: формат 7XXXXXXXXXX (11 цифр, начинается с 7)
• ID банка: от 9 до 12 цифр
• Полное имя: имя и фамилия на русском языке (2-255 символов)
• Сумма: от 1,00 до 9 999 999,99 рублей
• Описание: до 256 символов

Общие ограничения

• Максимум строк в файле: 5000 (не считая заголовок)
• Размер файла: рекомендуется до 5 МБ
• Кодировка: UTF-8
• Разделитель: точка с запятой (;)
• Десятичный разделитель: запятая (,) или точка (.)

Детали файла

Откройте файл из списка, чтобы увидеть агрегированные метрики (сумма, количество, успех/ошибка/игнор) и построчные выплаты.

• Подтверждение выплат: если есть позиции со статусом «uploaded», нажмите «Подтвердить»; при включённом 2FA потребуется код.
• Скачивание файла: доступно в течение ограниченного срока (обычно 3 дня).

Список выплат

Содержит все выплаты: по файлам и одиночные. Для СБП — маскирование телефона и банк; для карт — маска номера, платёжная система и банк. Бейдж состояния success помогает быстро различать статусы.

Доступно быстрое повторение выплаты по строке (иконка «повторить»).

Одиночная выплата

1. Нажмите «Создать выплату» (кнопка на панели/списках). Откроется модальное окно.
2. Выберите вкладку: «Выплата на карту» или «Выплата СБП».
3. Заполните форму: номер карты и сумма/описание, или телефон СБП, банк, ФИО, сумма и описание.
4. При необходимости введите код 2FA и отправьте.

Валидация номера карты по алгоритму Луна, форматирование суммы, подсказки по банкам СБП.

Фильтры, поиск, экспорт

• Файлы: статус, период (включая кастомные даты), поиск по имени, экспорт списка. Пример фильтра-чипа Статус: all.
• Выплаты: статус, даты, поиск по последним 4 цифрам карты, банк получателя (подсказки), платёжная система, тип платежа.
• Панель: быстрый период, фильтр статуса, график успех/ошибка.

Настройки и интеграции

Раздел настроек позволяет настроить все аспекты работы с системой и интеграциями.

Основные разделы настроек

• Профиль: тема интерфейса (светлая/темная/системная), общая информация аккаунта, языковые предпочтения.
• Интеграции: настройка подключений к банковским системам для выплат на карты и по СБП.
• API: управление API токенами для интеграции с внешними системами.
• Безопасность: настройки двухфакторной аутентификации, смена пароля, просмотр разрешений.
• Telegram: подключение Telegram аккаунта для получения уведомлений и ежедневной статистики.

Настройка интеграций

ВТБ Выплаты - Карты

• Client ID и Client Secret: учетные данные для доступа к API банка
• Публичный ключ PAN: ключ для шифрования данных банковских карт
• Статус подключения: отображение текущего статуса интеграции

ВТБ Выплаты - СБП

• Client ID и Client Secret: учетные данные для СБП API
• Merchant Authorization: токен для авторизации мерчанта
• Тестовые окружения: переключение между prod/uat/dev

Система разрешений

Система разрешений контролирует доступ к различным функциям платформы. Администратор может настроить индивидуальные разрешения для каждого пользователя.

Типы разрешений

• Выплаты на карты - разрешение создавать и обрабатывать выплаты на банковские карты
• СБП выплаты - разрешение создавать и обрабатывать выплаты через Систему быстрых платежей
• Скачивание файлов - разрешение скачивать CSV-файлы с выплатами

Как работают разрешения

• Разрешения отображаются в разделе Настройки → Безопасность → Разрешения
• Статус показывается цветными индикаторами: 🟢 Разрешено / 🔴 Запрещено
• При отсутствии разрешений соответствующие элементы интерфейса скрываются или блокируются
• Изменение разрешений доступно только администраторам системы

Влияние на интерфейс

Telegram интеграция

Система интегрирована с Telegram для отправки уведомлений и ежедневной статистики.

Подключение Telegram аккаунта

1. Перейдите в Настройки → Telegram
2. Нажмите "Подключить Telegram аккаунт"
3. Скопируйте код авторизации из интерфейса
4. Найдите бота в Telegram и отправьте команду /start КОД_АВТОРИЗАЦИИ
5. После успешного подключения аккаунт появится в списке подключенных

Возможности Telegram интеграции

• Автоматические уведомления об ошибках выплат и критических событиях
• Ежедневная статистика - автоматическая отправка сводки за вчерашний день
• Команды бота:
  • /start КОД - подключение аккаунта
  • /stats - получение статистики за сегодня
  • /logout - отключение аккаунта

Настройка ежедневной статистики

• Включение/выключение - переключатель для активации рассылки
• Время отправки - настройка желаемого времени получения отчета (по умолчанию 07:00)
• Часовой пояс - все время работает в московском часовом поясе (UTC+3)

Формат ежедневной статистики

📊 Ежедневная статистика за 2024-01-15

👋 Здравствуйте, Иван!

💳 Выплаты:
• Всего: 25
• Успешно: 22  
• Ошибки: 2
• В обработке: 1
• Общая сумма: 125 000,00 ₽
• Успешная сумма: 110 000,00 ₽

📁 Файлы:
• Всего загружено: 3
• Завершено: 2
• В обработке: 1

📈 Конверсия: 88%

🕐 Отчет сформирован: 15.01.2024 07:00

2FA и безопасность

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

Двухфакторная аутентификация (2FA)

• Настройка 2FA: включение через мобильное приложение-аутентификатор (Google Authenticator, Authy)
• Применение: защита входа в систему и критических операций
• Операции, требующие 2FA:
  • Подтверждение выплат из файлов
  • Создание одиночных выплат
  • Смена пароля
  • Изменение настроек безопасности

Дополнительные меры безопасности

• Таймаут сессии: автоматический выход через 30 минут бездействия
• CSRF защита: токены для всех критических операций
• Защита от фиксации сессий: регенерация ID сессии после входа
• Логирование: запись всех важных действий пользователя
• IP контроль: отслеживание подозрительной активности

Рекомендации по безопасности

Система повторных попыток

Автоматическая система повторных попыток обеспечивает надежность обработки выплат при временных сбоях.

Как работает система

• Автоматические попытки: при неуспешной выплате система автоматически повторяет попытку
• Раздельные лимиты: разные лимиты для карточных выплат (5 попыток) и СБП (3 попытки)
• Интеллектуальная логика: система увеличивает счетчик попыток только при реальных ошибках
• Автоматическая остановка: при достижении лимита выплата помечается как неуспешная

Лимиты попыток

Отслеживание попыток

Информация о попытках отображается:

• В детализации выплаты - количество выполненных попыток
• В сообщениях об ошибках - причина последней неуспешной попытки
• В логах системы - подробная информация для администраторов

Типовые проблемы и решения

• Статусы не обновляются: дождитесь фоновой проверки или обновите страницу; убедитесь, что процесс проверки статусов активен.
• Файл недоступен для скачивания: по прошествии срока (≈3 дня) скачивание отключается.
• Ошибка одиночной выплаты: проверьте корректность номера карты/телефона, сумму, 2FA, доступ к интеграциям.
• Нет подсказок банка: проверьте сеть или попробуйте набрать больше символов.

Часто задаваемые вопросы (FAQ)