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

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

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

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

За 30 секунд:

• Токены, расходник: каждый ответ бота их тратит. Кончились → бот молчит в бою.
• Подписка ($25/мес ≈ 12 500 ₸): доступ к WhatsApp/Telegram, всем моделям, CRM, аналитике, функциям.
• Пополнить можно картой (TipTopPay) или Kaspi-push (apipay).
• Баланс показывается в долларах, тенге: в скобках.
• Прогноз подскажет, на сколько дней хватит при текущем расходе.

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

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

Где это

• По проекту: меню проекта → «Биллинг».
• По всему аккаунту: глобальное меню → «Биллинг» (общий счёт, все проекты, история).

Смотреть и пополнять может любой участник; управление подпиской: владелец.

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

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

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

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

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

Меню проекта → «Биллинг» → вкладка «Пополнить баланс»:

1. Выбери сумму (готовые: $5 / $10 / $20 / $50 / $100 или впиши свою, целое число долларов, от $5 до $1000);
2. Выбери способ:
3. Картой (TipTopPay): оплата картой;
4. Kaspi Push (apipay): введи номер, придёт push в Kaspi;
5. Подтверди оплату → баланс пополнится.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Там же, тумблер «Автосчёт на продление подписки»: за 3 дня до конца подписки придёт счёт на продление в Kaspi.

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

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

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

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

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

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

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

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

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

Сколько стоит один диалог?
Примерно $0.001-0.01 в зависимости от модели и длины. Подробно, Сколько стоит сообщение.

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

Под капотом

• Баланс хранится в центах; формат: formatBalanceUSD → "$X.XX (~Y₸)", курс-фолбэк 485 ₸/$.
• Подписка: базовая цена subscription_price_kzt (фолбэк 12 500 ₸ ≈ $25), скидки за период 5/10/20%.
• Пополнение через useTopup → /api/tokens/topup → провайдер (TipTopPay карта / apipay Kaspi-push). Kaspi показывает ApipayPendingModal до подтверждения.
• Страница (редизайн 2026-06-05): BalanceHero + PendingInvoices + PaymentPanel (Пополнить|Подписка) + History + калькулятор. Прогноз дней, из среднего расхода по окну транзакций.
• Тест-чат баланс не блокирует; в бою eligibility требует active + (триал ИЛИ подписка) для WhatsApp.
• Автопополнение (2026-06-10): таблица project_auto_topup, cron auto-topup-tick каждые 30 мин; карта, TipTopPay charge по сохранённому токену, Kaspi, автосчёт apipay. Перенос баланса: атомарная пара журнальных проводок через клиринговый счёт.
• Статусы счетов: pending → paid / failed (отклонён банком) / cancelled (отменён вами) / expired (истёк срок); истёкший или отменённый счёт можно выставить заново той же суммой из истории платежей.

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

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

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