Коротко
Kaspi Pay на сайте — это не одна кнопка «подключить API», а выбор из трёх разных путей с разной ценой входа и разным риском. Первый — официальное партнёрство с Kaspi Pay: договор, юрлицо в Казахстане, EDS, IPSec VPN, свой бэкенд под вебхуки. Второй — генерация Kaspi QR под конкретный заказ, без глубокой интеграции: покупатель сканирует, платит в приложении, сайт получает подтверждение вручную или через простой callback. Третий — сторонние шлюзы вроде ApiPay.kz, ApiMonster и аналогов, которые обещают REST API «за 15 минут», но по факту дергают внутренние методы Kaspi, не предназначенные для сторонних интеграторов.
Ниже — по каждому варианту: что реально нужно для подключения, где выгода, а где риск потерять доступ к деньгам в разгар распродажи. Отдельно — про фискализацию: чек ККМ по каждой онлайн-оплате обязателен в Казахстане независимо от того, как физически прошли деньги.
Официальное партнёрство: самый долгий, но единственный устойчивый путь
Заявка подаётся через kaspi.kz/webpay/partnership. На входе нужны: действующее ИП или ТОО, счёт в казахстанском банке, электронная цифровая подпись, сайт на HTTPS с валидным SSL-сертификатом, возможность поднять IPSec VPN-туннель до Kaspi и бэкенд, который умеет принимать вебхуки в формате JSON по RESTful-схеме.
Источник: публичная страница партнёрства Kaspi WebPay, снимок публичной страницы: июль 2026.
Договор — типовой, присоединение целиком, без индивидуальных правок под конкретный бизнес. Это неприятно для тех, кто привык согласовывать условия эквайринга под себя, но так работают все крупные платёжные операторы, не только Kaspi.
Дальше — техническая часть: получение тестовых ключей, интеграция в песочнице, обработка callback о статусе платежа, переход на боевые ключи после проверки. По ощущениям тех, кто уже прошёл этот путь, базовая интеграция с QR-оплатой занимает 3-5 рабочих дней после одобрения заявки, интеграция с кастомным UI и CRM — 7-10 дней, а если добавляется 1С и VPN-контур — заявляют от двух недель. Одобрение самой заявки со стороны Kaspi может занять дольше, чем вся техническая работа, — закладывайте это в план запуска.
Плюс этого пути прямой: вы работаете напрямую с оператором, деньги идут по официальному контуру, поддержка отвечает от имени Kaspi, а не от имени подрядчика, который сам когда-то подключился неизвестно как.
Kaspi QR без партнёрства: быстро, но с потолком
Для небольшого магазина или лендинга с несколькими заказами в день полноценное партнёрство может быть избыточным. Рабочий вариант — генерировать Kaspi QR-код на странице оплаты после оформления заказа: покупатель сканирует код камерой или переходит в приложение Kaspi.kz напрямую (на мобильном это делается одной кнопкой), платит, а менеджер подтверждает оплату вручную по выписке или через уведомление в Kaspi Pay.
Это не требует VPN и договора эквайринга, но и не даёт автоматического статуса «оплачено» на сайте — сверка остаётся на человеке. Для 10-20 заказов в день это терпимо. При росте объёма ручная сверка платежей превращается в отдельную работу, которую проще отдать автоматике, чем нанимать человека специально под эту задачу.
Здесь же стоит сказать про кабинет продавца Kaspi Merchant — это отдельная история от Kaspi Pay для сайта, ближе к маркетплейсу и офлайн-точкам, чем к встраиванию оплаты в чужой чекаут. Если вы уже продаёте через Магазин на Kaspi.kz или планируете, у нас есть отдельный разбор — Kaspi Merchant: гайд по кабинету продавца. Здесь же речь именно про приём Kaspi Pay на собственном сайте вне маркетплейса.
Шлюзы-посредники: скорость в обмен на прозрачность
На рынке есть несколько сервисов — ApiPay.kz, ApiMonster и похожие — которые предлагают REST API для Kaspi Pay: оплата по номеру телефона, автоматические инвойсы, вебхуки о статусе, SDK на JS, Python, PHP. Заявленная скорость подключения — от 15 минут, без договора с Kaspi напрямую и без VPN.
Честно: у Kaspi нет публичного открытого REST API для приёма платежей на произвольном сайте, сравнимого с тем, что дают Stripe или обычные интернет-эквайеры. То, что показывают такие шлюзы, — это обёртка поверх внутренних механизмов Kaspi (например, тех же методов, что использует мобильное приложение или кабинет продавца), которые не были спроектированы как публичный API для третьих лиц. Часть таких проектов даже прямо пишет в описании, что «не аффилированы с Kaspi.kz и не одобрены им».
Из этого следуют три практических риска. Во-первых, такой метод может перестать работать без предупреждения — если Kaspi поменяет внутренний протокол, у вас нет SLA и договора, который обязывает кого-то это исправить. Во-вторых, юридически деньги идут не через легальный эквайринговый контур с вашим бизнесом как стороной договора, а через чужой аккаунт или прослойку — это создаёт вопросы у бухгалтерии и налоговой, особенно при фискализации чека. В-третьих, при споре с покупателем или блокировке у вас нет прямого канала в поддержку Kaspi — вы зависите от третьего лица, который сам зависит от того же нестабильного механизма.
Такие шлюзы могут быть разумным выбором для быстрого прототипа или MVP, где важно за день показать демо инвестору или проверить спрос. Для боевого магазина с реальными деньгами клиентов ставка на неофициальный доступ означает, что в любой момент оплата может просто перестать проходить, и разбираться с этим будет некому, кроме вас.
Фискализация: чек обязателен независимо от способа оплаты
Отдельный вопрос, который часто выпадает из обсуждения API, — фискальный чек. По статье 166 Налогового кодекса РК применение онлайн-ККМ с передачей данных оператору фискальных данных обязательно для большинства предпринимателей, и оплата через Kaspi Pay это правило не отменяет. Чек должен формироваться при каждой продаже, независимо от того, пришли деньги картой, через Kaspi QR или банковским переводом.
На практике это значит, что интеграция Kaspi Pay на сайт — это не только приём денег, но и связка с онлайн-кассой: Е-Kassa, Webkassa или аналогичным сервисом, который передаёт чек в ОФД в момент оплаты. Если оплата подтверждается вручную человеком, а не автоматическим вебхуком, разрыв по времени между оплатой и пробитием чека — это уже нарушение, просто не всегда замечаемое сразу.
При выборе между тремя вариантами подключения стоит сразу спрашивать: как именно статус оплаты долетает до кассового модуля и кто отвечает, если чек не пробился вовремя. У официального партнёрства с вебхуками это решается программно. У ручной сверки по QR — это узкое место, которое рано или поздно вскроется на проверке.
Как выбрать вариант для своего сайта
Если бизнес уже растёт и деньги реальные — оправдано официальное партнёрство, даже с учётом двух-трёх недель на подключение. Это единственный вариант, где ответственность за сбой лежит на стороне, с которой у вас подписан договор.
Если это тест гипотезы, лендинг под один продукт или начинающий магазин с несколькими заказами в день — Kaspi QR с ручной сверкой закроет вопрос без лишних затрат, но нужно сразу понимать, что при росте объёма это придётся менять.
Сторонние шлюзы имеет смысл использовать только там, где вы готовы к тому, что интеграция может отвалиться, и у вас есть план Б. Ставить на них единственный канал оплаты интернет-магазина — решение, о котором обычно жалеют не сразу, а через полгода, когда всё уже работает на потоке заказов.
Отдельно от выбора способа оплаты стоит вопрос, что происходит вокруг него: подтверждение заказа клиенту, уведомление о статусе, ответ на вопрос «а прошла ли оплата», которые обычно сыпятся в WhatsApp сразу после чекаута. Если магазин параллельно продаёт через Kaspi, платёжный контур нужно проектировать рядом с Kaspi Merchant API и кабинетом продавца, а не отдельным островом. Мы подключаем такие сценарии как часть интеграции ИИ через GPT и внешние API — когда оплата, CRM и переписка с клиентом работают в одном контуре, а не как три отдельные системы, которые никто не сверяет вручную.
FAQ
Есть ли у Kaspi Pay официальный публичный API для любого сайта?
Официальный путь — это партнёрство через kaspi.kz/webpay/partnership с договором, IPSec VPN и вебхуками. Открытого REST API уровня Stripe, доступного без договора, у Kaspi нет — то, что называют «Kaspi Pay API» на сторонних сервисах, обычно обёртка поверх внутренних механизмов, не рассчитанных на публичный доступ.
Сколько времени занимает подключение Kaspi Pay к сайту?
Базовая интеграция после одобрения заявки — обычно 3-5 рабочих дней, с кастомным UI и CRM — 7-10 дней, с 1С и VPN-контуром — от двух недель. Само рассмотрение заявки со стороны Kaspi может занять дольше технической части.
Можно ли принимать Kaspi Pay без договора с Kaspi?
Технически да, через генерацию QR-кода с ручной сверкой или через сторонние шлюзы. Первый вариант законен, но не масштабируется. Второй несёт риск отключения без предупреждения и вопросы к легальности расчётов при проверке.
Нужен ли отдельный кассовый аппарат для приёма Kaspi Pay?
Да. Фискальный чек по статье 166 Налогового кодекса РК обязателен при любой продаже, включая оплату через Kaspi. Онлайн-касса должна быть связана со статусом платежа так, чтобы чек пробивался в момент оплаты, а не с задержкой.
Если сайт уже принимает заказы, а оплата остаётся узким местом — начните с вопроса, сколько платежей в день реально проходит и что случится, если канал оплаты отвалится на сутки. Ответ на этот вопрос обычно и определяет, какой из трёх вариантов подключения оправдан.