Коротко
@QutPayBot — один общий бот для всех организаций. Через него можно выставлять счета, смотреть выручку за день и получать уведомления об оплатах, не открывая кабинет.
Порядок простой: в кабинете берёте код привязки, пишете боту /start КОД — в личном чате или в группе, — и этот чат связывается с организацией. После этого работают команды, а уведомления об оплатах приходят в тот же чат.
Команды
| Команда | Что делает |
|---|---|
/start КОД | Привязывает чат к организации. Код берётся в кабинете, живёт 15 минут |
/invoice 5000 | Создаёт счёт с QR и ссылкой на оплату |
/invoice 5000 77001234567 | Отправляет счёт прямо в приложение Kaspi покупателя |
/invoice 5000 Консультация | Счёт с описанием |
/invoice 5000 77001234567 Консультация | На телефон и с описанием |
/today | Выручка за сегодня, все оплаченные счета, число открытых |
/last | Последние 10 счетов: время, сумма, статус, идентификатор |
/status inv_… | Статус одного счёта и его чек |
/cancel inv_… | Отменяет счёт |
/support текст | Отправляет вопрос в поддержку, ответ придёт в этот же чат |
/unlink | Отвязывает чат от организации |
/help | Краткий список команд |
Команды можно выбирать и из меню Telegram — бот регистрирует список сам.
Русские и казахские варианты
Запоминать английские названия не обязательно, эти варианты тоже работают:
| Вариант | Основная команда |
|---|---|
/счет, /счёт, /шот, /inv | /invoice |
/сегодня, /бүгін | /today |
/статус | /status |
/отмена | /cancel |
/помощь, /қолдау, /көмек | /support |
В личном чате команду можно не писать вовсе: сообщение, которое начинается с числа, считается запросом на счёт. Напишете 5000 Урок — получите счёт на 5000 тенге с описанием «Урок».
Телефон распознаётся в любой записи: 8 700 123 45 67, +77001234567, 7701-123-45-67.
Кнопки под ответом
Когда счёт создан, бот присылает его карточку: сумма, описание, статус, срок и идентификатор. Под карточкой — кнопки:
- 💳 Страница оплаты — ссылка, которую отправляют покупателю (для QR-счёта);
- 🔄 Статус — обновляет статус прямо в этом сообщении;
- 🚫 Отменить — показывается, только пока счёт открыт.
В режиме песочницы на карточке стоит пометка (sandbox) — по ней видно, что реальных денег нет.
Если счёт отменён, но срок QR ещё не истёк, покупатель может успеть оплатить. Бот предупреждает об этом и присылает уведомление, когда деньги всё-таки приходят.
Работа в группе
Бота можно добавить в рабочую группу — тогда кассиры или менеджеры выставляют счета из одного места, а уведомления об оплате видят все сразу.
- Добавьте бота в группу.
- Напишите в группе
/start КОД(код из кабинета). - Чтобы бот видел команды в группе, нужно одно из двух: @BotFather →
/setprivacy→ Disable, либо сделать бота администратором группы. Иначе Telegram не передаёт боту сообщения группы, и он молчит.
Счёт в группе может создать любой участник. Бот не разбирает роли, поэтому состав группы — ваша ответственность. Деньги всё равно приходят только на ваш счёт в Kaspi, но лишние счета путают отчётность.
В группе счёт «голым числом» не создаётся — там нужна полная команда /invoice.
Какие уведомления приходят
В привязанный чат приходит следующее:
| Уведомление | Когда |
|---|---|
| ✅ ОПЛАЧЕНО | Счёт оплачен. Сумма, описание, номер заказа, данные клиента, номер чека |
| ↩️ Возврат / Частичный возврат | Когда возврат прошёл, с суммой возврата |
| ⌛ Истёк срок | Счёт так и не оплатили |
| 🚫 Отменён | Счёт отменили |
| ❌ Платёж не прошёл | Kaspi не провёл оплату |
| ⚠️ Предупреждение | Оборвалась привязка кассира Kaspi — со ссылкой на переподключение |
Если у счёта есть номер чека, к сообщению добавляется кнопка 🧾 Чек. Пометка ПОЗДНЯЯ ОПЛАТА означает, что счёт был закрыт раньше, а деньги пришли позже: решать вам — выдать услугу или вернуть средства.
К одной организации можно привязать несколько чатов — уведомления уходят во все сразу.
Код привязки к организации
Код создаётся в кабинете: Настройки → Telegram-бот → получить код привязки.
- Код действует 15 минут и срабатывает один раз.
- Писать его можно и в личном чате, и в группе — привязывается тот чат, где он написан.
- Кабинет даёт и ссылку: открываете её, бот запускается и отправляет код сам.
- Если срок истёк, просто возьмите новый код.
Чтобы разорвать связь, напишите в этом чате /unlink или удалите чат из списка в кабинете.
Чего бот не делает
- Возвраты не оформляются. Возврат денег доступен только в кабинете и через API — это сделано намеренно, потому что чат бота может быть открыт многим.
- Настройки не меняются. Ключи, вебхуки, тариф, кассир — всё в кабинете.
- Счета чужой организации не видны. Один чат привязан ровно к одной организации.
Если бот молчит
Три самые частые причины: чат не привязан, в группе не выключен режим приватности, бот заблокирован. Пошаговая проверка: Telegram-бот молчит.
Вопросы и ответы
Можно ли подключить своего бота? В кабинете можно указать токен собственного бота и получать уведомления в него. Команды при этом работают через общий @QutPayBot.
Работает ли /support, если чат не привязан? Да. Если вы хотя бы раз входили в кабинет через Telegram, бот найдёт организацию по вашему номеру. Если не найдёт — предложит WhatsApp и почту: Как написать в поддержку.
Виден ли счёт из бота в кабинете? Да, все счета в одном списке. Канал, через который счёт создан, сохраняется.
Что увидит клиент при счёте на телефон? Счёт придёт в его приложение Kaspi: сумма, описание и номер вашего кассира. Подробнее: Что видит покупатель.
Я хочу продавать в боте товары, а не просто выставлять счета. Это отдельный сценарий: Продажи через Telegram-бота.