Документация › Деньги › Биллинг проекта

Биллинг проекта: токены, подписка, пополнение

Две статьи расходов: токены (топливо для ответов бота) и подписка (доступ к каналам и функциям). Здесь, как пополнять и не остаться без бота.

⏱ 9 мин · 👤 для владельца · 🟢 live

За 30 секунд:

• Токены, расходник: каждый ответ бота их тратит. Кончились → бот молчит в бою.
• Подписка ($25/мес): нужна, чтобы бот отвечал в WhatsApp после бесплатных 14 дней. Telegram, тест-чат, CRM и функции работают и без неё.
• Пополнить можно картой, Kaspi-push или Kaspi QR (без номера телефона; из Кыргызстана через приложение «Мой O!»).
• Баланс показывается в долларах, тенге: в скобках.
• Прогноз подскажет, на сколько дней хватит при текущем расходе.

Зачем это нужно

Бот работает на двух «топливах». Если их перепутать или не следить, бот внезапно замолкает, и клиенты остаются без ответа. Эта статья объясняет, за что ты платишь и как держать бота в эфире.

Где это

Оплата живёт одним окном поверх любой страницы, отдельной страницы у неё нет. Окно открывают:

• плашка баланса в шапке и «Оплата и подписки» в левом меню;
• кнопки «Пополнить», «Продлить», «Оплатить» в любом месте кабинета (карточка бота на «Обзоре», предупреждения, тест-чат, красная плашка сверху).

Внутри пять разделов: баланс (пополнение, подписка, автопополнение, калькулятор расхода), подписки, проекты, история платежей и движений баланса, способы оплаты. Кнопка внутри проекта сразу выбирает в окне этот проект. Старые ссылки вида /billing в письмах и закладках тоже открывают это окно.

Пополнять и оплачивать подписку могут владелец и администратор проекта. Карта оплаты, автопополнение и перенос баланса остаются только у владельца.

Две вещи, которые важно не путать

💵 Цена в долларах, тенге считается от неё. Подписка стоит $25 в месяц, и это базовая цена. Сумма в тенге (около 12 500 ₸) это пересчёт по курсу на момент выставления счёта: курс меняется, значит и сумма списания месяц к месяцу немного отличается. То же с балансом: он ведётся в долларах, а тенге показывается справочно, чтобы понимать порядок списания. Оплатить можно картой казахстанского банка или через Kaspi (push по номеру или QR-код). Из Кыргызстана QR-код Kaspi оплачивают в приложении «Мой O!» (O!Bank).

💡 Аналогия. Подписка это «абонемент в зал» (доступ), токены, «вода, которую пьёшь на тренировке» (расходник). Нужны оба.

Что показывает страница

• Баланс: крупно, в долларах с тенге в скобках («$50.00 (~24 250 ₸)»), полоса заполнения и прогноз на сколько дней хватит при текущем расходе;
• Тариф: твой план, статус проекта (Активна / Канал офлайн / Неактивна), до какой даты подписка, отсчёт триала WhatsApp;
• Счета в ожидании: начатые, но не завершённые оплаты;
• Пополнить / Подписка: единая панель оплаты (переключатель);
• История операций: все пополнения и списания с фильтрами;
• Калькулятор стоимости: прикинуть расход под модель и объём;
• Автопополнение баланса: включил, и платформа сама пополняет баланс, когда он падает ниже порога (см. ниже).

Как пополнить токены

Плашка баланса в шапке (или «Оплата и подписки» в левом меню) → раздел «Баланс», выбери проект:

1. Выбери сумму (готовые: $5 / $10 / $25 / $50 / $100 или впиши свою, целое число долларов, от $5 до $1000);
2. Пополняешь на $100 и больше, дарим сверху $10. Подарок приходит вместе с пополнением, отдельной строкой в истории операций. Своя сумма от сотни считается так же, как готовая плитка;
3. Выбери способ:
4. Картой (TipTopPay): оплата картой;
5. Kaspi Push: введи номер, придёт push в Kaspi;
6. Kaspi QR: номер не нужен, на экране появится QR-код, отсканируй его в Kaspi.kz. Из Кыргызстана его оплачивает приложение «Мой O!» (O!Bank), спишется в сомах по курсу твоего банка. QR живёт около трёх минут: не успел, нажми «Новый QR». Свернул окно, QR остаётся в «Счетах в ожидании» с кнопкой «Показать QR»;
7. Подтверди оплату → баланс пополнится.

