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

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

Як тарифікується бот

Платформа рахує роботу в запитах: кожне доставлене ботом повідомлення списує один запит із балансу акаунту. Баланс — це цілочисельний лічильник; джерелом правди служить незмінний журнал нарахувань і списань (бонус при реєстрації, нарахування тарифу, поповнення, витрата).

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

У розділі Оплата показано поточний баланс і доступні тарифи. У тарифу є назва, ціна і обсяг запитів, а також ліміти (наприклад, максимум ботів). Кнопкою Обрати підключається тариф.

  • Баланс — поточний залишок запитів (видно також на екранах Огляд і Статистика).
  • Прогноз, днів на екрані Статистики оцінює, на скільки вистачить балансу при поточних витратах.

Журнал нарахувань (ledger)

Баланс запитів — це цілочисельний лічильник, але його джерело правди — незмінний журнал операцій (ledger). До нього записується кожна зміна балансу:

  • Бонус при реєстрації — стартовий обсяг запитів новому акаунту.
  • Нарахування тарифу — запити, видані при підключенні тарифу.
  • Поповнення — докуплені запити.
  • Витрата — списання одного запиту за кожне доставлене ботом повідомлення.

Журнал лише доповнюється (старі записи не змінюються), тому історію витрат і нарахувань завжди можна звірити. Поточний баланс — це сума за журналом.

Поповнення

Поповнення створює платіж на потрібний обсяг запитів; після підтвердження провайдером баланс нараховується автоматично і ідемпотентно (повторний коллбек не подвоїть нарахування). Конкретний платіжний провайдер залежить від конфігурації інстансу.

Приймання платежів від користувачів (Telegram Payments)

Бот може приймати і фіксувати платежі Telegram:

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

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

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

Що далі