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

> Диагностика по симптому: Kaspi просит пароль или видеоверификацию, спрашивает ИИН, не приходит SMS, не успеваете ввести код. Причина и решение для каждого случая, а также тайминги SMS.

## Коротко

Если кассир не подключается, посмотрите, что именно написано на экране — по этому точно определяется причина. Чаще всего это так: **Kaspi просит пароль или видеоверификацию** — значит, номер не подходит и нужен другой. Вторая по частоте причина — номер не добавлен в «Сотрудники» в приложении Kaspi Pay. Третья — код из SMS не успел дойти вовремя. Найдите свой случай в таблице ниже.

![Выбор роли сотрудника: подходит только «Кассир»](/docs/img/kaspi-role-picker.svg)

## Диагностика по симптому

| Что вы видите | Причина | Что делать |
|---|---|---|
| Kaspi просит **пароль** | На номере есть лишняя роль помимо «Кассира», либо на ИИН владельца в Kaspi Pay зарегистрированы ИП или ТОО | Взять другой номер. Обойти это условие невозможно |
| Kaspi просит **видеоверификацию** | Та же причина: Kaspi распознал номер как номер владельца бизнеса | Взять другой номер |
| **Спрашивает ИИН** или отвечает, что такого номера в Kaspi Pay нет | Номер ещё не добавлен в «Сотрудники» в Kaspi Pay, или у него не роль «Кассир» | В **приложении** Kaspi Pay: Настройки → Сотрудники → Добавить сотрудника, роль «Кассир» |
| **SMS не приходит** | SIM отключена или нет сети; номер набран с ошибкой; Kaspi временно ограничил после частых запросов | Включить SIM, подождать 1–2 минуты, повторить. Ещё раз проверить номер |
| **Код не принимается, «не успел»** | Код живёт около минуты, он уже истёк | Запросить новый код и вводить сразу, держа телефон в руках |
| Вроде всё верно, но на последнем шаге **падает** | Временный сбой на стороне Kaspi или редкий случай | Подождать 10–15 минут и повторить. Повторяется — написать в поддержку |
| Подключился, но через какое-то время **оборвался** | С этого номера кто-то вошёл в приложение Kaspi Pay | Переподключить в кабинете и предупредить владельца номера не открывать Kaspi Pay |

## Если просят пароль или видеоверификацию

Решение здесь одно: **взять другой номер**. Повторные попытки, ожидание и вход с другого телефона не помогут.

Причина в том, что Kaspi отнёс этот номер к аккаунтам с усиленной защитой. Мы можем привязаться только через код из SMS, а пароль и видеоверификация — действия, которые человек выполняет сам в приложении Kaspi. Снаружи их пройти нельзя.

Выбирая новый номер, сразу проверьте все три условия: [Три условия для номера кассира](/kb/ru/cashier-number-requirements). Самый простой путь — купить новую SIM, примерно от 500 тенге.

## Если спрашивает ИИН или «номера нет»

Это значит, что на стороне Kaspi номер ещё не является кассиром. Порядок такой:

1. Откройте **приложение Kaspi Pay** (именно приложение, не веб-кабинет).
2. Настройки → Сотрудники → Добавить сотрудника.
3. Введите номер и поставьте роль **«Кассир»**.
4. Один раз войдите с этого номера, чтобы активировать сотрудника, и выйдите из приложения.
5. Только после этого привязывайте номер в [кабинете](https://qut.kz/app/kaspi/).

Полные шаги: [Как подключить кассира Kaspi](/kb/ru/connect-cashier).

## Тайминги SMS

Здесь спешка создаёт больше всего проблем. Конкретные цифры:

- **Код действует около минуты.** Введёте позже — он не примется.
- **Весь процесс привязки — одно окно примерно на десять минут.** Не прерывайтесь на середине.
- **Не передавайте код от человека к человеку.** Если владелец номера пересылает вам код в WhatsApp, а вводите его вы, обычно не успеваете. Делайте привязку рядом с телефоном, где стоит номер кассира.
- **Если SIM была выключена**, включите её и подождите **одну-две минуты**, пока телефон найдёт сеть, и только потом запрашивайте код.

## Если SMS всё равно не приходит

Проверьте по порядку:

1. Правильно ли набран номер — ошибка в одной цифре встречается часто.
2. Есть ли сеть на телефоне, активна ли SIM, есть ли баланс.
3. Приходят ли на этот номер другие SMS — если нет, проблема у оператора.
4. Не запрашивали ли вы код несколько раз подряд — Kaspi временно ограничивает частые запросы. Подождите 10–15 минут и повторите.
5. Убедитесь, что номер числится в «Сотрудниках» Kaspi Pay именно с ролью «Кассир».

## Всё верно, но подключение всё равно не проходит

Напишите в поддержку — WhatsApp +7 778 881 3333, Telegram @qutpaybot или раздел Поддержка в кабинете. Приложите к обращению следующее, тогда ответ сразу будет по делу:

- Что написано на экране (лучше всего скриншот)
- Во сколько вы делали попытку
- С какой ролью номер числится в Kaspi Pay
- Какие из трёх условий вы уже проверили

**Не пересылайте секреты:** код из SMS, пароль Kaspi и свой API-ключ не сообщайте никому. Поддержка ничего из этого не спрашивает.

## Чем заняться, пока проблема решается

Чтобы работа не стояла: в [режиме песочницы](/kb/ru/sandbox-vs-live) кассир не нужен. Можно полностью написать интеграцию, проверить webhook и обработку счетов. Когда кассир подключится, вы просто поменяете ключ на `qp_live_…` и начнёте принимать оплату. Пробный период песочница тоже не расходует.

## Вопросы и ответы

**Можно пройти видеоверификацию и потом подключиться?** Нет. Эта проверка относится ко входу внутри приложения Kaspi, а мы привязываемся только по коду из SMS. Номер придётся сменить.

**Если сменю номер, пропадут ли старые счета?** Нет. Счета, API-ключи и настройки webhook остаются как были.

**Kaspi блокирует номер после нескольких попыток?** Это не блокировка, а временное ограничение. Подождите 10–15 минут. Но не запрашивайте код десятки раз подряд — найти причину и сделать один раз правильно намного быстрее.

**Не могу найти раздел «Сотрудники» в веб-кабинете.** Он находится **в приложении Kaspi Pay**. Из веб-кабинета кассир не добавляется.