Qut Pay · Salebot боттарына
Salebot-тағы бот Kaspi шотын өзі жібереді
Клиент боттан тапсырыс береді — шот оның Kaspi.kz қосымшасына түседі. Клиент төлеп, «Төледім» деп жазады, бот тексеріп, тапсырысты әрі қарай жүргізеді. Бір «API-запрос» блогымен бапталады, бағдарламашы керек емес.
0 ₸
Qut Pay тарифінен бөлек ақы жоқ
- Айлық лимитке тек төленген шоттар есептеледі
- Kaspi өз комиссиясын бөлек ұстайды
- Алдымен тест режимінде сынауға болады
Қалай жұмыс істейді
Клиент тапсырыс береді
Бот соманы және телефон нөмірін біледі — Salebot сценарийіңіздегідей.
Бот шот жібереді
«API-запрос» блогы Qut Pay-ге бір сұраныс жібереді. Шот клиенттің Kaspi.kz қосымшасына сілтемесіз түседі.
Клиент төлейді
Сосын «Төледім» деп жазады не «Тексеру» батырмасын басады.
Бот тексереді
Екінші сұраныс шот күйін қайтарады: paid болса, бот рақмет айтып, тапсырысты әрі қарай жүргізеді.
Не аласыз
Сілтемесіз шот
kind: "phone" шотты клиенттің Kaspi қосымшасына тікелей жібереді. WhatsApp-та сілтеме жіберудің қажеті жоқ.
Қос шот болмайды
Тапсырыс нөмірімен idempotencyKey: клиент екі рет басса, сол шот қайтады.
Kaspi-де жоқ нөмір
Нөмір Kaspi-де болмаса, API соны айтады — бот Kaspi нөмірін сұрап, шотты қайта жіберетін тармақ баптайсыз.
Сізге хабар
Әр төлем туралы Qut Pay кабинетіне қосылған Telegram-ға хабар келеді. Тапсырыс нөмірлерімен барлық шот кабинетте.
Telegram-ға сілтеме
Telegram не VK-да сілтеме жіберуге болады: QR мен «Kaspi-де төлеу» батырмасы бар бет.
Тест режимі
Тест кілтімен шоттар ақша алмайды. Іске қоспас бұрын бүкіл сценарийді тексересіз.
Блоктың өзі
«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. Төлемді тексеру — сол тақырыппен GET https://api.qut.kz/api/v1/invoices/#{qp_invoice_id}. Барлық қадам, жауап пен қате — нұсқаулықта.
Алдын ала білу керегі
- Qut Pay мен Salebot — бөлек сервистер, серіктес емеспіз. Бот Qut Pay-ге Salebot-тың стандартты блогы арқылы жүгінеді.
- Salebot-та API функциялары тек «Бизнес» және «Инфобиз» тарифтерінде жұмыс істейді.
- Qut Pay-ге қосылған Kaspi Pay кассирі керек, яғни Kaspi Pay бизнес-аккаунты (ЖК не ЖШС).
- Salebot Qut Pay webhook-тарын тікелей қабылдамайды: бот төлемді клиент жазғанда не батырма басқанда тексереді.
Қалай қосу керек
Тіркелесіз
qut.kz/app сайтында тіркеліп, Kaspi Pay кассирін қосасыз.
Кілт жасайсыз
Кабинет → Интеграциялар → API кілттері. Алдымен тест кілті (qp_test_…).
Блок қосасыз
Salebot-та тапсырыс расталатын блокқа «API-запрос» және төлемді тексеру блогы.
Тексеріп, іске қосасыз
Тест тапсырысы → кабинетте «[Sandbox] төленді» → бот «✅» деп жазады. Сосын кілтті qp_live_…-ке ауыстырасыз.
Жиі қойылатын сұрақтар
Бұл қанша тұрады?
Бөлек ақы жоқ: интеграция кез келген Qut Pay тарифіне кіреді. Тарифтің айлық лимитіне тек төленген шоттар есептеледі. Kaspi өз комиссиясын бөлек ұстайды, Salebot тарифі Salebot-қа төленеді. Толығырақ: тарифтер.
Бағдарламашы керек пе?
Жоқ. Salebot-та блок жинай білсеңіз жеткілікті: нұсқаулықтағы URL, тақырып пен JSON-ды қойып, өз айнымалыларыңызды жазасыз.
Клиент төлегенін бот қалай біледі?
Тексеру блогымен: шот мекенжайына GET сұраныс qp_status қайтарады. paid болса — төленді. Оны клиент «Төледім» деп жазғанда не батырма басқанда іске қосасыз. Ал сізге хабар төлем түскен бойда Telegram-ға келеді.
Клиент нөмірі «+7 701 123 45 67» деп жазылған — жарай ма?
Иә. Qut Pay +7 701 123 45 67, 87011234567 және 77011234567 пішімдерін қабылдайды.
Telegram мен Instagram-да жұмыс істей ме?
Иә, Salebot-тың кез келген арнасында. WhatsApp-та сілтемесіз телефонға шот ыңғайлы, Telegram-да QR-ы бар төлем бетінің сілтемесін жіберуге болады.
Менде Salebot емес болса ше?
HTTP сұранысты JSON және тақырыппен жібере алатын кез келген құрастырғышта сол сұраныс жұмыс істейді, мысалы Make, n8n не Albato. API сипаттамасы: сайтқа интеграция.
Ботқа Kaspi төлемін қосыңыз
Тіркеліп, тест кілтін жасаңыз да, сценарийді 15 минутта тексеріңіз.
Qut Pay — тәуелсіз сервис, Kaspi Bank пен Salebot-тың серіктесі емес. Жұмыс үшін Kaspi Pay бизнес-аккаунты (ЖК не ЖШС) керек. Толығырақ: нұсқаулық, тарифтер, сенім орталығы.