Коротко
Подключение состоит из двух частей. Сначала в приложении Kaspi Pay (не в веб-кабинете): Настройки → Сотрудники → Добавить сотрудника, роль «Кассир». Затем один раз входите с этого номера, чтобы активировать сотрудника, и выходите из приложения. После этого в кабинете вводите название, нажимаете «Добавить кассира», указываете номер, получаете код из SMS и нажимаете «Подтвердить». Всё вместе — 2–3 минуты. После привязки в Kaspi Pay с этого номера больше не заходите.
Перед началом
Проверьте номер — почти все сложности при подключении растут отсюда. Три условия: настоящая SIM, принимающая SMS; на ИИН владельца номера в Kaspi Pay не зарегистрированы ИП или ТОО, и владелец совершеннолетний; на номере только роль «Кассир». Подробно: Три условия для номера кассира.
Телефон с номером кассира держите в руках: код из SMS живёт около минуты, а весь процесс — одно окно примерно на десять минут.
Часть 1. В приложении Kaspi Pay
- Откройте приложение Kaspi Pay. Нужно именно приложение — из веб-кабинета сотрудник не добавляется.
- Зайдите в Настройки.
- Сотрудники → Добавить сотрудника
.
- Введите номер будущего кассира.
- Поставьте роль «Кассир». Из пяти ролей Kaspi (Управляющий, Бухгалтер, Кассир, Менеджер Магазина, Менеджер Маркетинга) подходит только эта: право принимать оплату по QR есть лишь у «Кассира».
- Сохраните.
Часть 2. Активация номера
Новый сотрудник не становится активным в Kaspi сразу. Один раз войдите с этого номера в Kaspi Pay, пройдите активацию и выйдите из приложения.
Это единственный момент, когда в приложение нужно заходить. Дальше с этого номера Kaspi Pay открывать нельзя: Kaspi разрешает одному кассиру только одно активное устройство, и вход в приложение оборвёт нашу привязку.
Часть 3. Привязка в кабинете
- Откройте раздел Кассиры Kaspi.
- Дайте подключению название — например, «Основной кассир» или «Точка на Абылай хана». Название видно только вам, оно нужно, чтобы не путать подключения.
- Нажмите Добавить кассира.
- Введите номер кассира и запросите SMS.
- Введите пришедший код и нажмите Подтвердить.
Карточка подключения перейдёт в активное состояние. Теперь можно выставлять счета — и вручную из кабинета, и через POST /api/v1/invoices.
После подключения
- Не входите с этого номера в Kaspi Pay. Главное правило. Если номер чужой, предупредите владельца.
- Следите, чтобы SIM оставалась активной. Если оператор отключит номер, привязка перестанет работать.
- Номер кассира виден покупателю. Kaspi показывает его в уведомлении о счёте — это штатное поведение Kaspi.
- В кабинет заходите не с номера кассира, а со своего личного номера.
- Ключ можно привязать к кассиру. Тогда боевые счета этого ключа идут только через этого кассира, а счета других кассиров ему не видны.
Какие ошибки бывают
| Что вы видите | Причина |
|---|---|
| Kaspi просит пароль или видеоверификацию | Номер не подходит — нужен другой |
| Спрашивает ИИН или «номер не найден» | Часть 1 не выполнена: номера нет в «Сотрудниках» |
| SMS не приходит | SIM отключена, номер набран неверно или Kaspi временно ограничил запросы |
| Код не принимается | Код истёк, запросите новый |
Разбор каждого случая: Кассир Kaspi не подключается — почему и что делать.
Начать можно и без кассира
Если подключение хочется отложить, в режиме песочницы кассир вообще не нужен. Интеграцию можно написать целиком, проверить webhook и обработку счетов. Пробный период песочница не запускает — он начинается с первого боевого счёта.
Вопросы и ответы
Сколько времени это занимает? При правильно подобранном номере — 2–3 минуты. Основное время уходит на выбор номера, а не на саму привязку.
Можно подключить несколько кассиров? Да. Каждый кассир — отдельное подключение и отдельный номер. Если один оборвётся, остальные продолжают работать.
Что будет, если отключить кассира? Новые счета через него создаваться не будут. Ранее оплаченные счета и отчётность остаются на месте.
Не вижу раздел «Сотрудники» в приложении Kaspi Pay. Доступ к нему есть у владельца аккаунта или у роли с соответствующими правами. Проверьте, что вы вошли в Kaspi Pay как владелец бизнес-аккаунта.
Можно потом сменить номер? Да. Заводите роль «Кассир» на новый номер в Kaspi Pay и заново привязываете его в кабинете. API-ключи и настройки webhook не меняются.