Как принимать Kaspi Pay на сайте, в CRM или боте, если у Kaspi нет открытого API: пять способов и подводные камни

В Казахстане почти все платят через Kaspi, но продавцу без партнёрства с банком нельзя просто взять ключ API и выставлять счета из своей системы. Разбираю, какие пути есть на самом деле, сколько они стоят и что ломается. Я делаю один из таких сервисов, поэтому сразу говорю об этом и стараюсь писать честно про всех.

Как принимать Kaspi Pay на сайте, в CRM или боте, если у 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, возвраты и вебхуки. Код бесплатный, платите за сервер и за время разработчика. Мой сервис, кстати, построен на форке этого проекта, и наши правки лежат в открытом доступе.

Что ломается на практике

Это то, с чем мы столкнулись сами, и что стоит проверить у любого сервиса, прежде чем выбирать:

  1. Одна сессия на номер. Kaspi держит одну активную сессию на номер кассира. Если кто-то войдёт под этим номером в приложение Kaspi Pay, приём через сервис встанет. Поэтому кассиру нужен отдельный номер, а сервису — мониторинг, который сразу скажет, что касса отвалилась. Иначе узнаете по тишине.
  2. Обновления Kaspi. В сентябре 2026 Kaspi перестал пускать старые сборки приложения, и вход кассира у самописных решений начал падать с «Обновите приложение». Кто не следил за обновлениями, неделями не мог подключить кассы. Спросите у сервиса, как быстро он реагирует на такие изменения.
  3. Двойной счёт. Если ваш сайт повторил запрос из-за таймаута, клиент может получить два счёта. Нормальный API принимает ключ идемпотентности: повтор с тем же ключом возвращает тот же счёт.
  4. Потерянное уведомление об оплате. Вебхук может не дойти, если ваш сервер лёг. Нужен журнал событий или повторы, чтобы оплату можно было досверить.
  5. Регулярные платежи. Автосписания у Kaspi нет. «Подписка» через Kaspi — это счёт, который сервис выставляет по расписанию, а клиент оплачивает в одно касание. Проверьте, что делает сервис, если клиент не оплатил: повторяет ли счёт, сколько раз, и не придёт ли клиенту два счёта за один месяц.
  6. Чеки. Сервисы поверх 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), я так и пишу на сайте.

Буду рад вопросам в комментариях, в том числе про то, как устроены такие сервисы внутри.