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

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

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

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

За 30 секунд:

• Клиент готов платить → бот создаёт счёт → клиенту приходит push в приложение 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. Для боевой проверки выставьте счёт себе на свой номер — он появится в истории раздела «Платежи», там же можно сделать возврат.

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

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

Где деньги — у 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 ₸?», он жмёт «да», и всё. Деньги — сразу на вашу кассу.

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