Бұл не
kaspi-pos-automation — Tapter командасының Node.js-тегі Express-сервері. Ол сіздің Kaspi Pay-іңізге автоматтандыру сервистері сияқты қосылады: «Кассир» рөлі бар қызметкер және SMS-тегі код арқылы. Код MIT лицензиясымен ашық — оны еркін пайдалануға, өзгертуге және өз өнімдеріңізге енгізуге болады.
Не істей алады:
- кассирдің телефон нөмірі мен SMS арқылы кіруі;
- клиентке телефон нөмірі бойынша шот;
- төлемге арналған QR және мәртебені қадағалау;
- «Бірыңғай QR» — басқа банктердің қосымшаларынан төлеу;
- операциялар тарихы, статистика және қайтарулар;
- HMAC-SHA256 қолтаңбасы және қайталаулары бар вебхуктер.
Қалай іске қосуға болады
- Node.js 20.6 немесе одан жаңасы керек.
- Репозиторийді клондап, тәуелділіктерді орнатыңыз:
npm install. TOKEN_SECRET_KEYкілті бар.envжасаңыз — 64 hex-таңба, ол сессия деректерін шифрлайды.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-дің ашық кодынсыз біздің сервис әлдеқайда кеш пайда болар еді. Біздің түзетулеріміз — сессияларды дискіде сақтау, құпиясыз логтар, құрастырылымды жаңарту — ашық форкта жатыр.