Сначала проверьте
- Номер добавлен как сотрудник с ролью «Кассир»? В Kaspi Pay: Профиль → Сотрудники → номер должен быть добавлен с ролью «Кассир» — и только с ней, без ролей управляющего, бухгалтера и прочих.
- На ИИН владельца нет ИП/ТОО в Kaspi Pay? Если есть — Kaspi запросит пароль и видеоверификацию, которые по SMS пройти нельзя; нужен другой номер.
- SIM живая и рядом? Карта вставлена в телефон, включена и ловит SMS — код нужно ввести за пару минут.
Ветки диагностики
| Что видите | Вероятная причина (частота по данным поддержки) | Что сделать | Подробнее |
|---|---|---|---|
| Kaspi просит пароль или видеоверификацию | На номере есть роли кроме «Кассира», или на владельца SIM оформлено ИП/ТОО — чаще всего | Взять другой номер: отдельный реальный номер, свободный от бизнеса, только роль «Кассир» | Требования к номеру кассира |
| Просит ввести ИИН / «номер не зарегистрирован» | Номер вообще не добавлен в «Сотрудники» — часто | Kaspi Pay → Профиль → Сотрудники → Добавить сотрудника → роль «Кассир» | Требования к номеру кассира |
| Номер вроде бы подходит, но Kaspi всё равно просит пароль | Номер когда-то был связан с бизнес-профилем в Kaspi Pay — редко | Взять другой номер | Требования к номеру кассира |
| Код из SMS не приходит или не успеваете ввести | SIM выключена / код истёк / Kaspi сделал паузу после повторных отправок — часто, эпизодами | Шаги ниже — у этой ветки решение здесь | — |
| Всё по правилам, а подключение падает | Сбой на стороне ApiPay — редко | Написать в поддержку, чинится быстро | — |
Код из SMS: тайминги, о которых надо знать заранее
У этой ветки нет отдельной статьи — вот полный протокол.
- Код живёт около минуты. Начинайте подключение, когда телефон кассира физически рядом, SIM вставлена и включена.
- Вся авторизация — одно окно ~10 минут. Ввод номера и ввод кода должны уложиться в него, иначе процесс начнётся заново.
- После третьей отправки кода Kaspi делает паузу 10–15 минут. Kaspi временно ограничивает выдачу кодов — просто подождите и попробуйте снова.
- Не передавайте код «по цепочке» (кассир → бухгалтер → вы): пока код дойдёт, он истечёт. Лучший вариант — телефон кассира у вас в руках.
- Если SIM была выключена — включите и подождите пару минут: SMS доходят не мгновенно.
Частые вопросы
Подойдёт ли номер, с которого я обычно общаюсь?
Если на вас оформлено ИП или ТОО — нет: Kaspi запросит верификацию, которую по SMS не пройти. Нужна отдельная SIM человека без бизнеса в Kaspi.
Можно взять номер несовершеннолетнего?
Нет — по правилам Kaspi владельцу номера должно быть 18+.
Один номер на две торговые точки?
Нет: один номер кассира может состоять только в одной точке продаж. Для второй точки — второй номер.
Как сменить номер кассира на другой?
Самостоятельно: кабинет apipay.kz → Настройки → «Авторизация Kaspi» → «Сменить кассира», код придёт на новый номер.
Нужно ли устанавливать Kaspi Pay на телефон кассира?
Нет. Важно лишь, чтобы номер был добавлен в Kaspi Pay с ролью «Кассир» — и чтобы под ним никто не входил в приложение после подключения.
Для вашего ИИ-агента
Если подключаете кассира программно (Partner API), смотрите коды отказа шага send-phone: not_cashier (у номера нет роли «Кассир»), not_registered (не добавлен в «Сотрудники»), context_expired (окно ~10 минут истекло — повторите init).