> Источник: https://apipay.kz/guides/pochemu-sletala-sessiya-kassira · Обновлено: 2026-07-06 · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

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

**TL;DR.** Симптом «счета перестали выставляться, оплаты автоматом отменяются» обычно означает, что разорвалась привязка кассира — например, под номером кассира вошли в приложение Kaspi Pay для бизнеса. Переподключение — самообслуживание: **Настройки → «Авторизация Kaspi», около 1 минуты**; ждать поддержку не нужно. Отдельный номер кассира, под которым в Kaspi Pay никто не входит, снимает причину. Обрыв виден интеграции как `connection.needs_reauth: true` в `GET /api/v1/account/health`.

## Коротко

| Вопрос | Ответ |
|---|---|
| Почему разрывается привязка | Под номером кассира выполняется вход в приложение Kaspi Pay для бизнеса |
| Как подключить и переподключить | Самостоятельно: Настройки → «Авторизация Kaspi», ~1 минута, код по SMS |
| Нужна ли ежедневная переавторизация | Нет |
| Сколько живёт SMS-код | Около 1 минуты — вводите сразу |
| Повторные SMS | Кнопка «Отправить ещё раз» разблокируется через 60 секунд. При анти-абузе Kaspi приходит `503 kaspi_busy` с `Retry-After` — после паузы авторизацию начинают заново |
| Личный Kaspi на номере кассира | Можно; нельзя входить только в приложение Kaspi Pay (для бизнеса) |
| Как выглядит обрыв в API | Детект — `GET /api/v1/account/health` → `connection.needs_reauth: true`; подробности ниже, в вопросах и ответах |

## «Счета не выставляются, оплата автоматом отменяется» — что это значит

Симптомы «оплата автоматом отменяется», «счёт выставлен, но клиенту не приходит», «инвойс переходит в cancelled», «кассир протух» означают одно — оборвалась сессия кассира: пока она мертва, счета в Kaspi не уходят, а в кабинете горит предупреждение.

## Почему привязка разрывается

**Под номером кассира не входите в приложение Kaspi Pay для бизнеса** — держите этот номер только для привязки. Kaspi держит одну сессию на номер: любой вход в Kaspi Pay под номером кассира вытесняет нашу, и счета перестают выставляться. Поэтому опасен «живой» номер, которым пользуется человек. Отдельный номер, под которым в Kaspi Pay никто не входит, снимает причину обрывов полностью.

Перед привязкой кабинет просит отметить три пункта: номер добавлен в **Kaspi Pay → Сотрудники**, роль у него — только «Кассир», и под этим номером вы не будете входить в приложение Kaspi Pay.

## Сессия всё-таки оборвалась: как переподключить за 1 минуту

1. **Возьмите телефон с SIM-картой кассира** — на него придёт SMS. Держите его под рукой: код действует около минуты.
2. **Войдите в кабинет** на apipay.kz со своего личного номера (не с номера кассира).
3. Откройте **Настройки → «Авторизация Kaspi»** и нажмите **«Подключить заново»** — при оборванной сессии главная кнопка называется так. Номер кассира берите **тот же**, менять сотрудника не нужно.
4. **Отметьте три галочки** — те же три пункта, что и при первой привязке.
5. **Введите номер кассира**, выберите его роль в Kaspi Pay и нажмите «Получить SMS». На следующем экране подтвердите, что не будете входить в Kaspi Pay под этим номером, и нажмите «Прислать SMS».
6. **Введите код из SMS** и нажмите «Подтвердить». Готово — приём оплат восстановлен.

Что полезно знать:

- Вся процедура (номер + код) должна уложиться примерно в 10 минут — потом Kaspi сбрасывает процесс, и его нужно начать заново. На практике хватает одной минуты.
- Запуск авторизации при живой сессии сам по себе ничего не ломает: кабинет не начнёт авторизацию сразу, а покажет диалог «Сменить кассира?». А вот **подтверждение этого диалога рвёт рабочую связку безвозвратно** — жмите «Продолжить», только если готовы прямо сейчас ввести SMS-код.
- Предупреждение о разрыве появляется не всегда — мастер может начать авторизацию сразу. Поэтому открывайте его только тогда, когда телефон кассира уже под рукой.

## «Я не захожу в Kaspi Pay» — откуда тогда обрыв?

Проверьте три вещи:

- **Кто ещё имеет доступ к SIM кассира?** Сотрудник, родственник, разработчик: частый сценарий — человек, чей номер сделали кассиром, по привычке открыл Kaspi Pay на своём телефоне.
- **Не сделан ли кассиром ваш основной номер?** Тогда каждый ваш собственный вход в Kaspi Pay обрывает ApiPay. Решение — отдельный номер: «[Требования к номеру кассира](/guides/trebovaniya-k-nomeru-kassira)».
- **Личный 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 проще всего.

Смотрите также: [Требования к номеру кассира](/guides/trebovaniya-k-nomeru-kassira) · Безопасность и как работает ApiPay · [Вход в кабинет ApiPay](/guides/vhod-v-kabinet-apipay) · пиллар «[Как принимать оплату Kaspi через API](/kaspi-api)» · инструкция «[Подключение кассира](/connect-cashier)».

---

ApiPay — независимый сервис и не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.
База знаний: https://apipay.kz/guides