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

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

**TL;DR.** Если счета перестали выставляться, скорее всего разорвалась привязка кассира. Чаще всего это происходит, когда под его номером входят в приложение Kaspi Pay для бизнеса: Kaspi держит одну сессию на номер. Переподключение — самостоятельно в кабинете ApiPay: **Настройки → «Авторизация Kaspi» → «Подключить заново», тот же номер, код из SMS, около 1 минуты**; ждать поддержку не нужно. Чтобы обрывы не повторялись, держите для ApiPay отдельный номер кассира, под которым в 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 (для бизнеса) |
| Как отвязать кассира | В кабинете ApiPay: «Отключить» или «Сменить кассира» на вкладке «Авторизация Kaspi»; подробнее ниже |
| Как выглядит обрыв в API | Детект — `GET /api/v1/account/health` → `connection.needs_reauth: true`; подробности ниже, в вопросах и ответах |

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

Симптомы «счета перестали выставляться», «счёт не создаётся», «кассир протух» чаще всего означают одно — оборвалась сессия кассира: пока она мертва, новые счета в Kaspi не уходят, а в кабинете горит предупреждение «Связь с Kaspi потеряна». Другие причины (тариф, песочница, номер покупателя) разобраны в «[Оплата не приходит](/guides/oplata-ne-prihodit-kaspi)».

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

**Под номером кассира не входите в приложение Kaspi Pay для бизнеса** — держите этот номер только для привязки. Kaspi держит одну сессию на номер: любой другой вход в Kaspi Pay под номером кассира обрывает сессию ApiPay, и счета перестают выставляться. Поэтому опасен «живой» номер, которым пользуется человек, и поэтому один номер кассира нельзя делить с другими сервисами или партнёрами — подробно в «[Требованиях к номеру кассира](/guides/trebovaniya-k-nomeru-kassira)». Отдельный номер, под которым в 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** и нажмите «Подтвердить». Готово — приём оплат восстановлен.

**Переподключение того же номера ничего не меняет** — всё продолжает работать: уже выставленные счета, подписки, печатные листы, возвраты. Перевыставлять ничего не нужно. Пока привязка была разорвана, новые счета не создавались: создание счёта отвечало `409 kaspi_session_expired` — такие счета выставьте после переподключения. Возврат, запрошенный, пока привязка была разорвана, мог получить статус `failed` — после переподключения создайте его заново.

Как устроен мастер подключения и какой номер для него нужен — на странице «[Подключение кассира Kaspi](/connect-cashier)».

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

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

## Как отвязать кассира?

В кабинете ApiPay, вкладка **Настройки → «Авторизация Kaspi»**:

- **«Отключить»** — останавливает выставление счетов, пока вы сами не подключите кассира заново. История счетов сохраняется. Учтите денежное последствие: после отключения возврат через ApiPay сразу получит статус `failed`, и придёт вебхук `invoice.refunded` со `status: failed` — такие возвраты делаются вручную в приложении Kaspi Pay. Если по недавним счетам возможны возвраты, отключайте кассира после того, как это окно закроется.
- **«Сменить кассира»** — подключает новый номер вместо старого. Приём останавливается с момента подтверждения до ввода нового SMS-кода, поэтому держите SIM нового кассира под рукой. В отличие от переподключения того же номера, после смены на другой номер неоплаченные счета прежнего кассира, скорее всего, закроются (`cancelled` или `expired`, придёт вебхук `invoice.status_changed`) — перевыставьте их. Возвраты и чеки по оплаченным счетам сделайте до смены: после неё успех возврата не гарантирован. Кассир уволился или сменился номер — «[Кассир уволился или сменился номер](/guides/smena-kassira-nomera-vladeltsa)».

Сотрудника в самом Kaspi Pay убирают в своём приложении Kaspi Pay, в разделе «Сотрудники». О роли кассира — в справке Kaspi: «[Какие права у кассира](https://guide.kaspi.kz/partner/ru/profile/user/cashier/q3450)». Прежде чем удалить сотрудника, чей номер подключён к ApiPay, решите в кабинете: подключить нового кассира или остановить приём. После удаления возвраты по ранее оплаченным счетам через ApiPay не пройдут — их делают вручную в приложении Kaspi Pay.

## «Я не захожу в 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`** (реже `503 kaspi_session_invalid`) — счёт не создан, повтор не поможет, лечится только переавторизацией. Если сессия оборвалась уже после того, как счёт приняли, он может завершиться статусом `error`. В кабинете появляется плашка **«Связь с Kaspi потеряна»**.

**Узнаю ли я об обрыве, или замечу по недовольным клиентам?**
При переходе сессии в мёртвую владельцу уходит уведомление в WhatsApp (не чаще раза в сутки на организацию), а в кабинете статус кассира меняется на «Требуется вход заново». Интеграции опрашивают `GET /api/v1/account/health` → `connection.needs_reauth`.

**После переподключения кассира нужно перевыставлять счета?**
Нет, если номер тот же. Переавторизация того же кассира ничего не меняет — всё продолжает работать: счета, подписки, печатные листы, возвраты. Неоплаченные счета прежнего кассира могут закрыться только при смене кассира на другой номер.

**Нужно ли удалять приложение Kaspi с телефона кассира?**
Не обязательно. Достаточно не входить в Kaspi Pay под этим номером. Но если телефон в чужих руках и есть риск случайного входа — удалить именно Kaspi Pay проще всего.

**Как в Kaspi отвязать кассира?**
В кабинете ApiPay: Настройки → «Авторизация Kaspi» → «Отключить» или «Сменить кассира». Сотрудника в самом Kaspi Pay убирают в приложении Kaspi Pay, в разделе «Сотрудники».

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

---

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