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

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

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

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

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

Раздел «Приём оплат»: онбординг Kaspi-кассы и управление счетами клиентов

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

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

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

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

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

Шаги

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

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

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

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

Управление в разделе «Платежи»

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

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

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

В тест-чате функция симулирует успех (реальный счёт не создаётся) и показывает, что в боевом диалоге клиент получит push. Для боевой проверки выставьте счёт себе на свой номер: он появится в истории раздела «Платежи», там же можно сделать возврат.

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

Симптом	Причина	Что нажать
«оплата временно недоступна»	Платежи не подключены	Пройдите мастер в разделе «Платежи»
Бот просит сумму повторно	Клиент не назвал сумму чётко	Это нормально, бот не выдумывает сумму
Push не пришёл клиенту	Неверный номер или не Kaspi-номер	Уточните у клиента номер, привязанный к Kaspi

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

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

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

Под капотом

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

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

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

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