Qut Pay Сайт Кабинет База знаний Инструкции Документация API ҚАЗРУС
Главная → База знаний → Начало работы

Счёт Kaspi из бота в Salebot

Обновлено: 2026-11-18 · Версия в Markdown

Коротко

Бот, собранный в Salebot, может сам отправлять счёт Kaspi. Для этого в блок, где подтверждается заказ, добавьте раздел Salebot «API-запрос» и отправьте один запрос в API Qut Pay. Счёт придёт в приложение Kaspi.kz клиента. Когда клиент напишет «Оплатил», вторым запросом проверьте состояние счёта. Программист не нужен. Полная инструкция: api.qut.kz/docs/guide/salebot.

Qut Pay и Salebot — разные сервисы, мы не партнёры. В Salebot API-функции работают только на тарифах «Бизнес» и «Инфобиз».

Блок создания счёта

ПолеЗначение
ТипPOST-json
URLhttps://api.qut.kz/api/v1/invoices
Заголовок запроса{"X-API-Key": "qp_live_…", "Content-Type": "application/json"}
JSON параметры{"kind": "phone", "amount": #{amount}, "description": "Заказ #{order_id}", "idempotencyKey": "salebot-#{order_id}", "customer": {"phone": "#{phone}"}}
Сохраняемые значенияid->qp_invoice_id; status->qp_status; error->qp_error

kind: "phone" отправляет счёт прямо в приложение Kaspi клиента, поэтому ссылку в WhatsApp слать не нужно. Сумма — только целые тенге. Почему phone удобнее, читайте в статье QR или счёт на телефон.

idempotencyKey нужен, чтобы при двойном нажатии не создался второй счёт. Подробнее: повторный запрос.

Блок проверки оплаты

ПолеЗначение
ТипGET
URLhttps://api.qut.kz/api/v1/invoices/#{qp_invoice_id}
Заголовок запросакак в блоке создания
Сохраняемые значенияstatus->qp_status

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

Salebot не принимает вебхуки Qut Pay напрямую, поэтому состояние запрашивается, когда клиент пишет или нажимает кнопку. А вам о каждой оплате сообщит Telegram, подключённый в кабинете Qut Pay.

Сначала в тестовом режиме

  1. Кабинет → Интеграции → API-ключи → создайте тестовый ключ (qp_test_…) (API-ключи).
  2. Сделайте заказ в боте сами — в кабинете появится тестовый счёт.
  3. Откройте счёт и нажмите «[Sandbox] оплачен».
  4. Напишите боту «Оплатил» — бот должен ответить «✅ Оплата получена».
  5. Затем замените ключ на qp_live_….

Частые вопросы

Это платно?

Входит в тариф Qut Pay, отдельно не оплачивается. В месячный лимит идут только оплаченные счета. Kaspi удерживает свою комиссию отдельно. Тариф Salebot — сам по себе.

Номер клиента сохранён как «+7 701 …» — подойдёт?

Да. +7 701 123 45 67, 87011234567 и 77011234567 Qut Pay сам приводит к 11 цифрам.

Что делать в Telegram-боте?

Уберите kind — в ответе придёт payUrl, страница с QR и кнопкой «Оплатить в Kaspi». Добавьте в сохраняемые значения payUrl->qp_pay_url и отправьте ссылку клиенту.

Безопасно ли ставить ключ в бота?

Ключ хранится на сервере Salebot, клиент его не видит. Но не отправляйте его в чат, на скриншоты или в открытые документы. Если ключ утёк, удалите его в кабинете и создайте новый.

Связанные статьи

Создание счёта: все поляПолный справочник по POST /api/v1/invoices — тип и ограничение каждого поля, все поля ответа, примеры на curl и Node, разница между qr и phone и список частых ошибок с решениями.QR-счёт или счёт по телефону — что выбратьПолное сравнение двух типов счёта: значение kind, что делает покупатель, нужен ли номер, ограничения описания и суммы, срок жизни и таблица сценариев с рекомендацией по каждому.У покупателя нет приложения Kaspi — как принять оплатуСчёт по телефону (kind phone) приходит в приложение Kaspi покупателя, и без приложения он просто не дойдёт. Вместо него нужен QR или ссылка на оплату. Как проверить заранее.Идемпотентность: защита от дублейКак работает заголовок Idempotency-Key, как правильно составить ключ, какова роль externalOrderId, и как защититься от повторов при обработке вебхуков и при возвратах.API-ключи — создание, хранение, ротацияЧем отличаются ключи qp_live_ и qp_test_, как создать ключ в кабинете, где его хранить и где хранить категорически нельзя, зачем отдельный ключ на каждую интеграцию, как заменить ключ без простоя и что происходит при удалении.

Остались вопросы? WhatsApp +77788813333 · kazprose@gmail.com
Написать можно и из кабинета: Поддержка.

Qut Pay — независимый сервис, не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.