Salebot + Qut Pay: счёт Kaspi из бота
Собрали бота в Salebot и продаёте через WhatsApp, Telegram или Instagram? После оформления заказа бот сам отправит клиенту счёт Kaspi: он придёт в приложение Kaspi.kz клиента. Когда клиент оплатит, бот это проверит и напишет «Оплачено». Всё делается одним HTTP-запросом, программист не нужен.
Qut Pay и Salebot — разные сервисы, мы не партнёры. Бот обращается к API Qut Pay через стандартный блок Salebot «API-запрос».
Что нужно
| Где | Что |
|---|---|
| Qut Pay | Кабинет qut.kz/app, подключённый кассир Kaspi Pay и API-ключ (Кабинет → Интеграции → API-ключи) |
| Salebot | Тариф с API-функциями: в Salebot они работают только на тарифах «Бизнес» и «Инфобиз» |
| В боте | Переменные, где сохранены телефон клиента и сумма, например phone и amount |
Сначала проверьте с тестовым ключом (qp_test_…): счёт создаётся, но деньги ни с кого не списываются.
1. Блок создания счёта
Откройте в боте блок, где подтверждается заказ, и добавьте раздел API-запрос:
- Тип:
POST-json - URL:
https://api.qut.kz/api/v1/invoices - Заголовок запроса (JSON):
{"X-API-Key": "qp_live_…", "Content-Type": "application/json"}
- JSON параметры:
{
"kind": "phone",
"amount": #{amount},
"description": "Заказ #{order_id}",
"externalOrderId": "#{order_id}",
"idempotencyKey": "salebot-#{order_id}",
"customer": { "phone": "#{phone}" }
}
- Сохраняемые значения из ответа:
id->qp_invoice_id; status->qp_status; payUrl->qp_pay_url; error->qp_error
#{...} — переменные Salebot, подставьте названия из своего бота.
| Поле | Зачем |
|---|---|
kind: "phone" | Счёт приходит прямо в приложение Kaspi.kz клиента, ссылку отправлять не нужно. Сумма — только целые тенге |
amount | Сумма в тенге: 12000 |
customer.phone | Номер, на который у клиента зарегистрирован Kaspi. Подходят +7 701 123 45 67, 87011234567, 77011234567 |
idempotencyKey | Если клиент нажмёт кнопку дважды или бот повторит запрос, второй счёт не создастся — вернётся прежний. Для каждого заказа свой |
description | Комментарий, который клиент увидит в Kaspi |
Если запрос прошёл, qp_status = pending, а qp_invoice_id = inv_…. Пусть бот напишет: «Счёт на 12 000 ₸ отправлен в ваше приложение Kaspi. После оплаты напишите «Оплатил»».
Если пришёл qp_error, счёт не создан. Например, invalid_phone — номер неверный, kaspi_customer_not_found — этого номера нет в Kaspi. В обоих случаях попросите у клиента номер, на который зарегистрирован Kaspi.
2. Блок проверки оплаты
Когда клиент пишет «Оплатил» или нажимает кнопку «Проверить», запросите состояние счёта:
- Тип:
GET - URL:
https://api.qut.kz/api/v1/invoices/#{qp_invoice_id} - Заголовок запроса: как в шаге 1
- Сохраняемые значения из ответа:
status->qp_status
Затем блоком с условием проверьте qp_status:
qp_status | Значение | Что пишет бот |
|---|---|---|
paid | Оплачено | «✅ Оплата получена, спасибо!» — и ведёт заказ дальше |
pending | Ещё не оплачено | «Счёт в вашем приложении Kaspi, после оплаты напишите ещё раз» |
failed | Kaspi не принял счёт: номера нет в Kaspi или клиент отказался | «Счёт на этот номер не дошёл. Напишите номер, на который зарегистрирован Kaspi» → снова в блок 1 с новым номером |
expired | Срок счёта истёк | Снова в блок 1, новый счёт |
cancelled | Вы отменили счёт в кабинете | Передать менеджеру |
При повторной отправке на новый номер поменяйте idempotencyKey, например salebot-#{order_id}-2. Иначе вернётся прежний счёт.
3. Уведомление об оплате для вас
Вы узнаете об оплате, даже если клиент не напишет «Оплатил»:
- Telegram: подключите Telegram в кабинете Qut Pay — сообщение придёт о каждой оплате.
- Кабинет: в разделе Счета видны состояние каждого счёта, номер клиента и
externalOrderId.
Для ботов в Telegram и Instagram
В WhatsApp используйте kind: "phone": счёт приходит в приложение Kaspi без ссылки. Если в Telegram или VK удобнее отправить клиенту ссылку, уберите kind. Тогда придёт qp_pay_url (https://qut.kz/pay/inv_…) — страница с QR и кнопкой «Оплатить в Kaspi». Пусть бот отправит эту ссылку. QR действует около 3 минут, после этого страница сама предложит новый.
Проверка
- Создайте в кабинете тестовый ключ (
qp_test_…) и вставьте его в заголовок блока 1. - Сделайте заказ в боте сами. В кабинете появится тестовый счёт.
- Откройте этот счёт в кабинете и нажмите «[Sandbox] оплачен». Номер
77000000404— для проверки случая «клиента нет в Kaspi». - Напишите боту «Оплатил». Бот должен ответить «✅ Оплата получена».
- Если всё работает, замените ключ на
qp_live_….
Частые ошибки
| Ответ | Причина | Что делать |
|---|---|---|
401 unauthorized | Ключ неверный или его нет в заголовке | Проверьте, что X-API-Key написан верно и ключ не удалён |
403 insufficient_scope | У ключа нет прав | Нужны invoices:write и invoices:read |
422 invalid_phone | В номере не 11 цифр | Попросите номер заново |
422 kaspi_customer_not_found | Этого номера нет в Kaspi | Не повторяйте с тем же номером, попросите номер Kaspi |
422 amount_must_be_whole_tenge | При kind: "phone" есть тиыны | Округлите сумму до целых тенге |
429 tariff_limit_reached | Исчерпан месячный лимит тарифа | Кабинет → Тариф |
503 kaspi_session_expired | Связь с кассиром Kaspi прервалась | Переподключите кассира в кабинете |
qp_status = failed | Клиент отказался или Kaspi не принял счёт | Свяжитесь с клиентом; при необходимости отправьте заново с новым idempotencyKey |
Стоимость
Входит в тариф Qut Pay, отдельно не оплачивается. В месячный лимит тарифа идут только оплаченные счета. Kaspi удерживает свою комиссию отдельно. Тариф Salebot — сам по себе. Подробнее: тарифы.
Помощь
Если не получается, пришлите скриншот блока (ключ скройте) в WhatsApp +7 778 881 3333 или в Telegram @qutpaybot. Полное описание API: интеграция с сайтом, для ИИ-агентов: api.qut.kz/llms.txt.
Нужна помощь? WhatsApp +77788813333 · kazprose@gmail.com · 09:00–21:00 (Алматы)
Можно написать и из кабинета: Поддержка.
Qut Pay — независимый сервис, не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки правообладателя.