Как оформить/продлить подписку

Та же панель → вкладка «Подписка»:

• Выбери период: 1 / 3 / 6 / 12 месяцев (за длинные, скидка: 3 мес −5%, 6 мес −10%, 12 мес −20%);
• Оплати тем же способом.

Скидка первых двух недель

Когда подключишь канал, на 14 дней открывается сниженная цена: месяц −20% ($20), 3 мес −15%, 6 мес −25%, 12 мес −30%. Год в этом окне стоит $210 вместо $300 по обычной цене за месяц. Сколько осталось до конца окна, написано прямо на плитках.

Две вещи, которые важно знать заранее:

• Бесплатные дни не сгорают. Оплатишь, пока они ещё идут, и оплаченный период начнётся после них, а не вместо них. Дата начала показана под кнопкой оплаты.
• Дальше цена обычная. Скидка действует на эту покупку; следующее продление пойдёт по $25 в месяц.

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

⚠️ Без активной подписки после пробного периода бот перестаёт отвечать в WhatsApp (см. Подключить WhatsApp). Номер при этом остаётся привязанным, переписка и настройки никуда не деваются: оплатил, и ответы пошли снова. Telegram работает без подписки: там платишь только за ответы бота с баланса.

Проверь, что всё в порядке

Перед тем как полагаться на бота в бою:

1. Статус проекта, «Активна»;
2. Баланс токенов не на нуле (прогноз показывает запас дней);
3. Подписка действует (дата в будущем).

💡 Помни: в Тест-чате бот отвечает даже при нуле: это не показатель. Для клиентов нужны и баланс, и подписка.

Светофор в списке проектов

Открывать каждый проект не обязательно: в левом меню, в списке «Проекты», у каждого проекта горит значок-индикатор. Статус закодирован формой значка, а не только цветом, различимо и при дальтонизме:

• галочка (зелёная): подписка и баланс в порядке, бот работает;
• треугольник с «!» (жёлтый), скоро проблемы: мало токенов, подписка истекает в ближайшие 3 дня или канал WhatsApp отвалился;
• крестик (красный), бот не отвечает клиентам: баланс на нуле и подписки нет;
• пунктирный кружок (серый) это черновик, проект ещё не запущен.

Наведи курсор на значок: подсказка скажет, что именно не так и куда идти чинить.

Частые ошибки

Автопополнение баланса

На странице биллинга проекта есть секция «Автопополнение баланса» (видна владельцу). Включаешь, платформа каждые ~30 минут проверяет баланс, и если он упал ниже порога (по умолчанию $5), сама пополняет до целевого уровня (по умолчанию $40):

• Счёт в Kaspi: выставляется автосчёт, тебе приходит пуш в Kaspi и уведомление «оплати». Счёт действует 24 часа; пока он висит, новый не выставляется.
• Списание с карты, если у тебя сохранена карта (TipTopPay), сумма списывается автоматически; о каждом списании приходит уведомление.

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

Автопродление подписки

Тумблер «Автосчёт на продление подписки» стоит на той же странице биллинга, отдельной строкой внизу. За 3 дня до конца подписки на номер Kaspi, с которого оплачивали в прошлый раз, придёт счёт на продление, и вместе с ним уведомление, что это автопродление.

• Это счёт, а не списание. Деньги уходят только когда вы сами подтвердите оплату в Kaspi. Не подтвердили, счёт просто истечёт, а подписка закончится в свой срок.
• Включено у тех, кто уже платил через Kaspi. Если оплата через Kaspi была хотя бы раз, автопродление стоит включённым: это тот же способ, которым вы платите, просто счёт приходит сам и вовремя.
• Выключается одним тумблером там же, в биллинге проекта. Он работает отдельно от автопополнения баланса: можно оставить только продление подписки, только пополнение баланса, оба или ничего.

Уведомления о балансе

Платформа сама сообщает о деньгах, эти сигналы включены всегда (их нельзя пропустить):

