Платежи и баланс

В GetMyBot два разных «платёжных» контура: баланс запросов платформы (за работу бота) и приём платежей от пользователей бота через Telegram. Раздел Оплата (он же «Приём платежей») управляет тарифами и балансом.

Как тарифицируется бот

Платформа считает работу в запросах: каждое доставленное ботом сообщение списывает один запрос с баланса аккаунта. Баланс — это целочисленный счётчик; источником правды служит неизменяемый журнал начислений и списаний (бонус при регистрации, начисления тарифа, пополнения, расход).

Тарифы и баланс

В разделе Оплата показан текущий баланс и доступные тарифы. У тарифа есть название, цена и объём запросов, а также лимиты (например, максимум ботов). Кнопкой Выбрать подключается тариф.

  • Баланс — текущий остаток запросов (виден также на экранах Обзор и Статистика).
  • Прогноз, дней на экране Статистики оценивает, на сколько хватит баланса при текущем расходе.

Журнал начислений (ledger)

Баланс запросов — это целочисленный счётчик, но его источник правды — неизменяемый журнал операций (ledger). В него записывается каждое изменение баланса:

  • Бонус при регистрации — стартовый объём запросов новому аккаунту.
  • Начисление тарифа — запросы, выданные при подключении тарифа.
  • Пополнение — докупленные запросы.
  • Расход — списание одного запроса за каждое доставленное ботом сообщение.

Журнал только дополняется (старые записи не меняются), поэтому историю расходов и начислений всегда можно сверить. Текущий баланс — это сумма по журналу.

Пополнение

Пополнение создаёт платёж на нужный объём запросов; после подтверждения провайдером баланс начисляется автоматически и идемпотентно (повторный коллбэк не задвоит начисление). Конкретный платёжный провайдер зависит от конфигурации инстанса.

Приём платежей от пользователей (Telegram Payments)

Бот может принимать и фиксировать платежи Telegram:

  • Запрос pre_checkout_query подтверждается автоматически.
  • Успешный платёж (successful_payment) записывается (сумма, валюта, идентификатор операции, payload), а затем может сработать реакция — например, выдать доступ, поставить метку «оплатил» и записать заказ в коллекцию.

Сумму успешных платежей видно в Аналитике («Платежи»).

Выставление счёта (sendInvoice) и кнопки «Приём платежа» / «Уведомление» в конструкторе кнопок пока размечены как «скоро»: бот фиксирует входящие платежи, но инициировать счёт из реакции в текущей версии нельзя.

Что дальше