Зачем это нужно
Привязка кассира нужна, чтобы выставлять счета Kaspi: без неё выставлять их некому. ApiPay работает через штатную роль «Кассир», деньги при оплате приходят на ваш Kaspi-счёт. Подключение бесплатное.
Что понадобится до старта
- Приложение Kaspi Pay есть у вас, владельца — сотрудника вы добавляете в своём приложении. Ставить Kaspi Pay на телефон кассира и входить под его номером не нужно: от телефона кассира требуется только приём SMS.
- Номер кассира добавлен в «Сотрудники»: в вашем приложении Kaspi Pay → Настройки → Сотрудники → «+ Добавить сотрудника», роль — ровно «Кассир».
- Телефон кассира включён и принимает SMS — не виртуальный номер: на него Kaspi пришлёт код.
Какой номер подойдёт, чей номер взять и почему ваш может не пройти — в разборе требований к номеру кассира.
Подключение шаг за шагом
Мастер полноэкранный, с полосой прогресса «Шаг 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, но не заведён кассиром» (not_cashier, HTTP 422) |
У номера есть роли сверх кассира | Kaspi Pay → Настройки → Сотрудники → выбрать сотрудника → Изменить роль → только «Кассир». Другая роль не подойдёт. |
«Этого номера нет в Kaspi Pay» (not_registered, HTTP 422) |
Номер не заведён кассиром в Kaspi | Проверьте, что это номер кассира, а не ваш номер входа в ApiPay. Добавьте его в Kaspi Pay → Настройки → Сотрудники с ролью «Кассир». Продолжить с того же места нельзя: на экране отказа нажмите «Начать заново» — мастер откроет подключение с первого шага. |
«Кассир сейчас недоступен» (cashier_unavailable, HTTP 409) |
Этого кассира сейчас нельзя подключить, причина не раскрывается | Повтор с тем же номером не поможет — возьмите другой номер кассира или напишите в поддержку. |
| «Номер указан неправильно» | Ошибка в формате номера | Проверьте: номер начинается с 7, это казахстанский мобильный и именно тот сотрудник из Kaspi Pay. |
| «Код из SMS неверный или устарел» | Код просрочен либо введён с опечаткой | Код действует около минуты. Запросите новый и введите сразу. |
«Слишком много попыток» (rate_limited, HTTP 429) |
Сработала защита от частых попыток | Ждите ровно столько, сколько показано на кнопке повтора: она разблокируется сама. Повтор с тем же номером счётчик не расходует — не меняйте номер наугад. Разбор счётчика — в диагностике подключения. |
| «Kaspi не смог прислать SMS» | SMS не ушла | Проверьте, что номер верный, принимает SMS (не виртуальный), телефон включён и в зоне сети. |
| «Сессия привязки истекла» | Экран был открыт слишком долго | Начните подключение заново с первого шага. |
| «Kaspi временно недоступен» | Kaspi перегружен | Подождите — кнопка повтора разблокируется сама по таймеру. |
| «Сервис Kaspi временно недоступен» | Редкий сбой на стороне Kaspi | Подождите 5–10 минут и попробуйте снова. |
| «Что-то пошло не так» | Причина не распозналась | Проверьте номер и роль «Кассир» в Kaspi Pay, попробуйте снова; если повторяется — напишите в поддержку. |
Если касса уже привязана, кабинет предложит «Сменить кассира» — подтвердите смену. Как сменить кассира описано в разборе «кассир уволился или сменился номер».
Ещё один исход шага с кодом — сообщение о том, что это кассир другой организации Kaspi.
Организация закрепляется за первым подключённым кассиром и потом не меняется. Подключайте кассира той организации, к которой относится этот кабинет, — или откройте кабинет нужной организации.
Повторять код в прежнем месте бессмысленно: причина не во вводе, а в том, чей это кассир.
Если организация действительно ваша, а бизнес перешёл к вам от прежнего владельца — напишите в поддержку 77003076512.
Смена владельца оформляется по обращению, а не кнопкой в кабинете. Подробнее — в разборе «кассир уволился или сменился номер».
Частые вопросы
У меня несколько точек — можно подключить несколько касс?
Да, к одной организации можно подключить несколько кассиров, каждый — свой номер. Сначала подключите первую кассу по этой инструкции, дальше — два кассира на организацию.
Почему подключение не проходит — Kaspi просит пароль, видео или ИИН?
Это разбирается отдельно: кассир не подключается.
Что дальше
- 3 дня тестового доступа включаются автоматически при первом подключении этой организации; повторная привязка кассира в той же организации триал не открывает. Не подключайте кассира «на будущее» — пока интеграция не готова, отлаживайтесь в песочнице. Условия доступа — в разборе про тестовый период.
- Первый счёт можно выставить прямо из кабинета или по API — техническая документация на странице apipay.kz/docs.
- Подробный обзор процедуры — на странице подключения кассира.