# Kaspi Pay-ді API арқылы өзіңіз қосуға бола ма — ашық kaspi-pos-automation

> Иә. Tapter командасы MIT лицензиясымен ашық kaspi-pos-automation Node.js-серверін жариялады: кассирдің SMS арқылы кіруі, нөмірге шоттар, QR, қайтарулар және қолтаңбасы бар вебхуктер. Оны өз серверіңізде тегін орнатуға болады. Бағасы — инфрақұрылым мен қолдау: сервер, сессиялардың сақталуы, Kaspi жағындағы өзгерістерді қадағалау, мониторинг. Aitole-дің өзі осы жобаның форкында құрылған және бұл жұмысты өзіне алады.

Источник: https://aitole.kz/kk/kaspi-open-source/ · Aitole — https://aitole.kz

## Бұл не

[kaspi-pos-automation](https://github.com/tapter-dev/kaspi-pos-automation) — [Tapter](https://tapter.one/kaspi.pos.automation) командасының Node.js-тегі Express-сервері. Ол сіздің Kaspi Pay-іңізге автоматтандыру сервистері сияқты қосылады: «Кассир» рөлі бар қызметкер және SMS-тегі код арқылы. Код MIT лицензиясымен ашық — оны еркін пайдалануға, өзгертуге және өз өнімдеріңізге енгізуге болады.

Не істей алады:

- кассирдің телефон нөмірі мен SMS арқылы кіруі;
- клиентке телефон нөмірі бойынша шот;
- төлемге арналған QR және мәртебені қадағалау;
- «Бірыңғай QR» — басқа банктердің қосымшаларынан төлеу;
- операциялар тарихы, статистика және қайтарулар;
- HMAC-SHA256 қолтаңбасы және қайталаулары бар вебхуктер.

## Қалай іске қосуға болады

1. Node.js 20.6 немесе одан жаңасы керек.
2. Репозиторийді клондап, тәуелділіктерді орнатыңыз: `npm install`.
3. `TOKEN_SECRET_KEY` кілті бар `.env` жасаңыз — 64 hex-таңба, ол сессия деректерін шифрлайды.
4. `npm start` іске қосыңыз — демо-интерфейс `localhost:3000` мекенжайында ашылады.

Авторлардың өздері ескертеді: демо-интерфейс API-ді тексеруге арналған, нақты касса үшін өз фронтендіңіз керек.

## Өзіңізге нені қолдауға тура келеді

Іске қосу — істің жартысы. Осы кодта өз сервисімізді құрғанда мынаған тап болдық:

- **24/7 сервер.** HTTPS, API-ге жабық қолжетімділік және сақтық көшірмелері бар үнемі жұмыс істейтін машина. Сервер құласа — төлемдер жіберілмейді.
- **Сессиялардың сақталуы.** Қосылған касса — серверде сақталған сессия. Бізде алғашында күй тұрақты дискіге шығарылғанша кез келген қайта деплой барлық кассаларды «шығарып» жіберетін.
- **Kaspi жағындағы өзгерістер.** 2026 жылғы қыркүйекте Kaspi қосымшаның ескі құрастырылымдарын кіргізбей қойды — кассирдің кіруі «Кіру үшін қосымшаны жаңартыңыз» деген қатемен құлай бастады. Негізгі репозиторийде бұл 28 қыркүйекте түзетілді; жаңартуларды қадағаламағандар кассаларды апталап қоса алмады. Енді Aitole Kaspi-дің бұл жауабын таниды: клиент түсінікті хабарлама көреді, ал бізге сол сәтте дабыл келеді — жаңарту шағымды күтпейді.
- **Сессияның ығыстырылуы.** Kaspi-де нөмірге бір сессия: кассир Kaspi Pay қосымшасына кірсе болды — қабылдау тоқтайды. Мониторинг пен дабылдар керек, әйтпесе бұл туралы кассадағы тыныштықтан білесіз.
- **Логтардағы құпиялар.** Kaspi сессиясының кілттері логтар мен сақтық көшірмелерге ашық күйде түспеуі керек.
- **API айналасындағының бәрі.** Қызметкерлерге арналған кабинет, клиенттерге төлем сілтемелері, тұрақты шоттар, хабарламалар, салыстыру, бірнеше касса — бұл бөлек әзірлеу.

## Өз шешіміңіз бе, әлде сервис пе

| | kaspi-pos-automation негізіндегі өз сервер | Kaspi Pay үстіндегі сервис |
|---|---|---|
| Ақша | Код тегін, сервер мен әзірлеуші уақыты үшін төлейсіз | Жазылым; Aitole-де айына 20 төлем тегін |
| Бақылау | Толық: код, деректер және серверлер сіздікі | Деректер сервисте, код жабық немесе ішінара ашық |
| Қолдау | Сіздің командаңыз | Сервис: Kaspi-ге жаңартулар, мониторинг, дабылдар |
| Алғашқы төлемге дейінгі уақыт | Әзірлеушіде бір күннен бір аптаға дейін | Минуттар |
| Кімге | Әзірлеушісі және өз инфрақұрылымы бар командаларға | Әзірлеушісі жоқ немесе сервер ұстағысы келмейтін бизнеске |

Әзірлеушіңіз болса және бәрі өзіңіздікі болуы маңызды болса — kaspi-pos-automation-ды алыңыз. Нәтиже бүгін және сервер қолдауынсыз керек болса — сервис.

## Tapter-ге рахмет

Aitole Kaspi-ге коннектор ретінде kaspi-pos-automation форкын пайдаланады. Tapter-дің ашық кодынсыз біздің сервис әлдеқайда кеш пайда болар еді. Біздің түзетулеріміз — сессияларды дискіде сақтау, құпиясыз логтар, құрастырылымды жаңарту — ашық [форкта](https://github.com/saygon91/kaspi-pos-automation) жатыр.

## Сұрақтар

### Бұл Kaspi-дің ресми API-і ме?

Жоқ. kaspi-pos-automation автоматтандыру сервистері сияқты Kaspi Pay үстінен «Кассир» рөлі арқылы жұмыс істейді — бұл ресми интеграция емес және Kaspi өнімі емес. Ресми жол — өтінім бойынша «Kaspi.kz-тегі төлемдер» серіктестігі.

### Бұл тегін бе?

Код — иә, MIT лицензиясы. Сервер үшін және оны қолдайтын адамның уақыты үшін төлеуге тура келеді.

### Бағдарламашы керек пе?

Иә. Серверді орнату, HTTPS пен қолжетімділікті баптау, қызметкерлерге интерфейс жасау және жаңартуларды қадағалау керек. Бағдарламашысыз сервисті алған оңай.

### Aitole kaspi-pos-automation-нан немен ерекшеленеді?

Aitole-дің ішінде — Kaspi-ге қосылудың сол қозғалтқышы. Үстінде — инфрақұрылым мен өнім: кабинет, Instagram үшін төлем сілтемелері, Telegram-бот, тұрақты шоттар, сессия құлағаны туралы дабылдар, сынақ ортасы, бірнеше касса және қолдау.

### Өзім орнатсам, Kaspi жағындағы өзгерістерді қалай қадағалауға болады?

GitHub-тағы [репозиторийдің](https://github.com/tapter-dev/kaspi-pos-automation) жаңартуларына жазылып, кассирдің кіруіне мониторинг қойыңыз: Kaspi қосымшаға талаптарды қайта көтерсе, ақау дәл сол жерде көрінеді.