Зачем это нужно
Привязка кассира нужна, чтобы принимать настоящие платежи Kaspi: без неё счета выставлять некому. ApiPay — независимый сервис поверх вашего Kaspi Pay, который выставляет счета через штатную роль «Кассир»; деньги при оплате идут напрямую на ваш Kaspi-счёт, ApiPay к ним доступа не имеет. Процедура безопасная и занимает 2–3 минуты — ниже разберём её по шагам, чтобы вы прошли с первого раза.
Что понадобится до старта
Это самая важная секция: если подготовить номер заранее, мастер пройдёт без единой ошибки. До запуска проверьте:
- Приложение Kaspi Pay установлено на телефоне кассира.
- Номер кассира добавлен в «Сотрудники»: в приложении Kaspi Pay → Настройки → Сотрудники → «+ Добавить сотрудника».
- Роль этого номера — ровно «Кассир». Не «Управляющий», не «Бухгалтер», не «Менеджер Магазина», не «Менеджер Маркетинга». С любой другой ролью подключение не сработает.
- Телефон кассира включён и принимает SMS — не виртуальный номер: на него Kaspi пришлёт код.
- Готовность соблюдать правило: под этим номером после привязки в Kaspi Pay больше не входить.
Кассир — это отдельный номер телефона, у которого в приложении Kaspi Pay есть роль «Кассир». На него Kaspi пришлёт SMS с кодом — этим кодом мы и привяжем номер. Какой номер подойдёт и почему ваш может не пройти — разобрано в отдельном разборе требований к номеру кассира.
Подключение шаг за шагом
Мастер полноэкранный, с полосой прогресса «Шаг X из Y». Экраны идут так:
Шаг 1. Начало. Экран «Подключим вашего кассира Kaspi» с подписью «Это нужно, чтобы принимать настоящие платежи. Займёт 2–3 минуты». Есть раскрывашка «Что такое кассир?». Нажмите «Начать».
Шаг 2. Проверьте 3 вещи. Три карточки-правила, у каждой — обязательный чекбокс. Кнопка «Дальше» не активна, пока не отмечены все три:
- Правило 1 — номер добавлен в «Сотрудники». Kaspi Pay на телефоне кассира: Настройки → Сотрудники → «+ Добавить сотрудника».
- Правило 2 — роль только «Кассир». Не «Управляющий», не «Бухгалтер», не «Менеджер» — иначе подключение не сработает.
- Правило 3 — под этим номером больше не заходить. После привязки не входите в Kaspi Pay под номером кассира, иначе привязка разорвётся и её придётся делать заново.
Здесь же — важная плашка: если Kaspi пришлёт «ссылку на скачивание» — это нормально, скачивать ничего не нужно. Это лишь значит, что кассир добавлен. Нажмите «Дальше».
Шаг 3. Номер кассира и его роль. Введите телефон кассира в маске +7 (7XX) XXX-XX-XX и ответьте на контрольный вопрос «Какая роль у этого номера в Kaspi Pay?». Если выбрать любую роль кроме «Кассир», сразу появится красный блок «Этот номер не подойдёт» с подсказкой, как поменять роль (Kaspi Pay → Сотрудники → выбрать сотрудника → Роль). Кнопка «Получить SMS» активна только при верном номере и роли «Кассир».
Шаг 4. Важное перед SMS. Отдельный экран-предупреждение красным: «Не заходите в Kaspi Pay под этим номером». Здесь объясняется последствие — привязка разорвётся, платежи перестанут проходить, и её придётся делать заново. Отметьте чекбокс с подставленным номером «Я не буду входить в Kaspi Pay под номером +7 (7XX)… после подключения» и нажмите «Прислать SMS».
Шаг 5. Код из SMS. Экран «Код пришёл на +7 (7XX)…. Действует около минуты». Введите код (4–6 цифр). Подсказка на экране: «Код придёт в SMS от Kaspi. Если пришло сообщение „ссылка на скачивание“ — это другое, дождитесь именно кода». Нажмите «Подтвердить». Если код не пришёл — кнопка «Отправить ещё раз» станет доступной через 60 секунд (идёт обратный отсчёт).
Шаг 6. Готово. Экран «Кассир подключён» с вашей организацией и номером. Сообщение: «Мы активировали вам 3 дня тестового доступа». Если организация в тестовом режиме — увидите плашку про песочницу (настоящие счета не отправляются, можно создать тестовый счёт, а выключить тестовый режим — в Настройках, когда будете готовы принимать реальные платежи). И финальное напоминание: главное — не входить в Kaspi Pay под номером кассира. Нажмите «Готово».
Если что-то пошло не так
Экран ошибки специально заставляет прочитать причину: кнопка «Попробовать снова» заблокирована, пока вы не отметите «я проверил это в Kaspi Pay». Рядом всегда есть кнопка «Связаться с поддержкой». Что означает каждая ошибка и что делать:
| Что случилось | Что это значит | Что сделать |
|---|---|---|
| «У этого номера не роль „Кассир“» | На номере другая роль в Kaspi Pay | Kaspi Pay → Сотрудники → выбрать сотрудника → Изменить роль → только «Кассир». Другая роль не подойдёт. |
| «Номер не зарегистрирован кассиром» | Номер не добавлен в «Сотрудники» с ролью «Кассир» | Добавьте реальный номер кассира в Kaspi Pay → Сотрудники с ролью «Кассир», затем повторите. |
| «Номер указан неправильно» | Ошибка в формате номера | Проверьте: номер начинается с 7, это казахстанский мобильный и именно тот сотрудник из Kaspi Pay. |
| «Код из SMS неверный или устарел» | Код просрочен либо введён с опечаткой | Код действует около минуты. Запросите новый и введите сразу. |
| «Слишком много попыток подряд» | Сработала защита от частых попыток | Подождите 1–2 минуты и попробуйте снова. |
| «Kaspi не смог прислать SMS» | SMS не ушла | Проверьте, что номер верный, принимает SMS (не виртуальный), телефон включён и в зоне сети. |
| «Сессия привязки истекла» | Экран был открыт слишком долго | Начните заново — это безопасно. |
| «Kaspi временно недоступен» | Kaspi перегружен | Подождите — кнопка повтора разблокируется сама по таймеру. |
| «Сервис Kaspi временно недоступен» | Редкий сбой на стороне Kaspi | Подождите 5–10 минут и попробуйте снова. |
| «Что-то пошло не так» | Причина не распозналась | Проверьте номер и роль «Кассир» в Kaspi Pay, попробуйте снова; если повторяется — напишите в поддержку. |
Если касса уже привязана, кабинет предложит не подключение, а «Сменить кассира» — это не ошибка, а подтверждение. Как сменить кассира описано в разборе «кассир уволился или сменился номер».
Частые ошибки
- Дать номеру роль «Управляющий» или «Менеджер». Подключение не сработает — нужна только роль «Кассир».
- Войти в Kaspi Pay под номером кассира «просто проверить». Привязка разорвётся, и её придётся делать заново. Это причина №1 обрыва связи.
- Передавать код по цепочке (кассир → бухгалтер → вы): пока код дойдёт, он истечёт — он живёт около минуты. Держите телефон кассира под рукой.
Частые вопросы
Kaspi прислал «ссылку на скачивание» вместо кода — что делать?
Это нормально, скачивать ничего не нужно: сообщение означает, что кассир добавлен. Просто дождитесь именно SMS с кодом.
Код не пришёл или уже не подходит.
Код действует около минуты. Нажмите «Отправить ещё раз» (кнопка станет доступна через 60 секунд) и введите новый код сразу же. Держите телефон кассира рядом.
Почему нельзя заходить в Kaspi Pay под номером кассира?
Привязка разорвётся: платежи перестанут проходить, и её придётся делать заново. Поэтому мастер и повторяет это правило трижды.
Какую роль выбрать?
Только «Кассир». «Управляющий», «Бухгалтер», «Менеджер Магазина», «Менеджер Маркетинга» не подойдут.
У меня несколько точек — можно подключить несколько касс?
Да, к одной организации можно подключить несколько кассиров, каждый — свой номер. Сначала подключите первую кассу по этой инструкции; про несколько касс есть отдельный разбор про мультикассир.
Что дальше
- 3 дня тестового доступа включаются автоматически сразу после подключения кассира и даются один раз на пользователя — это ваш бесплатный старт в рабочем режиме. Подробнее — в разборе про тестовый период.
- Тестовый режим (песочница): если организация в песочнице, настоящие счета в Kaspi не уходят — можно спокойно создать тестовый счёт и всё проверить. Когда будете готовы принимать реальные платежи, выключите тестовый режим в Настройках. Чем песочница отличается от рабочего режима — здесь.
- Первый счёт можно выставить прямо из кабинета или по API — техническая документация на странице apipay.kz/docs.
- Несколько касс: если точек больше одной, подключите каждую кассу отдельно — про мультикассир есть отдельный разбор.
- Подробный обзор процедуры — на странице подключения кассира.