Как подключить

Эта страница — самое начало. Подключение занимает 15 минут, разработчик не нужен. Интеграция по коду описана на странице Интеграция на сайт.

Сначала: куда поступают деньги

Деньги никогда не находятся в Qut Pay. Клиент платит напрямую на ваш счёт Kaspi Pay, мы лишь создаём счёт, отслеживаем его оплату и уведомляем вас.

Пять шагов

Шаг 1. Откройте в Kaspi Pay кассира с отдельным номером

Откройте приложение Kaspi Pay на своём телефоне (не веб-кабинет):

Настройки → Сотрудники → Добавить сотрудника

Введите новый номер и выберите роль. Номер обязательно должен быть другим — не тем, которым вы пользуетесь каждый день. Почему — объяснено ниже.

Роль должна быть только «Кассир»

Kaspi предлагает пять ролей. Нам подходит только одна:

Если выбрать другую роль, подключение не заработает даже при верном SMS-коде: право принимать оплату через QR есть только у роли «Кассир».

Шаг 2. Один раз войдите с этим номером и выйдите

Войдите в приложение Kaspi Pay с новым номером. Аккаунт станет активным (Kaspi называет это «активацией»). Затем выйдите из приложения — место освободится, и его займём мы.

Если пропустить этот шаг, на шаге 4 подключение не установится даже при верном SMS-коде.

На телефоне с номером кассира приложение Kaspi Pay постоянно не нужно — после активации достаточно, чтобы на этот номер приходили SMS.

После подключения не входите в Kaspi Pay с этим номером. Kaspi увидит новое устройство и прервёт нашу сессию, подключение придётся создавать заново.

Шаг 3. Зарегистрируйтесь на qut.kz

qut.kz → зарегистрируйтесь со своим номером. Одна минута, документы не требуются. Здесь нужен ваш собственный номер — не номер кассира.

Шаг 4. Подключите кассира

В кабинете перейдите в раздел Кассиры Kaspi:

1. Введите название (например «Основная касса» или «Магазин №2»)
2. Нажмите кнопку Добавить кассира
3. Введите номер, который открыли на первом шаге
4. Введите SMS-код, пришедший на этот номер

Готово. Пароль не запрашивается, мы его никогда не спрашиваем.

Шаг 5. Получите API-ключ и webhook

В разделе Интеграции:

• Создайте API-ключ — qp_test_… (sandbox) или qp_live_… (реальные платежи)
• Укажите адрес своего webhook — при оплате мы отправим на него уведомление

Теперь ваше приложение может принимать платежи.

Почему нужен отдельный номер

Kaspi разрешает одному кассиру только одно активное устройство. Если входит новое устройство, старое выходит.

Если вы дадите свой номер, в момент подключения приложение Kaspi Pay на вашем телефоне выйдет из аккаунта. Если вы пользуетесь им каждый день, это неудобно.

Отдельный номер сотрудника полностью решает эту проблему: ваш телефон не затрагивается, вы пользуетесь Kaspi Pay как раньше, а мы лишь занимаем это место сотрудника.

Три условия к номеру кассира

Чтобы подключение прошло успешно, номер должен одновременно соответствовать трём условиям.

1. Реальная SIM-карта, принимающая SMS. Виртуальные номера и IP-телефония не подходят — Kaspi отправляет код подтверждения по SMS. В момент подключения телефон с этой SIM-картой должен быть у вас в руках.

2. На ИИН владельца номера не должно быть зарегистрировано ИП или ТОО в Kaspi Pay. Если владелец номера — предприниматель, Kaspi при входе вместо SMS запросит пароль и видеоверификацию. Мы подключаем кассира только через SMS, поэтому такой номер не подойдёт. Владелец номера должен быть совершеннолетним — это требование Kaspi.

3. У номера должна быть только роль «Кассир». Если есть дополнительные роли — «Управляющий», «Бухгалтер», «Руководитель» — номер не пройдёт. Пусть в вашей организации у него будет единственная роль «Кассир».

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

Как проверить

Самый надёжный признак — что Kaspi запрашивает при подключении:

Не проверяйте номер входом в приложение. Если после подключения войти в Kaspi Pay с номером кассира, подключение прервётся.

Чей номер можно взять

Подходит номер любого человека, у которого нет ИП/ТОО в Kaspi Pay: супруга или супруги, родителей, партнёра. Многие покупают новую SIM-карту — от 500 тенге, и вопрос решается раз и навсегда.

Владельца номера стоит заранее предупредить о двух вещах:

• Если этот человек раньше входил в Kaspi Pay, в момент нашего подключения его выбросит из этого приложения. Личный Kaspi это не затрагивает, им можно пользоваться как раньше.
• Номер кассира виден клиенту в уведомлении о счёте. Это обычная работа Kaspi, на оплату она не влияет, но лучше предупредить, чтобы не было неожиданностей.

Не путайте три разных номера

Одной строкой: личный номер — в кабинет, номер кассира — в Kaspi, номер клиента — на счёт.

Как подключить мобильное приложение

Самый частый вопрос. Ответ: приложение не обращается к нам напрямую, всё идёт через ваш сервер.

