Как принимать Kaspi Pay на сайте, в CRM или боте, если у Kaspi нет открытого API: пять способов и подводные камни
В Казахстане почти все платят через Kaspi, но продавцу без партнёрства с банком нельзя просто взять ключ API и выставлять счета из своей системы. Разбираю, какие пути есть на самом деле, сколько они стоят и что ломается. Я делаю один из таких сервисов, поэтому сразу говорю об этом и стараюсь писать честно про всех.
Если вы продаёте в Instagram, в Telegram или на своём сайте, сценарий знакомый: клиент пишет «скиньте Kaspi», вы выставляете счёт в приложении, а потом листаете историю и ищете, кто оплатил, за что и сколько. Пока заказов десять в день, это терпимо. Когда их сотня, или вам нужно, чтобы заказ на сайте сам стал «оплачен», нужен API. И тут выясняется, что открытого API для приёма платежей у Kaspi Pay нет.
Есть API Магазина на Kaspi.kz, но он про товары и заказы маркетплейса, а не про оплату. Есть партнёрство «Платежи на Kaspi.kz», но его подключают по заявке, и оно рассчитано на крупных поставщиков услуг. Малому бизнесу остаются другие пути. Их пять.
1. Штатный Kaspi Pay вручную
QR, ссылка на оплату и счёт на номер клиента есть в самом приложении Kaspi Pay, бесплатно. Минус один: всё вручную. Кто оплатил, вы узнаёте из истории операций, и связать платёж с заказом приходится глазами. Для небольшого потока этого хватает, и платить за автоматизацию раньше времени не стоит.
2. «Платежи на Kaspi.kz» — официальное партнёрство
Ваши услуги появляются в приложении Kaspi.kz, подключение идёт по заявке через Kaspi Гид. Это официальный путь, но он для поставщиков услуг с понятной моделью и объёмом. Интернет-магазину или студии он обычно не подходит.
3. Сервис поверх своего Kaspi Pay
Это самый распространённый путь. Сервис подключается к вашему Kaspi Pay как отдельный сотрудник с ролью «Кассир»: вы добавляете его в приложении Kaspi Pay и вводите код из SMS. Пароль владельца не нужен, а роль «Кассир» умеет принимать оплату и делать возвраты, но не умеет переводить деньги со счёта. Деньги идут напрямую на ваш Kaspi, сервис их не держит. Сам сервис выставляет счета и QR и сообщает об оплате вебхуком, в Telegram или в CRM.
Важно понимать: это не официальная интеграция Kaspi. Работает через ту же роль кассира, что и приложение Kaspi Pay. Отсюда главные ограничения, о них ниже.
Таких сервисов уже несколько: ApiPay, Tole, Qut Pay, darPAY, AiPay и Aitole (мой). Различаются они в основном тремя вещами:
- За что платите. У одних лимит считает созданные счета, включая неоплаченные, у других только оплаченные платежи, у darPAY есть вариант с процентом от оборота.
- Что есть вокруг API. Каталог и чеки (ApiPay), SDK и плагины для WooCommerce и OpenCart (Qut Pay), готовые виджеты для amoCRM и Bitrix24 (darPAY), безлимит на терминал для салонов (AiPay), регулярные счета и постоянные ссылки (Tole, Aitole).
- Есть ли песочница, где весь путь оплаты можно проверить без настоящих денег.
Входные тарифы на ноябрь 2026: от бесплатного (у Aitole 20 оплат в месяц) и 4 990 ₸ (Qut Pay, 800 счетов) до 25 000 ₸ за терминал (AiPay). Подробная таблица с условиями каждого сервиса, ссылками на их страницы тарифов и датой проверки: aitole.kz/sravnenie/.
4. Готовые интеграции для CRM и учёта
Если продажи живут в amoCRM или Bitrix24, есть KPAY: счета Kaspi прямо из сделки. Если учёт в МоёмСкладе, есть SmartPay и приложение ApiPay. Удобно, когда вы не хотите ничего настраивать, но платите за конкретную связку.
5. Свой сервер на открытом коде
Есть открытый проект kaspi-pos-automation от команды Tapter под лицензией MIT. Это сервер на Node.js, который умеет вход кассира по SMS, счета на номер, QR, возвраты и вебхуки. Код бесплатный, платите за сервер и за время разработчика. Мой сервис, кстати, построен на форке этого проекта, и наши правки лежат в открытом доступе.
Что ломается на практике
Это то, с чем мы столкнулись сами, и что стоит проверить у любого сервиса, прежде чем выбирать:
- Одна сессия на номер. Kaspi держит одну активную сессию на номер кассира. Если кто-то войдёт под этим номером в приложение Kaspi Pay, приём через сервис встанет. Поэтому кассиру нужен отдельный номер, а сервису — мониторинг, который сразу скажет, что касса отвалилась. Иначе узнаете по тишине.
- Обновления Kaspi. В сентябре 2026 Kaspi перестал пускать старые сборки приложения, и вход кассира у самописных решений начал падать с «Обновите приложение». Кто не следил за обновлениями, неделями не мог подключить кассы. Спросите у сервиса, как быстро он реагирует на такие изменения.
- Двойной счёт. Если ваш сайт повторил запрос из-за таймаута, клиент может получить два счёта. Нормальный API принимает ключ идемпотентности: повтор с тем же ключом возвращает тот же счёт.
- Потерянное уведомление об оплате. Вебхук может не дойти, если ваш сервер лёг. Нужен журнал событий или повторы, чтобы оплату можно было досверить.
- Регулярные платежи. Автосписания у Kaspi нет. «Подписка» через Kaspi — это счёт, который сервис выставляет по расписанию, а клиент оплачивает в одно касание. Проверьте, что делает сервис, если клиент не оплатил: повторяет ли счёт, сколько раз, и не придёт ли клиенту два счёта за один месяц.
- Чеки. Сервисы поверх Kaspi Pay обычно не выбивают фискальный чек: его выбивает ваша Kaspi Касса или кассовый сервис. Уточните заранее, если это важно для вашего бизнеса.
Как выбрать
- Платежей мало и всё через переписку — хватит штатного Kaspi Pay.
- Нужен поток оплат с сайта, из бота или CRM, а разработчика нет — сервис поверх Kaspi Pay. Выбирайте по тому, что вам нужно вокруг API, и по тому, за что считается лимит.
- Продажи в amoCRM или Bitrix24 и ничего не хочется настраивать — готовая интеграция для CRM.
- Есть разработчик, своя инфраструктура и важно, чтобы всё было своё, — kaspi-pos-automation.
Про мой сервис, раз уж я его делаю
Aitole — сервис поверх Kaspi Pay для малого бизнеса и разработчиков. Постоянные ссылки на оплату для Instagram, счета на номер клиента, регулярные счета, возвраты, уведомления в Telegram, REST API с вебхуками и песочница. Есть MCP-сервер: ИИ-ассистент вроде Claude или ChatGPT может сам выставлять счета и проверять оплату по вашей просьбе. 20 оплаченных платежей в месяц бесплатно, неоплаченные счета лимит не тратят. Если чего-то из списка выше у нас нет (чеков, плагинов для WooCommerce), я так и пишу на сайте.
Буду рад вопросам в комментариях, в том числе про то, как устроены такие сервисы внутри.