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