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

# Кассир Kaspi не подключается — почему и что делать?

**TL;DR.** Кассир — это отдельный номер сотрудника с ролью «Кассир» в вашем Kaspi Pay: через него ApiPay выставляет счета из кабинета, сайта или CRM, а подключают его в кабинете ApiPay [мастером подключения кассира](/connect-cashier) — шесть экранов, 2–3 минуты, один SMS-код. Чаще всего подключение не проходит по трём причинам: у номера есть роли кроме «Кассир» или на владельца SIM оформлено ИП/ТОО (Kaspi просит пароль или видеоверификацию — нужен другой номер); номер не добавлен в Kaspi Pay → Настройки → Сотрудники (Kaspi просит ИИН — добавьте его с ролью «Кассир» и начните заново); код из SMS не успели ввести (он действует около минуты — держите телефон кассира рядом). Если мастер так и не проходит, запасной путь — поддержка ApiPay в WhatsApp **77003076512**.

## Что значит то, что вы видите на экране?

| Что видите | Вероятная причина | Что сделать | Подробнее |
|---|---|---|---|
| Kaspi просит **пароль** или **видеоверификацию** | На номере есть роли кроме «Кассира», или на владельца SIM оформлено ИП/ТОО | Взять другой номер: отдельный реальный номер, свободный от бизнеса, только роль «Кассир» | [Требования к номеру кассира](/guides/trebovaniya-k-nomeru-kassira) |
| Просит ввести **ИИН** / «Этого номера нет в Kaspi Pay» | Номер вообще не добавлен в «Сотрудники» | Kaspi Pay → Настройки → Сотрудники → Добавить сотрудника → роль «Кассир», затем начать подключение заново | [Требования к номеру кассира](/guides/trebovaniya-k-nomeru-kassira) |
| **Код из SMS не приходит** или не успеваете ввести | SIM выключена / код истёк / Kaspi ограничил выдачу кодов | Шаги ниже — у этой ветки решение здесь | — |
| Кабинет пишет **«Кассир сейчас недоступен»** | Этот номер подключить нельзя, причина не раскрывается | Повтор с тем же номером не поможет — возьмите другой номер кассира или напишите в поддержку | — |
| Мастер пишет **«Сначала анкета „Расскажите о бизнесе“»** | Подключение кассира открывается после одобрения анкеты | Заполнить анкету; проверка обычно занимает несколько часов | [Настройка ApiPay за 15 минут](/guides/nastroyka-apipay-za-15-minut) |
| Всё по правилам, а подключение не проходит | Причина не определилась | Написать в поддержку: номер кассира, скриншот экрана Kaspi, время попытки | — |

## Почему не приходит код из SMS и как успеть его ввести?

1. **Код живёт около минуты.** Начинайте подключение, когда телефон кассира физически рядом, SIM вставлена и включена.
2. **Вся авторизация — одно окно ~10 минут.** Ввод номера и ввод кода должны уложиться в него, иначе процесс начнётся заново.
3. **Если Kaspi ограничил выдачу кодов** (`kaspi_busy`, HTTP 503) — пауза около минуты, после неё подключение запускают заново. В кабинете кнопка повтора разблокируется по таймеру сама.
4. **Не передавайте код «по цепочке»** (кассир → бухгалтер → вы): пока код дойдёт, он истечёт. Лучший вариант — телефон кассира у вас в руках.
5. Если SIM была выключена — включите и подождите пару минут: SMS доходят не мгновенно.

## Как добавить сотрудника-кассира в Kaspi Pay?

Этот шаг делается не в ApiPay, а в **вашем** приложении Kaspi Pay:

1. Настройки → Сотрудники → «+ Добавить сотрудника».
2. Введите номер кассира и выберите роль **только «Кассир»** — «Управляющий», «Бухгалтер» и «Менеджер» не подойдут.
3. Если Kaspi пришлёт на номер кассира ссылку на скачивание приложения, ничего скачивать не нужно: это значит, что сотрудник добавлен.

