«Счета не выставляются, оплата автоматом отменяется» — что это значит
Симптомы «оплата автоматом отменяется», «счёт выставлен, но клиенту не приходит», «инвойс переходит в cancelled», «кассир протух» означают одно — оборвалась сессия кассира: пока она мертва, счета в Kaspi не уходят, а в кабинете горит предупреждение.
Почему привязка разрывается
Под номером кассира не входите в приложение Kaspi Pay для бизнеса — держите этот номер только для привязки. Kaspi держит одну сессию на номер: любой вход в Kaspi Pay под номером кассира вытесняет нашу, и счета перестают выставляться. Поэтому опасен «живой» номер, которым пользуется человек. Отдельный номер, под которым в Kaspi Pay никто не входит, снимает причину обрывов полностью.
Перед привязкой кабинет просит отметить три пункта: номер добавлен в Kaspi Pay → Сотрудники, роль у него — только «Кассир», и под этим номером вы не будете входить в приложение Kaspi Pay.
Сессия всё-таки оборвалась: как переподключить за 1 минуту
- Возьмите телефон с SIM-картой кассира — на него придёт SMS. Держите его под рукой: код действует около минуты.
- Войдите в кабинет на apipay.kz со своего личного номера (не с номера кассира).
- Откройте Настройки → «Авторизация Kaspi» и нажмите «Подключить заново» — при оборванной сессии главная кнопка называется так. Номер кассира берите тот же, менять сотрудника не нужно.
- Отметьте три галочки — те же три пункта, что и при первой привязке.
- Введите номер кассира, выберите его роль в Kaspi Pay и нажмите «Получить SMS». На следующем экране подтвердите, что не будете входить в Kaspi Pay под этим номером, и нажмите «Прислать SMS».
- Введите код из SMS и нажмите «Подтвердить». Готово — приём оплат восстановлен.
Что полезно знать:
- Вся процедура (номер + код) должна уложиться примерно в 10 минут — потом Kaspi сбрасывает процесс, и его нужно начать заново. На практике хватает одной минуты.
- Запуск авторизации при живой сессии сам по себе ничего не ломает: кабинет не начнёт авторизацию сразу, а покажет диалог «Сменить кассира?». А вот подтверждение этого диалога рвёт рабочую связку безвозвратно — жмите «Продолжить», только если готовы прямо сейчас ввести SMS-код.
- Предупреждение о разрыве появляется не всегда — мастер может начать авторизацию сразу. Поэтому открывайте его только тогда, когда телефон кассира уже под рукой.
«Я не захожу в Kaspi Pay» — откуда тогда обрыв?
Проверьте три вещи:
- Кто ещё имеет доступ к SIM кассира? Сотрудник, родственник, разработчик: частый сценарий — человек, чей номер сделали кассиром, по привычке открыл Kaspi Pay на своём телефоне.
- Не сделан ли кассиром ваш основной номер? Тогда каждый ваш собственный вход в Kaspi Pay обрывает ApiPay. Решение — отдельный номер: «Требования к номеру кассира».
- Личный Kaspi — не при чём. Обычным приложением Kaspi (покупки, переводы) на номере кассира пользоваться можно.
Вопросы и ответы
Как понять, что сессия оборвалась?
Машинный детект до отправки счёта — поллинг GET /api/v1/account/health: connection.session_status = expired или error и connection.needs_reauth: true. Создание QR-счёта в этом состоянии отдаёт 409 kaspi_session_expired — QR не создан, повтор не поможет, лечится только переавторизацией. Счёт по номеру принимается, но завершается статусом error. В кабинете появляется плашка «Связь с Kaspi потеряна».
Узнаю ли я об обрыве, или замечу по недовольным клиентам?
При переходе сессии в мёртвую владельцу уходит уведомление в WhatsApp (не чаще раза в сутки на организацию), а в кабинете статус кассира меняется на «Требуется вход заново». Интеграции опрашивают GET /api/v1/account/health → connection.needs_reauth.
Нужно ли удалять приложение Kaspi с телефона кассира?
Не обязательно. Достаточно не входить в Kaspi Pay под этим номером. Но если телефон в чужих руках и есть риск случайного входа — удалить именно Kaspi Pay проще всего.