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

# Как подключить свою Kaspi-кассу к ApiPay?

**TL;DR.** Подключение кассира — это мастер из шести экранов прямо в кабинете apipay.kz, он занимает **2–3 минуты** (так и написано на первом экране). Вы отметите 3 обязательных правила, введёте номер кассира, получите код в SMS (он живёт **около минуты**) и подтвердите его — касса привязана. Сразу после этого включаются **3 дня бесплатного тестового доступа**. Главное правило, ради которого мастер повторяет его трижды: после привязки **не входите в приложение Kaspi Pay под номером кассира** — иначе связь разорвётся и подключать придётся заново.

## Коротко

| Параметр | Значение |
|---|---|
| Сколько занимает | 2–3 минуты — так говорит сам мастер |
| Где делается | Кабинет apipay.kz, полноэкранный мастер с прогрессом «Шаг X из Y» |
| Что нужно заранее | Номер кассира с ролью только «Кассир» в Kaspi Pay + живая SIM для SMS |
| Код из SMS | Действует около минуты; повтор — через 60 секунд |
| Главное правило | Под номером кассира больше не входить в Kaspi Pay |
| Сразу после привязки | 3 дня бесплатного тестового доступа (один раз на пользователя) |
| Стоимость | Подключение бесплатное |

## Зачем это нужно

Привязка кассира нужна, чтобы принимать **настоящие** платежи Kaspi: без неё счета выставлять некому. ApiPay — независимый сервис поверх вашего Kaspi Pay, который выставляет счета через штатную роль «Кассир»; деньги при оплате идут напрямую на ваш Kaspi-счёт, ApiPay к ним доступа не имеет. Процедура безопасная и занимает 2–3 минуты — ниже разберём её по шагам, чтобы вы прошли с первого раза.

## Что понадобится до старта

Это самая важная секция: если подготовить номер заранее, мастер пройдёт без единой ошибки. До запуска проверьте:

- **Приложение Kaspi Pay установлено** на телефоне кассира.
- **Номер кассира добавлен в «Сотрудники»**: в приложении Kaspi Pay → Настройки → Сотрудники → «+ Добавить сотрудника».
- **Роль этого номера — ровно «Кассир»**. Не «Управляющий», не «Бухгалтер», не «Менеджер Магазина», не «Менеджер Маркетинга». С любой другой ролью подключение не сработает.
- **Телефон кассира включён и принимает SMS** — не виртуальный номер: на него Kaspi пришлёт код.
- **Готовность соблюдать правило:** под этим номером после привязки в Kaspi Pay больше не входить.

Кассир — это отдельный номер телефона, у которого в приложении Kaspi Pay есть роль «Кассир». На него Kaspi пришлёт SMS с кодом — этим кодом мы и привяжем номер. Какой номер подойдёт и почему ваш может не пройти — разобрано в отдельном разборе [требований к номеру кассира](/guides/trebovaniya-k-nomeru-kassira).

## Подключение шаг за шагом

Мастер полноэкранный, с полосой прогресса «Шаг 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, попробуйте снова; если повторяется — напишите в поддержку. |

Если касса **уже привязана**, кабинет предложит не подключение, а «Сменить кассира» — это не ошибка, а подтверждение. Как сменить кассира описано в разборе [«кассир уволился или сменился номер»](/guides/smena-kassira-nomera-vladeltsa).

## Частые ошибки

- **Дать номеру роль «Управляющий» или «Менеджер».** Подключение не сработает — нужна только роль «Кассир».
- **Войти в Kaspi Pay под номером кассира «просто проверить».** Привязка разорвётся, и её придётся делать заново. Это причина №1 обрыва связи.
- **Передавать код по цепочке** (кассир → бухгалтер → вы): пока код дойдёт, он истечёт — он живёт около минуты. Держите телефон кассира под рукой.

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

**Kaspi прислал «ссылку на скачивание» вместо кода — что делать?**
Это нормально, скачивать ничего не нужно: сообщение означает, что кассир добавлен. Просто дождитесь именно SMS с кодом.

**Код не пришёл или уже не подходит.**
Код действует около минуты. Нажмите «Отправить ещё раз» (кнопка станет доступна через 60 секунд) и введите новый код сразу же. Держите телефон кассира рядом.

**Почему нельзя заходить в Kaspi Pay под номером кассира?**
Привязка разорвётся: платежи перестанут проходить, и её придётся делать заново. Поэтому мастер и повторяет это правило трижды.

**Какую роль выбрать?**
Только «Кассир». «Управляющий», «Бухгалтер», «Менеджер Магазина», «Менеджер Маркетинга» не подойдут.

**У меня несколько точек — можно подключить несколько касс?**
Да, к одной организации можно подключить несколько кассиров, каждый — свой номер. Сначала подключите первую кассу по этой инструкции; про несколько касс есть отдельный разбор про мультикассир.

## Что дальше

- **3 дня тестового доступа** включаются автоматически сразу после подключения кассира и даются один раз на пользователя — это ваш бесплатный старт в рабочем режиме. Подробнее — в разборе про [тестовый период](/guides/testovyy-period).
- **Тестовый режим (песочница):** если организация в песочнице, настоящие счета в Kaspi не уходят — можно спокойно создать тестовый счёт и всё проверить. Когда будете готовы принимать реальные платежи, выключите тестовый режим в Настройках. Чем песочница отличается от рабочего режима — [здесь](/guides/pesochnitsa-i-rabochiy-rezhim).
- **Первый счёт** можно выставить прямо из кабинета или по API — техническая документация на странице [apipay.kz/docs](/docs).
- **Несколько касс:** если точек больше одной, подключите каждую кассу отдельно — про мультикассир есть отдельный разбор.
- Подробный обзор процедуры — на странице [подключения кассира](/connect-cashier).

---

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