Коротко
У Kaspi Pay нет публичного API, который любой бизнес мог бы подключить по документации, как это принято у платёжных шлюзов. Официально Kaspi даёт бизнесу приложение Kaspi Pay (QR на кассе, ссылки на оплату, счета покупателю) и индивидуальные интеграции по договору. Всё остальное на рынке — сервисы, которые автоматизируют штатную роль «Кассир» в вашем аккаунте; у Qut Pay для этого есть обычный REST API с ключом, webhook и песочницей.
Что есть у Kaspi официально
| Инструмент | Для чего | Автоматизация |
|---|---|---|
| Приложение Kaspi Pay (бизнес) | QR на кассе, ссылка на оплату, счёт на номер покупателя | вручную, из приложения |
| Kaspi Магазин | продажи внутри kaspi.kz | свои правила площадки |
| Интеграция по договору | крупный бизнес, сети | индивидуально, по соглашению с Kaspi |
Если у вашего бизнеса нет отдельного соглашения с Kaspi, «API Kaspi Pay» в смысле документированного публичного интерфейса вам недоступно. Это стоит знать, чтобы не искать несуществующую документацию.
Как тогда работают сервисы с «API для Kaspi QR»
Сервисы вроде Qut Pay подключаются к вашему Kaspi Pay так же, как сотрудник с ролью «Кассир»: вы сами создаёте кассира на отдельном номере, сервис входит по SMS-коду и выставляет счета от его имени. Деньги при этом идут напрямую на ваш Kaspi Pay — сервис их не касается. Подробно, включая ограничения и риски: безопасно ли это, центр доверия. Qut Pay — независимый сервис, не партнёр Kaspi.
Какой API у Qut Pay
- База:
https://api.qut.kz/api/v1, ключ в заголовкеX-API-Key, JSON. - Счета: создать, получить статус, список, отменить, вернуть деньги — все поля счёта, возвраты.
- Уведомления: webhook
invoice.paidи другие события с подписью HMAC-SHA256 — настройка. - Песочница: ключ
qp_test_…, оплату имитирует запрос — как тестировать. - Документация: OpenAPI, инструкция для ИИ-ассистента, SDK для Node.js, PHP, Python.
Пример — счёт и ответ:
curl -X POST https://api.qut.kz/api/v1/invoices \
-H "X-API-Key: qp_test_…" -H "Content-Type: application/json" \
-d '{"amount": 1500, "externalOrderId": "1001"}'{ "id": "inv_…", "status": "pending", "payUrl": "https://qut.kz/pay/inv_…", "qrUrl": "…", "deepLink": "…", "expiresAt": "…" }Сколько стоит
Подписка от 4 990 ₸ в месяц за 800 счетов, 7 дней бесплатно; процент с платежей платформа не берёт, комиссию Kaspi за QR удерживает Kaspi — тарифы, комиссия Kaspi QR.
Вопросы и ответы
Kaspi может закрыть такой доступ? Может ограничить кассира или такой способ в целом; это главный риск модели, и мы пишем о нём открыто. Деньги, уже полученные на ваш счёт, это не затрагивает.
Нужно ли передавать сервису пароль от Kaspi Pay? Нет. Вход кассира — по SMS-коду, который вводит сам кассир; пароль не запрашивается и не хранится.
Есть ли API у Kaspi для Единого QR других банков? Единый QR — отдельная тема, у других банков свои продукты; эта статья только про Kaspi Pay.