Коротко
Бот, собранный в Salebot, может сам отправлять счёт Kaspi. Для этого в блок, где подтверждается заказ, добавьте раздел Salebot «API-запрос» и отправьте один запрос в API Qut Pay. Счёт придёт в приложение Kaspi.kz клиента. Когда клиент напишет «Оплатил», вторым запросом проверьте состояние счёта. Программист не нужен. Полная инструкция: api.qut.kz/docs/guide/salebot.
Qut Pay и Salebot — разные сервисы, мы не партнёры. В Salebot API-функции работают только на тарифах «Бизнес» и «Инфобиз».
Блок создания счёта
| Поле | Значение |
|---|---|
| Тип | POST-json |
| URL | https://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 |
| URL | https://api.qut.kz/api/v1/invoices/#{qp_invoice_id} |
| Заголовок запроса | как в блоке создания |
| Сохраняемые значения | status->qp_status |
Затем проверьте блоком с условием:
paid— «✅ Оплата получена».pending— «Счёт в вашем приложении Kaspi, после оплаты напишите ещё раз».failed— счёт не дошёл. Попросите у клиента номер Kaspi и отправьте заново с новымidempotencyKey(если у клиента нет Kaspi).expired— срок истёк, создайте новый счёт.
Salebot не принимает вебхуки Qut Pay напрямую, поэтому состояние запрашивается, когда клиент пишет или нажимает кнопку. А вам о каждой оплате сообщит Telegram, подключённый в кабинете Qut Pay.
Сначала в тестовом режиме
- Кабинет → Интеграции → API-ключи → создайте тестовый ключ (
qp_test_…) (API-ключи). - Сделайте заказ в боте сами — в кабинете появится тестовый счёт.
- Откройте счёт и нажмите «[Sandbox] оплачен».
- Напишите боту «Оплатил» — бот должен ответить «✅ Оплата получена».
- Затем замените ключ на
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, клиент его не видит. Но не отправляйте его в чат, на скриншоты или в открытые документы. Если ключ утёк, удалите его в кабинете и создайте новый.