Skip to content

Подписки ​

Подписка — платный доступ пользователя к дополнительным функциям платформы.

Обзор ​

На платформе одна подписка с несколькими тарифами, по умолчанию — «Подписка Plus» с тарифами на месяц и на год. Подписка открывает функции, которые администратор отметил как платные. Пользователь выбирает тариф в окне подписки и оплачивает его через подключённого платёжного провайдера; подписка продлевается автоматически, если провайдер это поддерживает.

Подписка настраивается в группе Админ-панель → Монетизация. Подписки пользователей с историей платежей собраны в Админ-панель → Монетизация → Подписки, все платежи со статусами — в Админ-панель → Монетизация → Платежи.

Параметры подписки задаются в Админ-панель → Монетизация → Окно подписки:

  • Слаг: обязателен; строчные латинские буквы, цифры и дефис; используется в ссылках на окно подписки, по умолчанию plus
  • Название: обязательно, до 255 символов
  • Подзаголовок и описание: тексты окна подписки
  • Текст бейджа: короткая метка подписки до 50 символов, например Plus
  • Включить проверку фич подписки: главный переключатель платных функций, см. Функции

Тарифы ​

Тарифы создаются в Админ-панель → Монетизация → Тарифы:

  • Название: обязательно, до 255 символов
  • Слаг: обязателен и уникален
  • Период: месяц или год
  • Стоимость: обязательна
  • Валюта: трёхбуквенный код, по умолчанию RUB
  • Бейдж у тарифа, описание, примечание, первоначальная цена, эквивалент в месяц: тексты карточки тарифа
  • Порядок: порядок тарифов в окне подписки
  • Активен: неактивный тариф нельзя оформить

Оплата продлевает подписку на период тарифа.

Функции ​

Функции — возможности, которые открывает подписка. Они создаются в Админ-панель → Монетизация → Функции; у функции есть название, уникальный код, описание, иконка или медиафайл, порядок, признак выделения и значение для числовых параметров.

Доступ к функции определяется так:

  • Проверка фич подписки выключена: все функции доступны всем пользователям
  • Функция активна: доступна только пользователям с действующей подпиской
  • Функция неактивна или не создана: доступна всем пользователям

После заполнения базы начальными данными проверка включена.

Платформа проверяет функции с кодами:

  • badge: бейдж рядом с именем
  • fancy_nickname: смена адреса профиля
  • video_avatar: видеоаватар
  • private_messages: отправка личных сообщений
  • reactions: весь набор реакций; без функции доступны первые 10 активных реакций
  • reaction_insights: список пользователей, поставивших реакции
  • post_summaries: краткое изложение постов
  • chatgpt_comments: ответы бота в комментариях
  • ad_free: отключение рекламы; действует, только когда проверка включена и функция активна
  • favorite_gifs: сохранение GIF в избранное; значение функции — наибольшее число избранных GIF, без значения число не ограничено
  • comment_edit_minutes: время редактирования комментариев в минутах из значения функции вместо общего

Оплата ​

Платёжный провайдер подключается в Админ-панель → Монетизация → Провайдер:

  • ЮKassa: Shop ID и секретный ключ
  • T-Bank: Terminal Key и секретный ключ

Для ЮKassa в личном кабинете провайдера указывается URL уведомлений {APP_URL}/payments/yookassa/result.

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

Продление и отмена ​

Подписка продлевается в течение часа после окончания срока.

Пользователь отменяет подписку в Настройки → Основные. Отменённая подписка сразу перестаёт действовать и не продлевается. Если оплатить подписку снова до окончания оплаченного срока, новый период добавляется к прежней дате окончания.

Released under the MIT License.