# Привязка кассира оборвалась — как переподключить

> Счета внезапно перестали создаваться — значит, сессия Kaspi оборвалась. Переподключение занимает минуту. Причина, шаги и что сделать, чтобы не повторялось.

## Коротко

Kaspi разрешает одному номеру кассира **только одно активное устройство**. Если кто-то войдёт с этого номера в приложение Kaspi Pay, Kaspi оборвёт нашу сессию и создание счетов остановится. Переподключение — кабинет → **Kaspi** → на карточке подключения ввести номер и подтвердить код из SMS. Около минуты. Чтобы не повторялось, не входите в Kaspi Pay с номера кассира.

## Как понять, что это случилось

Три признака:

- **Приходит предупреждение в Telegram.** Бот пишет, что привязка Kaspi оборвалась (если бот подключён).
- **В кабинете карточка подключения показана как неактивная.** В разделе Kaspi рядом с кассиром появляется строка «Причина», чаще всего — вход с другого устройства.
- **Новые счета возвращают ошибку.** API отвечает `kaspi_session_expired` или похожей ошибкой, из кабинета счёт тоже не создаётся.

Ранее созданные неоплаченные счета не пропадают. Как только привязка восстановится, их статус снова начнёт проверяться.

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

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

Готово. Новый API-ключ создавать не нужно, старые ключи продолжают работать. Адрес webhook тоже не меняется.

Перед началом убедитесь, что телефон с номером кассира у вас в руках: код из SMS живёт около минуты.

## Почему оборвалось

Три самые частые причины.

**1. С номера кассира вошли в Kaspi Pay.** Самая частая. Если владелец номера откроет приложение Kaspi Pay на своём телефоне, Kaspi считает это новым устройством и выбрасывает нас. Это ограничение самого Kaspi, сделано для безопасности, обойти его нельзя.

**2. Сотрудника удалили в Kaspi Pay или сменили ему роль.** Если кассира убрали из списка «Сотрудники» или поставили роль, отличную от «Кассир», подключение перестаёт работать.

**3. Длительный сбой на стороне Kaspi.** Редко, но бывает. В этом случае переподключение тоже может не сработать сразу — подождите и повторите.

## Чтобы не повторялось

- **Не входите в приложение Kaspi Pay с номера кассира.** Это единственное и главное правило.
- **Предупредите владельца номера.** Этот человек не должен открывать Kaspi Pay. Его личного Kaspi это не касается, им он пользуется как раньше.
- **Держите номер кассира отдельным.** Пусть он будет только для этой работы, а не вашим повседневным телефоном. Подробно: [Три условия для номера кассира](/kb/ru/cashier-number-requirements).
- **Подключите Telegram-бота.** Тогда вы узнаете об обрыве сразу, а не когда напишут клиенты.
- **Следите, чтобы SIM оставалась активной.** Если оператор отключит номер, переподключение тоже не сработает.

## Что происходит, пока привязка оборвана

| Что | Состояние |
|---|---|
| Создание новых счетов | Не работает, возвращается ошибка |
| Ранее созданные неоплаченные счета | Сохраняются, проверятся после восстановления |
| Уже оплаченные счета | Не затрагиваются, всё на месте |
| Возвраты | Не работают |
| API-ключи | Не меняются, перевыпускать не нужно |
| Настройки webhook | Не меняются |
| Режим песочницы | Продолжает работать, Kaspi в нём не участвует |

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

**Нужен ли новый ключ после переподключения?** Нет. API-ключи и настройки webhook остаются прежними.

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

**Можно переподключить тот же номер?** Да, обычно тот же номер подходит. Но если номер убрали из списка сотрудников в Kaspi Pay, сначала нужно добавить его обратно.

**Обрывается часто — что делать?** Значит, с номера кассира кто-то регулярно заходит. Лучше перевести привязку на другой номер, которым никто не пользуется: [Кассир сменился или сменился номер](/kb/ru/change-cashier).