Платежи и маркетплейс

Подписчики покупают и продлевают доступ в боте и Mini App, а панель создаёт или продлевает подписку, как только платёжная система подтвердит оплату, и бот присылает ссылку.

Включить продажу

1. Настройки → Основное → Продажа подписок или кнопка «Включить продажу» в разделе Платежи. На новых панелях продажа выключена.

2. В Тарифах отметьте тарифы «В продаже» и задайте цену в Stars и/или рублях.

3. В Платежи → Приём оплаты включите Telegram Stars (нужен только работающий бот) или добавьте способ оплаты из маркетплейса.

Там же переключатели «Продавать новым» и «Продление обнуляет трафик». Продление добавляет срок тарифа после текущего и, если не выключено, начинает новый период трафика.

Если в продаже нет ни одного тарифа с ценой для включённого способа оплаты, раздел Платежи предупредит: бот будет только советовать написать в поддержку.

С выключенной продажей бот и Mini App ничего не продают, раздел Платежи пропадает из меню, цены тарифов скрыты. Счета, выставленные раньше, всё равно засчитаются.

Маркетплейс способов оплаты

Платежи → Способы оплаты из маркетплейса → Добавить показывает подписанный каталог getmikan/marketplace: для начала ЮKassa (карты и СБП) и CryptoBot (криптовалюта). Кнопка «Установить» ставит адаптер на сервер отдельным контейнером. На его карточке форма настроек, адрес для уведомлений, который нужно указать в кабинете платёжной системы, и переключатель.

Панель никогда не верит одному уведомлению платёжной системы: она спрашивает счёт у адаптера и сверяет сумму и валюту со своим платежом.

На сервере то же самое делается командами:

mikan addon list               # что работает и что есть в каталоге
mikan addon install yookassa   # поставить или обновить адаптер
mikan addon remove yookassa    # остановить и удалить, настройки и история остаются

Адаптеры ставит только программа mikan на хосте: сама панель Docker не видит.

История и возвраты

В Платежах есть история оплат. Вернуть деньги кнопкой «Вернуть» можно за применённый платёж Telegram Stars. Возврат забирает то, что дал платёж:

• новая подписка отключается, но не удаляется;
• продление теряет купленный срок, а если после оплаты ничего не менялось, возвращаются прежний тариф и лимиты;
• пакет трафика удаляется;
• промокод можно использовать снова.

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