Чтобы интегрировать Kaspi Pay в мобильное приложение, нужны три вещи: договор мерчанта с Kaspi.kz (ИП или ТОО, зарегистрированные в Казахстане), доступ к Kaspi Pay API после модерации и бэкенд, который формирует счета и отслеживает статусы платежей. Реалистичный срок — 2–4 недели, стоимость интеграции — от 400 000 ₸.

Kaspi.kz — де-факто стандарт оплаты в Казахстане: приложением банка пользуется подавляющее большинство взрослого населения страны. Если сервис принимает оплату картой через международный шлюз, но не принимает Kaspi, заметная доля заказов теряется на самом простом шаге — оплате. Ниже — разбор без маркетинговых обещаний: какие схемы оплаты существуют, что потребует банк, где интеграция буксует и сколько это стоит в 2026 году.

Какие схемы оплаты Kaspi доступны в мобильном приложении

Под «интеграцией Kaspi Pay» заказчики обычно имеют в виду одно из трёх технических решений. Они отличаются по пользовательскому сценарию, сложности и требованиям банка.

Deeplink в приложение Kaspi.kz

Самый удобный сценарий для смартфона. Ваш бэкенд через API создаёт счёт на оплату, приложение получает платёжную ссылку и открывает её — система переключает пользователя в установленное приложение Kaspi.kz, где сумма и получатель уже подставлены. Пользователь подтверждает платёж одним касанием и возвращается в ваше приложение. Конверсия у этой схемы максимальная: не нужно вводить ни номер карты, ни реквизиты.

Kaspi QR

Классическая схема для сценариев «оплата на месте»: курьер показывает QR-код на экране, клиент сканирует его камерой Kaspi.kz. В мобильном приложении QR чаще используют как запасной вариант. Технически это тот же счёт через API, только представленный в виде QR-кода вместо ссылки.

Выставление счёта по номеру телефона

Бэкенд отправляет счёт на номер клиента, и тот получает push в Kaspi.kz с предложением оплатить. Схема полезна для отложенных платежей: бронирования, доплаты, повторные списания по подписочной логике. Автосписаний в чистом виде, как у сохранённой карты, Kaspi сторонним приложениям не даёт — это важно учитывать при проектировании подписочных сервисов.

В большинстве проектов разработки мобильных приложений мы закладываем deeplink как основную схему и счёт по номеру телефона как резервную — связка покрывает практически все сценарии e-commerce и услуг.

Требования Kaspi к мерчанту: что проверит банк

Доступ к платёжному API Kaspi выдаёт только действующим партнёрам. Перед стартом разработки убедитесь, что бизнес проходит по формальным критериям:

  • Юридическое лицо в Казахстане. ИП или ТОО с действующей регистрацией. Иностранные компании без казахстанского юрлица подключиться не могут — для рынков ОАЭ и Таиланда мы используем локальные шлюзы, Kaspi работает только внутри KZ.
  • Договор Kaspi Pay. Торговая точка должна быть заведена в кабинете Kaspi Pay для бизнеса.
  • Понятная категория деятельности. Запрещённые и «серые» категории (криптообмен, азартные игры, финансовые пирамиды) модерацию не пройдут.
  • Рабочий сайт или описание сервиса. При рассмотрении заявки банк смотрит, что за продукт будет принимать оплату. Приложение на этапе разработки — нормально, но сценарий оплаты должен быть описан внятно.
  • Контактное лицо с доступом к кабинету. Заявка подаётся от имени владельца бизнеса. Подрядчик может вести переписку с банком, но аккаунт мерчанта — ваш.

Процесс подключения по шагам

Путь от решения «принимаем Kaspi» до первого боевого платежа в приложении:

  1. Регистрация в Kaspi Pay для бизнеса — если торговой точки ещё нет. Занимает 1–3 рабочих дня вместе с проверкой банка.
  2. Заявка на доступ к API. Через кабинет или менеджера банка запрашивается доступ с описанием сценария: мобильное приложение, тип товаров, ожидаемые обороты.
  3. Получение доступов и документации. Банк выдаёт идентификаторы мерчанта и ключи. На этом этапе фиксируем актуальную версию API — Kaspi периодически обновляет методы, и статьи двухлетней давности часто описывают устаревший флоу.
  4. Разработка на бэкенде. Создание счёта, генерация платёжной ссылки или QR, обработка статусов, возвраты. Параллельно — экраны оплаты в приложении.
  5. Тестирование. Полноценной публичной песочницы у Kaspi нет, поэтому финальная проверка идёт боевыми платежами на минимальные суммы с последующими возвратами.
  6. Релиз и мониторинг. Выпускаем обновление в App Store и Google Play, первые дни следим за долей успешных платежей.

Техническая сторона: что должен уметь ваш бэкенд

Kaspi Pay — это серверная интеграция. Мобильное приложение само с банком не разговаривает: запросы на создание счёта и проверку статуса идут через ваш бэкенд. Так ключи мерчанта никогда не попадают в код приложения.

Минимальный контур, который мы реализуем в каждом проекте:

  • Создание счёта с идемпотентностью. Если пользователь дважды нажал «Оплатить» или приложение переотправило запрос из-за плохой сети, в Kaspi не должно уйти два счёта. Каждый заказ получает уникальный ключ операции.
  • Машина статусов платежа. Создан → ожидает оплаты → оплачен / отменён / истёк. Заказ считается оплаченным только после серверного подтверждения от банка. Доверять колбэку из приложения нельзя: его можно подделать.
  • Обработка «зависших» оплат. Классика мобильных платежей: пользователь оплатил в Kaspi.kz, но не вернулся в приложение — звонок, свернул, разрядился телефон. Фоновая проверка статусов раз в 30–60 секунд закрывает такие заказы автоматически.
  • Возвраты. Полные и частичные возвраты должны запускаться из вашей админки, а не через звонок в банк — иначе операционная нагрузка на менеджеров вырастет в разы.
  • Сверка и учёт. Платежи должны попадать в учётную систему. Чаще всего это 1С — как связать её с приложением без ручных выгрузок, мы разобрали в статье об интеграции 1С с мобильным приложением.

