Cluster · разработчикам

Подписка

Подписка даёт доступ к Telegram-подключению и функциям юзербота. Набор возможностей одинаковый для всех периодов. Лимиты памяти, процессора, процессов и хранилища задаются при запуске сервиса.

Тарифы

Годовой тариф стоит как десять месячных: два месяца бесплатно. Его срок составляет 365 суток.

Продление

Новый срок прибавляется к оставшемуся. Если подписка уже истекла, срок отсчитывается от активации.

После окончания оплаченного периода юзербот работает ещё трое суток. Затем он останавливается. Данные сохраняются 30 суток после остановки, после этого удаляются. Продление в течение срока хранения возвращает доступ.

Повтор тестовой покупки с тем же ID запроса возвращает прежний результат и не добавляет срок ещё раз. Тот же ID с другим периодом отклоняется.

Подарочные коды

Код активируется один раз и добавляет срок выбранного периода: 30, 90 или 365 суток. Бессрочный код включает постоянный доступ без даты окончания.

Администратор создаёт коды для выбранного периода. В одной операции можно создать от 1 до 100 кодов, по умолчанию 10. В базе хранится хеш кода, исходное значение возвращается при создании.

Тестовая оплата

--test-payments включает покупку без списания денег. API возвращает признак тестового режима. Доступны месячный, трёхмесячный и годовой периоды.

Без этого параметра тестовая покупка отклоняется. Подарочные коды продолжают работать независимо от тестовой оплаты.

Stripe

Поддержан обычный Stripe с автоматическим продлением. Managed Payments отключён в запросе создания оплаты. По умолчанию используется песочница. Рабочий режим требует явного mode=live, рабочего ключа и отдельного секрета подписи уведомлений. Ключи и события другого режима отклоняются.

Оплата открывается на странице Stripe. Срок доступа меняется после подтверждённого оплаченного счёта, переход обратно на сайт сам по себе ничего не продлевает. Повторные подтверждения одного счёта не добавляют срок повторно.

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

При действующем доступе начало списаний переносится на его окончание. Подарочный код также переносит следующее списание. Бессрочный код отменяет подписку Stripe. Если перенос не принят провайдером, код остаётся неиспользованным. Stripe ограничивает отложенное начало списаний, поэтому очень большой накопленный срок может потребовать отмены автопродления перед активацией кодов.

Возврат оформляется у провайдера вручную. Подтверждённый возврат прекращает эту подписку Stripe и уменьшает выданный за счёт срок пропорционально возвращённой сумме. Сам Cluster деньги не возвращает. При открытии платёжного спора срок этого счёта отзывается, дальнейший разбор выполняется оператором. Бессрочный доступ при этом не снимается.

При блокировке или удалении профиля подписка Stripe отменяется до изменения состояния профиля. В мини-приложении Telegram нет кнопки оплаты картой. Платежи через Telegram Stars и продажи модулей пока не реализованы.

Порядок настройки, обработка подтверждений и ограничения описаны в PAYMENTS.md.

Операции подписки и их параметры приведены в ROUTES.md, настройки запуска в DEPLOYMENT.md.