Өзіне-өзі қызмет көрсету аппараттарына Kaspi төлемін қосу

Сатушысыз жұмыс істейтін кез келген нүкте Kaspi арқылы төлем қабылдап, ақша түскен сәтте өзі іске қосыла алады. Мысалы, самомойка посты, су құятын автомат, есігі өзі ашылатын гүл автоматы, сатушысыз кітап сөресі. Оператор телефонға қарап, «ақша түсті ме» деп тексеріп отырмайды.

Qut Pay счёт жасайды, төлемді бақылайды және «төленді» деген хабарды сіздің жүйеңізге жібереді. Ақша тікелей сіздің Kaspi Pay шотыңызға түседі. Qut Pay ақшаны ұстамайды.

Qut Pay — бағдарламалық сервис. Біз аппарат, контроллер немесе MDB модулін сатпаймыз, орнатпаймыз да. Аппаратты басқаратын «темір» жағын сіз не интеграторыңыз жасайды. Бұл бет сол жұмысқа арналған нұсқаулық.

Қысқаша: қай аппаратқа қай жол

Нарықтағы өзіне-өзі қызмет көрсету аппараттары

Төмендегі тізім Қазақстанда жиі кездесетін түрлерді қамтиды. Бір түрдің ішінде басқару тәсілі өндірушіге қарай әртүрлі болады, сондықтан өз аппаратыңыздың платасын не құжатын қарап алыңыз.

A. Экраны бар аппарат: API және экрандағы QR

Аппарат не оның сервері POST /api/v1/invoices арқылы счёт жасайды, экранға qrImageUrl суретін шығарады. Клиент Kaspi.kz қосымшасымен сканерлеп төлейді. Аппарат төлемді webhook арқылы не 2–3 секунд сайын GET /api/v1/invoices/{id} сұрау арқылы біледі. Әр счёт жаңа, QR шамамен 3 минут жарамды.

Толық нұсқаулық, сұраныс мысалдары және кілтті сақтау ережесі: Өз құрылғыңызға Kaspi төлемін API арқылы қосыңыз.

B. Импульспен басқарылатын аппарат: тұрақты QR және импульс модулі

Самомойка, су автоматы, массаж креслосы сияқты аппараттардың көбі «тиын түсті» деген импульспен іске қосылады. Экран қажет емес, оның орнына жапсырма болады.

1. Кабинетте Сілтемелер бөлімінде әр постқа не аппаратқа бөлек тұрақты төлем сілтемесін жасайсыз, мысалы qut.kz/p/moika-post-3. Соманы бекітесіз (500 ₸) немесе клиенттің өзіне қалдырасыз. Екінші жағдайда ең аз және ең көп сомаға шек қоюға болады, мысалы 200-ден 5 000 ₸-ге дейін.
2. Сілтеменің QR-ын басып шығарып, постқа жапсырасыз.
3. Клиент QR-ды телефон камерасымен сканерлейді, соманы таңдайды және Kaspi-де растайды.
4. Qut Pay сіздің серверге invoice.paid оқиғасын жібереді. Ішінде metadata.slug бар, қай пост екенін сол арқылы білесіз.
5. Сервер сол посттың модуліне команда береді. Модуль сомаға сай импульс шығарады: 1 импульс 10 ₸ болса, 500 ₸ үшін 50 импульс.

Webhook денесі қысқартылған түрде:

{
  "event": "invoice.paid",
  "invoice": {
    "id": "inv_…",
    "status": "paid",
    "amount": 500,
    "metadata": { "paymentLinkId": "pl_…", "slug": "moika-post-3" }
  }
}

Модуль. Әдетте ESP32 не Raspberry Pi және оптрон не реле қолданылады. Ол монета қабылдағыштың сигнал сымына параллель жалғанады да, аппарат оны тиын түскендей қабылдайды. Модуль серверге өзі қосылады (MQTT не HTTP сұрау), сондықтан посттағы интернет GSM модем болса да жарайды. Сымды аппараттың схемасын білетін маман жалғағаны дұрыс.