Для сервисов доставки платёжный модуль почти всегда работает в связке с логистикой: адрес, зона и стоимость доставки считаются до выставления счёта. Если ваш сценарий такой, посмотрите разбор про карты и геолокацию в приложении — эти два модуля проектируются вместе.

Сроки и стоимость интеграции в 2026 году

Цены ниже — ориентиры Applications.kz для типовых конфигураций. Точная смета зависит от состояния вашего бэкенда: интегрировать Kaspi в аккуратный API на Laravel или Node.js быстрее, чем в legacy-систему без документации.

Конфигурация Что входит Срок Стоимость
Базовая Deeplink-оплата, статусы, экран оплаты в приложении 2–3 недели от 400 000 ₸
Стандартная Базовая + возвраты из админки, QR-резерв, фоновая досверка платежей 3–4 недели 600 000 – 900 000 ₸
Расширенная Стандартная + счёт по номеру телефона, сверка с 1С, отчёты, алерты по сбоям 4–6 недель от 1 200 000 ₸

Отдельная статья расходов — комиссия банка с каждого платежа. Она зависит от категории бизнеса и оборотов и фиксируется в вашем договоре с Kaspi; разработчик на неё не влияет.

В сроках главная неопределённость — не код, а коммуникация с банком: рассмотрение заявки занимает от нескольких дней до пары недель. Поэтому заявку мы подаём в первый же день проекта, параллельно с проектированием.

Типичные ошибки, которые затягивают запуск

  • Заявка на API после разработки, а не до. Команда пишет код по статьям из интернета, потом получает доступы — и выясняет, что методы отличаются. Правильный порядок: сначала доступы и документация, потом код.
  • Ключи мерчанта в мобильном приложении. Любой ключ, зашитый в APK или IPA, извлекается за вечер. Все секреты живут только на сервере.
  • Заказ помечается оплаченным по возврату пользователя в приложение. Возврат из Kaspi.kz не гарантирует оплату. Истина — только в статусе на стороне банка.
  • Нет сценария «оплатил, но заказ не создался». Сбой между оплатой и созданием заказа должен разруливаться автоматически или мгновенно подсвечиваться менеджеру.
  • Тестирование только на «happy path». Отмена в последний момент, истёкший счёт, двойное нажатие, обрыв сети — каждый случай проверяется до релиза.

Как мы подключаем Kaspi Pay в Applications.kz

Студия Applications.kz работает с 2007 года: более 300 проектов для Казахстана, ОАЭ и Таиланда. Платёжные интеграции — зона повышенной ответственности, поэтому мы ведём их по фиксированному регламенту: аудит бэкенда, подача заявки в банк в первый день, проектирование машины статусов, код-ревью платёжного модуля вторым инженером и чек-лист из двух десятков негативных сценариев перед релизом. Если приложения у вас ещё нет, посмотрите, как устроена наша разработка мобильных приложений под ключ — платёжный модуль в этом случае проектируется сразу в архитектуре, а не прикручивается потом.

Пришлите описание задачи на +7 (707) 928-13-15 — подготовим смету и план интеграции за 24 часа.

Частые вопросы

Можно ли подключить Kaspi Pay без ИП или ТОО?

Нет. Kaspi выдаёт доступ к платёжному API только зарегистрированным в Казахстане предпринимателям и компаниям с договором Kaspi Pay. Физическому лицу или иностранной компании без казахстанского юрлица интеграция недоступна. Если бизнес на этапе запуска, регистрацию ИП стоит сделать до старта разработки — это сэкономит пару недель в общем графике.

Сколько времени занимает интеграция Kaspi Pay?

Базовый сценарий с deeplink-оплатой — 2–3 недели вместе с тестированием и релизом обновления в сторы. Расширенные конфигурации с возвратами, счетами по номеру телефона и сверкой с 1С — 4–6 недель. Самая непредсказуемая часть — рассмотрение заявки банком, поэтому её подают в первый день проекта.

Есть ли у Kaspi тестовая среда для разработчиков?

Полноценной публичной песочницы нет. Логику бэкенда отлаживают на моках по документации, а финальную проверку проводят боевыми платежами на минимальные суммы с последующим возвратом. Это стандартная практика для Kaspi-интеграций в Казахстане, и она закладывается в план тестирования заранее.

Подходит ли Kaspi Pay для подписок с автосписанием?

В классическом виде — нет: рекуррентных автосписаний, как у сохранённой банковской карты, Kaspi сторонним приложениям не предоставляет. Для подписочной модели используют выставление счёта по номеру телефона перед каждым периодом или комбинируют Kaspi с карточным шлюзом, поддерживающим рекурренты. Архитектуру выбираем на этапе проектирования.

Сколько стоит интеграция и какая комиссия у Kaspi?

Разработка — от 400 000 ₸ за базовую конфигурацию до 1 200 000 ₸ и выше за расширенную со сверкой и отчётами. Комиссия за приём платежей — отдельный платёж банку с каждой транзакции: её размер зависит от категории бизнеса и фиксируется в вашем договоре с Kaspi, разработчик на неё не влияет.