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

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

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

⏱ 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. Подписка действует (дата в будущем).

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

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

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

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

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

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

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

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

Если проектов несколько, баланс можно перенести с одного на другой: на странице /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-модель
Не получилось? → Бот не отвечает