C. Есігі өзі ашылатын аппарат: әр есікке QR және реле

Гүл автоматы, ақылды тоңазытқыш, сақтау ұяшықтары, ақылы дәретхана электр құлыппен ашылады.

• Бағасы тұрақты болса (ұяшық, дәретхана, тұрақ): әр есікке не ұяшыққа бекітілген сомамен бір сілтеме жасайсыз. Төленгенде сервер metadata.slug бойынша сол есіктің релесін бірнеше секундқа қосады.
• Бағасы ауысып тұрса (гүл, тоңазытқыштағы тауар): жапсырма сіздің өз бетіңізге апарады, мысалы сіздің-сайт.kz/cell/12. Бет ұяшықтың ағымдағы бағасын көрсетеді де, POST /api/v1/invoices арқылы metadata: { "cell": 12 } деп счёт жасайды. Төленгенде сол ұяшық ашылады.

Ұяшық бос тұрса, сілтемені кабинеттен тоқтатып қоюға болады. Клиент оны ашқанда «Сілтеме уақытша тоқтатылған» деген хабар көреді.

D. MDB вендинг автоматы

Снэк, сусын және кофе автоматтарының көбі карта мен QR-ды MDB шинасындағы cashless құрылғысы арқылы қабылдайды. Оған MDB cashless рөлін атқаратын модуль керек, нарықта дайын MDB тақталары бар. Модульдің бағдарламасы клиент тауар таңдағанда Qut Pay API арқылы счёт жасайды, QR-ды шағын экранға шығарады, ал төлем расталғанда автоматқа сатуға рұқсат береді.

Бұл интегратордың жұмысы, Qut Pay бұл жерде тек төлемді жасайды және растайды. Автоматыңыздың жеткізушісінде өз QR модулі болса, бағасы мен шарттарын салыстырыңыз.

E. Сатушысыз дүкен мен кітап сөресі

Ең қарапайым жол, мұнда «темірдің» қажеті жоқ.

• Соманы клиент өзі енгізетін бір сілтеме жасайсыз, қаласаңыз «Түсініктеме» өрісін қосасыз (мысалы, кітаптың атын жазу үшін).
• QR-ды сөреге не есікке жапсырасыз. Әр затта бағасы жазылып тұрады.
• Әр төлем кабинетте көрінеді, Telegram бот хабарлайды. Кім, қанша және не үшін төлегенін бірден көресіз.

Тауар бірнеше түрлі болып, бағалары тұрақты болса, әр түрге бөлек сілтеме жасаңыз. Сонда клиент соманы қателеспейді.

Алдын ала білу керек жәйттер

• Webhook қолтаңбасын тексеріңіз. Тексермесеңіз, біреу жалған «төленді» хабарын жіберіп, постты тегін іске қосады. Қолтаңба: HMAC-SHA256, денені өзгертпеген күйінде тексересіз.
• Бір счётқа бір-ақ рет іске қосыңыз. 2xx жауап алмаса, webhook 11 ретке дейін қайталанады. Импульсті не есікті invoice.id бойынша бір рет беріңіз.
• Кеш төлем болады. Мерзімі өткен счётқа ақша кешігіп келсе, invoice.paid late: true белгісімен келеді. Қызметті беріңіз не ақшаны қайтарыңыз.
• Интернет керек. Сервер мен модульде, сондай-ақ клиенттің телефонында байланыс болуы керек.
• Kaspi байланысы үзілуі мүмкін. Біреу кассир нөмірімен Kaspi Pay-ге кірсе, қайта қосылғанша Kaspi арқылы төлем жүрмейді. Хабар Telegram-ға келеді. Тиын, купюра не карта сияқты қосалқы төлем тәсілін алып тастамаңыз.
• Сілтеме саны шектеулі. Тұрақты сілтеме саны тарифке байланысты: Бастау — 50, Бизнес — 300, Про — 1 000. Аппарат одан көп болса, A не C жолындағыдай өз бетіңіз арқылы API-мен счёт жасаңыз.
• Әр ашылған счёт есепке кіреді. Клиент төлемесе де, тарифтің айлық санына қосылады.
• Фискалды чек. Чек беру міндеті сатушыда. Kaspi Pay-де Kaspi Касса қосылса, Qut Pay счёты төленгенде чек клиенттің Kaspi қосымшасына өзі барады. Толығы: фискалды чек нұсқаулығы.
• Qut Pay — сіздің өз Kaspi Pay аккаунтыңыздағы «Кассир» рөлі арқылы жұмыс істейтін тәуелсіз сервис. Біз «Kaspi Bank» АҚ-мен аффилирленбегенбіз. Тәуекелдер ашық жазылған: сенім орталығы.