• Пополнение, как только баланс пополнен (Kaspi, картой или вручную), приходит уведомление с суммой и новым балансом.
• Низкий баланс, когда денег осталось мало, приходит напоминание пополнить (не чаще раза в сутки).
• Бот остановлен на нуле, если баланс кончился и бот перестал отвечать клиентам, приходит тревога, чтобы вы быстро пополнили.

Куда слать, выбираете вы. В настройках проекта → вкладка «Уведомления» → блок «Баланс проекта» отметьте нужные каналы: Telegram-группа, Email, Webhook. Колокольчик в шапке сайта получает эти уведомления всегда: его отключить нельзя, это ваш гарантированный канал.

Перенос баланса между проектами

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

Вопросы, которые обычно возникают

Почему баланс в долларах?
Расходы ИИ считаются в долларах (так считают модели). Тенге показывается в скобках по курсу для удобства.

Подписка и токены это одно и то же?
Нет. Подписка, доступ (фиксированно в месяц). Токены, расходник за ответы. Нужны оба.

Сколько стоит один диалог?
Обычно $0.06-0.13, то есть около 30-60 ₸ по курсу. Это весь разговор целиком: клиент спросил цену, уточнил время и записался. Короткие ответы про цены и адрес обходятся в копейки, долгий подбор по прайсу на сотни страниц стоит дороже. Цифры из расхода живых проектов за 30 дней. Подробно, Сколько стоит сообщение.

Это я плачу платформе. А как брать деньги с моих клиентов?
Это другое, Приём оплат: бот выставляет счёт твоему клиенту, деньги идут на твою Kaspi-кассу.

Под капотом

• Баланс хранится в центах; формат: formatBalanceUSD → "$X.XX (~Y₸)", курс-фолбэк 485 ₸/$.
• Подписка: базовая цена subscription_price_usd = $25 (сумма к оплате в тенге считается по курсу НБК в момент счёта), скидки за период 5/10/20%, в окне активации 20/15/25/30% за 1/3/6/12 месяцев (subscription_offer_discount_*). Цену и для витрины, и для счёта считает один серверный расчёт, он же отдаётся на GET /api/billing/quote.
• Пополнение через useTopup → /api/projects/<projectId>/tokens/topup → провайдер (карта, Kaspi-push или Kaspi QR с method: "qr"). До подтверждения Kaspi-push кабинет показывает окно ожидания, у QR окно с картинкой QR и отсчётом до срока Kaspi (payments.provider_method, checkout_url, expires_at, billing/sql/0101).
• Страница (редизайн 2026-06-05): BalanceHero + PendingInvoices + PaymentPanel (Пополнить|Подписка) + History + калькулятор. Прогноз дней, из среднего расхода по окну транзакций.
• Тест-чат баланс не блокирует; в бою eligibility требует active + (триал ИЛИ подписка) для WhatsApp.
• Автопополнение (2026-06-10): таблица project_auto_topup, cron auto-topup-tick каждые 30 мин; карта, TipTopPay charge по сохранённому токену, Kaspi, автосчёт в Kaspi. Перенос баланса: атомарная пара журнальных проводок через клиринговый счёт.
• Статусы счетов: pending → paid / failed (отклонён банком) / cancelled (отменён вами) / expired (истёк срок); истёкший или отменённый счёт можно выставить заново той же суммой из истории платежей.

Простыми словами

У бота два счёта, и их легко не перепутать на одной аналогии. Подписка это как абонемент: платишь раз в месяц ($25, в тенге около 12 000 ₸ по курсу) и бот работает в WhatsApp. Telegram абонемента не требует. А токены это топливо: каждый ответ бота немного их тратит, как бензин. Если кончится бензин (токены), бот замолчит, даже если абонемент (подписка) активен. Поэтому следи за обоими: пополняй баланс (картой или через Kaspi) и продлевай подписку. На странице есть прогноз, на сколько дней хватит денег: удобно не доводить до нуля. И помни: в тестовом чате бот отвечает всегда, а вот живым клиентам, только когда есть и баланс, и подписка.

Дальше: → Функции (научить бота действиям)
Связано: Сколько стоит сообщение · Приём оплат · Подключить WhatsApp · AI-модель
Не получилось? → Бот не отвечает