# Как подключить кассира Kaspi

> Пошаговая инструкция из двух частей: сначала заводите роль «Кассир» в приложении Kaspi Pay, затем привязываете номер в кабинете по коду из SMS. Всё вместе занимает 2–3 минуты.

## Коротко

Подключение состоит из двух частей. Сначала в **приложении Kaspi Pay** (не в веб-кабинете): Настройки → Сотрудники → Добавить сотрудника, роль «Кассир». Затем один раз входите с этого номера, чтобы активировать сотрудника, и выходите из приложения. После этого в [кабинете](https://qut.kz/app/kaspi/) вводите название, нажимаете «Добавить кассира», указываете номер, получаете код из SMS и нажимаете «Подтвердить». Всё вместе — 2–3 минуты. После привязки в Kaspi Pay с этого номера больше не заходите.

## Перед началом

Проверьте номер — почти все сложности при подключении растут отсюда. Три условия: настоящая SIM, принимающая SMS; на ИИН владельца номера в Kaspi Pay не зарегистрированы ИП или ТОО, и владелец совершеннолетний; на номере только роль «Кассир». Подробно: [Три условия для номера кассира](/kb/ru/cashier-number-requirements).

Телефон с номером кассира держите в руках: код из SMS живёт около минуты, а весь процесс — одно окно примерно на десять минут.

## Часть 1. В приложении Kaspi Pay

1. Откройте **приложение Kaspi Pay**. Нужно именно приложение — из веб-кабинета сотрудник не добавляется.
2. Зайдите в **Настройки**.
3. **Сотрудники** → **Добавить сотрудника**

![Kaspi Pay: меню Настройки, пункт Сотрудники](/docs/img/kaspi-employees-menu.svg)

![Выбор роли сотрудника: подходит только «Кассир»](/docs/img/kaspi-role-picker.svg).
4. Введите номер будущего кассира.
5. Поставьте роль **«Кассир»**. Из пяти ролей Kaspi (Управляющий, Бухгалтер, Кассир, Менеджер Магазина, Менеджер Маркетинга) подходит только эта: право принимать оплату по QR есть лишь у «Кассира».
6. Сохраните.

## Часть 2. Активация номера

Новый сотрудник не становится активным в Kaspi сразу. Один раз **войдите с этого номера в Kaspi Pay**, пройдите активацию и **выйдите из приложения**.

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

## Часть 3. Привязка в кабинете

1. Откройте раздел [Кассиры Kaspi](https://qut.kz/app/kaspi/).
2. Дайте подключению **название** — например, «Основной кассир» или «Точка на Абылай хана». Название видно только вам, оно нужно, чтобы не путать подключения.
3. Нажмите **Добавить кассира**.
4. Введите номер кассира и запросите SMS.
5. Введите пришедший код и нажмите **Подтвердить**.

Карточка подключения перейдёт в активное состояние. Теперь можно выставлять счета — и вручную из кабинета, и через `POST /api/v1/invoices`.

## После подключения

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

## Какие ошибки бывают

| Что вы видите | Причина |
|---|---|
| Kaspi просит пароль или видеоверификацию | Номер не подходит — нужен другой |
| Спрашивает ИИН или «номер не найден» | Часть 1 не выполнена: номера нет в «Сотрудниках» |
| SMS не приходит | SIM отключена, номер набран неверно или Kaspi временно ограничил запросы |
| Код не принимается | Код истёк, запросите новый |

Разбор каждого случая: [Кассир Kaspi не подключается — почему и что делать](/kb/ru/cashier-not-connecting).

## Начать можно и без кассира

Если подключение хочется отложить, в [режиме песочницы](/kb/ru/sandbox-vs-live) кассир вообще не нужен. Интеграцию можно написать целиком, проверить webhook и обработку счетов. Пробный период песочница не запускает — он начинается с первого боевого счёта.

## Вопросы и ответы

**Сколько времени это занимает?** При правильно подобранном номере — 2–3 минуты. Основное время уходит на выбор номера, а не на саму привязку.

**Можно подключить несколько кассиров?** Да. Каждый кассир — отдельное подключение и отдельный номер. Если один оборвётся, остальные продолжают работать.

**Что будет, если отключить кассира?** Новые счета через него создаваться не будут. Ранее оплаченные счета и отчётность остаются на месте.

**Не вижу раздел «Сотрудники» в приложении Kaspi Pay.** Доступ к нему есть у владельца аккаунта или у роли с соответствующими правами. Проверьте, что вы вошли в Kaspi Pay как владелец бизнес-аккаунта.

**Можно потом сменить номер?** Да. Заводите роль «Кассир» на новый номер в Kaspi Pay и заново привязываете его в кабинете. API-ключи и настройки webhook не меняются.