Қанша тұрады

7 күн тегін, ол бірінші нақты счёттан басталады. Одан кейін тариф айына жасалатын счёт санына қарай таңдалады:

Мысалы, 6 посты бар самомойкада әр постта күніне шамамен 40 төлем болса, айына 7 000-ға жуық счёт шығады, яғни «Про» тарифі. Платформа төлемнен пайыз алмайды. Kaspi өз комиссиясын (QR үшін 0,95 %) бөлек ұстайды, бізсіз де солай. Толығы: тарифтер.

Қалай бастау керек

1. qut.kz-те тіркеліп, Kaspi кассирін жалғаңыз: бастау нұсқаулығы.
2. Кабинетте Интеграциялар бөлімінде webhook адресін қосып, құпияны серверге сақтаңыз.
3. API жолы болса, алдымен qp_test_… кілтімен sandbox-та тексеріңіз: төлемді POST /invoices/{id}/simulate жасайды, webhook шын келеді.
4. Бір посттан не бір ұяшықтан бастаңыз: 100 ₸-лік нақты төлеммен импульс не есік дұрыс жұмыс істейтінін көріңіз.
5. Сосын қалған аппараттарға таратыңыз.

Модуль мен сервердің кодын ЖИ-агентке де жаздыруға болады. Claude, Cursor не ChatGPT-ге api.qut.kz/for-ai сілтемесін беріңіз, ол Qut Pay-дің API-ін сол жерден оқиды.

Жиі қойылатын сұрақтар

Qut Pay аппаратты не модульді өзі орната ма?

Жоқ. Qut Pay тек бағдарламалық сервис: счёт жасайды, төлемді бақылайды, webhook жібереді. Модульді, сымды және аппараттың бағдарламасын сіз не интеграторыңыз жасайды.

Экраны жоқ аппаратта QR қалай көрінеді?

Тұрақты QR жапсырма арқылы. Кабинеттегі Сілтемелер бөлімінде әр аппаратқа бөлек сілтеме жасайсыз, оның QR-ын басып шығарып жапсырасыз. Клиент сканерлегенде телефонында төлем беті ашылады.

Клиент төлеген соң аппарат қаншалықты тез іске қосылады?

Әдетте webhook төлемнен кейін 5 секунд ішінде келеді. Оған сіздің серверіңіз бен модульдің жауап беру уақыты қосылады.

Самомойкада соманы клиент өзі таңдай ала ма?

Иә. Сілтемеде сома бекітілмесе, клиент оны өзі енгізеді. Ең аз және ең көп сомаға шек қоюға болады. Сервер түскен сомаға қарай импульс санын есептейді.

Kaspi байланысы үзілсе не болады?

Кассир қайта жалғанғанша Kaspi арқылы жаңа төлем жүрмейді. Telegram-ға хабар келеді, кабинеттен бірнеше минутта қайта жалғайсыз. Сондықтан аппараттағы тиын, купюра не карта сияқты қосалқы төлем тәсілін сақтаған жөн.

Жаңартылды: 2026-11-11