Названия разделов в приложении задаёт Kaspi и может менять; что умеет роль, Kaspi описывает в своей справке, в разделе «[Кассир](https://guide.kaspi.kz/partner/ru/profile/user/cashier/q3450)». После этого откройте в кабинете ApiPay [мастер подключения кассира](/connect-cashier) — пошагово он разобран в инструкции [«Как подключить свою Kaspi-кассу к ApiPay»](/guides/podklyuchenie-kassira-kaspi). Какой номер выбрать, чтобы Kaspi не попросил пароль, — в [требованиях к номеру кассира](/guides/trebovaniya-k-nomeru-kassira).

## Частые вопросы

**Почему Kaspi просит пароль или видеоверификацию при подключении кассира?**
На номере есть роли кроме «Кассира» или на владельца SIM оформлено ИП/ТОО. Такой номер не подойдёт — нужна реальная SIM, свободная от бизнеса, добавленная в Kaspi Pay только с ролью «Кассир».

**Kaspi просит ввести ИИН — что это значит?**
Номер не добавлен в сотрудники. Добавьте его: Kaspi Pay → Настройки → Сотрудники → Добавить сотрудника → роль «Кассир», затем начните подключение заново.

**Код из SMS не приходит или не успеваю ввести — что делать?**
Код живёт около минуты, вся авторизация — окно около 10 минут. Если Kaspi ограничил выдачу кодов, пауза около минуты — затем запустите подключение заново. Держите телефон кассира рядом и не передавайте код по цепочке.

**Можно ли один номер кассира подключить к нескольким сервисам?**
Держите для ApiPay отдельный номер: любой другой вход в Kaspi Pay под номером кассира — в приложении или через другой сервис — обрывает сессию ApiPay, и счета перестают выставляться. Подробнее — в [требованиях к номеру кассира](/guides/trebovaniya-k-nomeru-kassira) и в разборе [«Привязка кассира разорвалась»](/guides/pochemu-sletala-sessiya-kassira).

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

## Как разбирать отказы подключения кассира через API?

Если подключаете кассира программно, разбирайте ответ `POST /api/v1/connections/{id}/auth/send-phone` (и партнёрский `POST /api/partner/organizations/{id}/kaspi-auth/send-phone`) по коду ошибки — поле `error_code`, а если его нет, `error`:

- `not_cashier` — 422, у номера есть роли сверх кассира.
- `not_registered` — 422, номер не заведён кассиром в Kaspi. **Терминально:** сессия закрыта, следующий `send-phone` вернёт `409 no_process`, нужен новый `init`.
- `context_expired` — 409, окно процесса ~10 минут истекло, нужен новый `init`.
- `cashier_unavailable` — 409, кассира сейчас нельзя подключить. Причина не раскрывается, различить её программно нельзя, повтор с тем же номером не помогает: показывайте нейтральный текст и ведите в поддержку.
- `rate_limited` — 429, за сутки пробовали слишком много **разных** номеров кассиров. Окно суточное: `Retry-After` (в партнёрском конверте ещё `retry_after_seconds`) содержит секунды до обнуления счётчика, обычно это часы. Считаются только новые номера: повтор с тем же номером счётчик не расходует, уже подключённые кассиры владельца в него не входят.
- `sms_failed` — 502, Kaspi не вернул экран ввода кода.
- `kaspi_busy` — 503, Kaspi временно не выдаёт код. Пауза около 60 секунд, затем новый `init`. На мерчантской поверхности приходит `Retry-After: 60`; в партнёрском ответе заголовка нет — используйте собственный бэкофф с ориентиром 60 секунд.

Отдельно от них существует поминутный лимит запросов: он отдаёт 429 с телом `{"message":"Too Many Attempts."}` **без** `error_code` и снимается примерно за минуту. Различайте эти два 429 по наличию `error_code`.

На `verify-otp` неверный код — это `200 {"success": false}` и он повторяем, а `not_registered` (422), `context_expired` (409) и `kaspi_busy` (503) терминальны: сессия закрыта, нужен новый `init`. Там же возможен `organization_identity_conflict` (409) — кассир принадлежит другой организации Kaspi. Организация закрепляется за первой привязкой и потом не меняется, поэтому подключать нужно кассира той организации, за которой эта уже закреплена. Если Kaspi не вернул данные организации, приходит `organization_identity_unavailable` (502): попытка закрыта, начните с нового `init`. У обоих в теле только `error` и `message`, поля `error_code` нет.

---

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