Документация › Инструменты бота › Бот выставляет счёт

Бот выставляет счёт (Kaspi)

Обновлено 11 октября 2026 г.

Бот сам выставляет клиенту счёт прямо в чате: клиент платит через push в Kaspi, деньги идут на вашу Kaspi-кассу.

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

За 30 секунд:
  • Клиент готов платить → бот создаёт счёт → клиенту приходит push в приложение Kaspi.
  • Деньги идут напрямую на вашу Kaspi-кассу.
  • Сначала подключите платежи в разделе «Приём оплат» проекта.
  • Бот сам спрашивает у клиента сумму и номер, не выдумывает.
  • Отправив счёт, бот называет номер вслух и предлагает перевыставить, если Kaspi на другом телефоне.
Раздел «Приём оплат»: онбординг Kaspi-кассы и управление счетами клиентов
Раздел «Приём оплат»: онбординг Kaspi-кассы и управление счетами клиентов

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

Чтобы не уводить клиента из переписки на сторонние ссылки. Договорились, бот тут же выставил счёт, клиент подтвердил оплату в Kaspi, не выходя из диалога. Меньше шагов, больше оплат.

📌 Пример (интернет-магазин). Клиент: «беру, сколько с меня?» Бот: «3 500 ₸, отправляю счёт на ваш номер». Клиенту приходит push в Kaspi, он подтверждает, заказ оплачен.

Что понадобится

  • ☐ Подключённые платежи: раздел «Приём оплат» проекта (мастер подключения)
  • ☐ Kaspi-касса бизнеса

Шаги

  1. Подключите платежи: Интеграции → Приём оплат и пройдите мастер. Без этого функция вежливо ответит клиенту, что оплата временно недоступна.
  2. Функции → Новая функция → Из готового шаблона → Приём оплаты (Kaspi) → Выставить счёт на оплату.
  3. (необязательно) Задайте описание по умолчанию: оно появится в Kaspi-push и чеке, если бот не передаст своё.
  4. В поле «Когда боту это вызывать» опишите момент: «когда клиент согласился оплатить и назвал сумму, выстави счёт».

Что бот собирает у клиента

  • Сумму в тенге (минимум 50, максимум 10 000 000);
  • Номер телефона, привязанный к Kaspi (любой казахстанский формат);
  • За что платит, короткая строка для чека.

Клиенту приходит push в приложение Kaspi: подтвердить нужно в течение 30 минут.

Управление в разделе «Приём оплат»

После подключения раздел «Приём оплат» показывает всё по оплатам проекта, обновляется сам, без перезагрузки страницы:

  • Сводка сверху: сколько получено за месяц и всего, сколько счетов ждут оплаты, сумма возвратов.
  • История счетов: кто, когда, на сколько и статус каждого счёта. Фильтр по статусу (все / ждут оплаты / оплачены / возвраты / отменены) и экспорт в CSV (для бухгалтерии).
  • Выставить счёт вручную, кнопка для счёта без диалога: указываете сумму, номер клиента и описание, клиенту приходит push в Kaspi.
  • Отменить неоплаченный счёт, если клиент передумал, счёт можно закрыть, чтобы он не висел.
  • Вернуть оплату по оплаченному счёту можно сделать возврат: полностью или часть суммы. Деньги уходят обратно на Kaspi клиента.

Проверь, что работает

В тест-чате счёт выставляется по-настоящему: назовите боту свой номер и получите push в Kaspi (или ссылку на оплату). Сумма тестового счёта всегда 100 ₸ (у кассы в сомах 100 сом): настоящую цену бот называет словами, а тест-чат пишет её пометкой под счётом. Счёт помечен «ТЕСТ» и через 10 минут откатывается сам: оплата возвращается, неоплаченный счёт отменяется, сбор платформы за тестовую оплату не берётся. Платить не обязательно: достаточно увидеть push. Счёт появится в истории раздела «Приём оплат».

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

СимптомПричинаЧто нажать
«оплата временно недоступна»Платежи не подключеныПройдите мастер в разделе «Приём оплат»
Бот просит сумму повторноКлиент не назвал сумму чёткоЭто нормально, бот не выдумывает сумму
Бот говорит клиенту «на этом номере Kaspi не найден»Клиент назвал номер, к которому Kaspi не привязан. Платформа уточняет это у Kaspi, счёт не выставляетсяНичего: бот сам просит номер, к которому привязан Kaspi, и выставляет счёт на него. Тревога владельцу в этом случае не приходит, касса исправна
Push не пришёл клиентуНеверный номер или не Kaspi-номерБот называет номер прямо в сообщении о счёте: клиенту достаточно ответить, что Kaspi на другом телефоне, и бот выставит счёт заново сам. Если он этого не сделал, уточните номер и выставьте счёт вручную

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

Где деньги, у DOS?
Нет. Деньги идут напрямую на вашу Kaspi-кассу. DOS, только софт, который помогает выставить счёт.

Какая минимальная сумма?
50 ₸.

Под капотом

  • Встроенная функция builtin_owner_payment: создаёт счёт в кассе владельца и шлёт Kaspi-push. Валидация суммы (50 … 10 000 000 ₸) и номера: до обращения к провайдеру.
  • Структурированные коды ошибок (sub_merchant_not_connected, kaspi_auth_lost и т.п.) дают боту понять, как ответить клиенту.
  • В тест-чате счёт настоящий, но тестовый, всегда на 100 ₸: бот называет настоящую цену и говорит, что через 10 минут оплата вернётся, а неоплаченный счёт отменится. Сказать «выставил», не вызвав функцию, бот не может ни в тесте, ни в бою: платформа сверяет слова с действиями после каждого ответа.

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

Раньше, чтобы взять оплату, нужно было кидать клиенту ссылку или реквизиты и надеяться, что он дойдёт. Теперь бот прямо в чате выставляет счёт, клиенту в Kaspi прилетает «оплатить 3 500 ₸?», он жмёт «да», и всё. Деньги: сразу на вашу кассу.

Дальше: → Письмо клиенту
Связано: Функции
Не получилось? → Функция не срабатывает