Приложение → Ваш сервер → Qut Pay → Kaspi

Причина: API-ключ должен храниться только на сервере. Если положить ключ внутрь приложения (в файл APK или IPA), его можно извлечь и выставлять счета от вашего имени.

Порядок:

1. Пользователь нажимает в приложении «Оплатить»
2. Приложение отправляет запрос на ваш сервер
3. Сервер отправляет нам POST /api/v1/invoices (сумма, номер заказа)
4. Мы возвращаем payUrl и QR
5. Приложение открывает payUrl — на телефоне сразу открывается приложение Kaspi
6. Клиент платит, деньги поступают на ваш счёт
7. Мы отправляем на ваш сервер webhook invoice.paid
8. Сервер сообщает приложению «оплачено»

Есть готовые SDK: Node.js, PHP, Python. Подробности — на странице Интеграция на сайт.

Правило App Store и Play Market

Если ваше приложение продаёт цифровые товары (подписка, премиум, монеты внутри игры), Apple и Google требуют использовать их собственную платёжную систему — внешнюю оплату они не разрешают.

А если это физический товар, доставка, плата за услугу или бронирование, внешняя оплата — обычная практика. Kaspi QR относится к этой категории.

Заранее выясните, к какой категории относится ваше приложение.

Сначала проверьте в sandbox

В кабинете есть два режима:

В sandbox создание счёта, получение webhook, возврат — всё работает так же, как в live. Переходите на live только тогда, когда ваша интеграция работает правильно.

Для sandbox не нужен и кассир Kaspi — можно тестировать сразу после шага 3.

Пробный период

7 дней бесплатно, до 50 счетов в день. Пробный период начинается с первого реального счёта, а не со дня регистрации. То есть можно неделю готовиться, а затем начать пробный период.

Тарифы и лимиты: Тарифы.

Что понадобится

• Бизнес-аккаунт Kaspi Pay (ИП или ТОО)
• Доступ в кабинет Kaspi Pay (чтобы добавить сотрудника)
• Отдельный номер (принимающий SMS)
• Для вашего сайта или приложения — человек, который сможет написать один запрос на стороне сервера

Если серверной части нет: WordPress, OpenCart, Telegram-бот, форма Tilda и платёжные ссылки работают без кода.

SMS-код: сроки, о которых стоит знать заранее

Начинайте подключение, когда телефон кассира у вас в руках. Время ограничено:

• Код действует около минуты. Вводить нужно быстро.
• Весь процесс подключения — одно окно, около 10 минут. Ввод номера и ввод кода должны уложиться в это окно, иначе придётся начинать с начала.
• Не передавайте код от человека к человеку. Пока кассир продиктует, бухгалтер запишет, а вы введёте — код истечёт.
• Если SIM-карта была выключена, включите её и подождите одну-две минуты. SMS приходит не сразу.
• Если Kaspi временно ограничил выдачу кодов, подождите около минуты и начните заново.

Частые ошибки

Kaspi запрашивает пароль или видеоверификацию. Самая частая. У номера есть роль помимо «Кассир», либо на ИИН владельца номера зарегистрировано ИП/ТОО. Решение одно: взять другой номер. Смотрите три условия выше.

Пишет «Этого номера нет в Kaspi Pay» или запрашивает ИИН. Номер вообще не добавлен в раздел «Сотрудники». Выполните шаг 1 и начните подключение заново.

SMS не приходит. SIM-карта выключена, код истёк или Kaspi ограничил выдачу кодов. Включите телефон, подождите минуту и начните заново.

Вместо SMS Kaspi прислал «ссылку для скачивания». Это нормально, скачивать ничего не нужно. Такое сообщение означает, что сотрудник добавлен.

Неверная роль. Если сотрудник значится как «Управляющий» или «Бухгалтер», права принимать оплату у него нет. Смените роль на «Кассир» в приложении Kaspi Pay.

Ошибка «Вход с другого устройства». Номер кассира открыт в приложении Kaspi Pay на другом телефоне. Выйдите на том телефоне и подключите заново.

Подключение разорвалось. Если кто-то вошёл в Kaspi Pay с номером кассира, наша сессия выходит из аккаунта. Подключите заново в кабинете; в Telegram придёт предупреждение.

Всё верно, но подключение не устанавливается. Напишите в поддержку: отправьте номер кассира, скриншот экрана Kaspi и время попытки.

Webhook не доходит. Проверьте, не закрыт ли ваш адрес паролем. Мы не авторизуемся, поэтому он должен быть открыт. Для теста можно указать адрес webhook.site.

Чем этот сервис не является

Qut Pay — независимый сервис, работающий поверх вашего собственного аккаунта Kaspi Pay. Мы не аффилированы с АО «Kaspi Bank» и не даём никаких обещаний от имени Kaspi. Kaspi и Kaspi Pay — товарные знаки правообладателя.

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

Если нужна помощь

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

Нужна помощь? WhatsApp +77788813333 · kazprose@gmail.com · 09:00–21:00 (Алматы)
Можно написать и из кабинета: Поддержка.

Qut Pay — независимый сервис, не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки правообладателя.