Qut PayСайтКабинетБаза знанийAPI (OpenAPI)Инструкция для ИИРУСҚАЗEN

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-запрос:

{"X-API-Key": "qp_live_…", "Content-Type": "application/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. Блок проверки оплаты

Когда клиент пишет «Оплатил» или нажимает кнопку «Проверить», запросите состояние счёта:

Затем блоком с условием проверьте qp_status:

qp_statusЗначениеЧто пишет бот
paidОплачено«✅ Оплата получена, спасибо!» — и ведёт заказ дальше
pendingЕщё не оплачено«Счёт в вашем приложении Kaspi, после оплаты напишите ещё раз»
failedKaspi не принял счёт: номера нет в Kaspi или клиент отказался«Счёт на этот номер не дошёл. Напишите номер, на который зарегистрирован Kaspi» → снова в блок 1 с новым номером
expiredСрок счёта истёкСнова в блок 1, новый счёт
cancelledВы отменили счёт в кабинетеПередать менеджеру

При повторной отправке на новый номер поменяйте idempotencyKey, например salebot-#{order_id}-2. Иначе вернётся прежний счёт.

3. Уведомление об оплате для вас

Вы узнаете об оплате, даже если клиент не напишет «Оплатил»:

Для ботов в Telegram и Instagram

В WhatsApp используйте kind: "phone": счёт приходит в приложение Kaspi без ссылки. Если в Telegram или VK удобнее отправить клиенту ссылку, уберите kind. Тогда придёт qp_pay_url (https://qut.kz/pay/inv_…) — страница с QR и кнопкой «Оплатить в Kaspi». Пусть бот отправит эту ссылку. QR действует около 3 минут, после этого страница сама предложит новый.

Проверка

  1. Создайте в кабинете тестовый ключ (qp_test_…) и вставьте его в заголовок блока 1.
  2. Сделайте заказ в боте сами. В кабинете появится тестовый счёт.
  3. Откройте этот счёт в кабинете и нажмите «[Sandbox] оплачен». Номер 77000000404 — для проверки случая «клиента нет в Kaspi».
  4. Напишите боту «Оплатил». Бот должен ответить «✅ Оплата получена».
  5. Если всё работает, замените ключ на 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 — товарные знаки правообладателя.