> Источник: 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 под номером кассира** — иначе связь разорвётся и подключать придётся заново.

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

Привязка кассира нужна, чтобы выставлять счета Kaspi: без неё выставлять их некому. ApiPay работает через штатную роль «Кассир», деньги при оплате приходят на ваш Kaspi-счёт. Подключение бесплатное.

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

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

Какой номер подойдёт, чей номер взять и почему ваш может не пройти — в разборе [требований к номеру кассира](/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 дня тестового доступа»** появляется, когда триал действительно выдан. Если организация в тестовом режиме — увидите плашку про [песочницу](/guides/pesochnitsa-i-rabochiy-rezhim). Нажмите **«Готово»**.

## Если что-то пошло не так

На экране ошибки кнопка «Попробовать снова» заблокирована, пока вы не отметите «я проверил это в 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) | Сработала защита от частых попыток | Ждите ровно столько, сколько показано на кнопке повтора: она разблокируется сама. Повтор с **тем же** номером счётчик не расходует — не меняйте номер наугад. Разбор счётчика — в [диагностике подключения](/guides/kassir-ne-podklyuchaetsya). |
| «Kaspi не смог прислать SMS» | SMS не ушла | Проверьте, что номер верный, принимает SMS (не виртуальный), телефон включён и в зоне сети. |
| «Сессия привязки истекла» | Экран был открыт слишком долго | Начните подключение заново с первого шага. |
| «Kaspi временно недоступен» | Kaspi перегружен | Подождите — кнопка повтора разблокируется сама по таймеру. |
| «Сервис Kaspi временно недоступен» | Редкий сбой на стороне Kaspi | Подождите 5–10 минут и попробуйте снова. |
| «Что-то пошло не так» | Причина не распозналась | Проверьте номер и роль «Кассир» в Kaspi Pay, попробуйте снова; если повторяется — напишите в поддержку. |

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

Ещё один исход шага с кодом — сообщение о том, что **это кассир другой организации Kaspi**.

Организация закрепляется за первым подключённым кассиром и потом не меняется. Подключайте кассира той организации, к которой относится этот кабинет, — или откройте кабинет нужной организации.

Повторять код в прежнем месте бессмысленно: причина не во вводе, а в том, чей это кассир.

Если организация действительно ваша, а бизнес перешёл к вам от прежнего владельца — напишите в поддержку **77003076512**.

Смена владельца оформляется по обращению, а не кнопкой в кабинете. Подробнее — в разборе [«кассир уволился или сменился номер»](/guides/smena-kassira-nomera-vladeltsa).

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

**У меня несколько точек — можно подключить несколько касс?**
Да, к одной организации можно подключить несколько кассиров, каждый — свой номер. Сначала подключите первую кассу по этой инструкции, дальше — [два кассира на организацию](/guides/dva-kassira-na-organizatsiyu).

**Почему подключение не проходит — Kaspi просит пароль, видео или ИИН?**
Это разбирается отдельно: [кассир не подключается](/guides/kassir-ne-podklyuchaetsya).

## Что дальше

- **3 дня тестового доступа** включаются автоматически при первом подключении этой организации; повторная привязка кассира в той же организации триал не открывает. Не подключайте кассира «на будущее» — пока интеграция не готова, отлаживайтесь в песочнице. Условия доступа — в разборе про [тестовый период](/guides/testovyy-period).
- **Первый счёт** можно выставить прямо из кабинета или по API — техническая документация на странице [apipay.kz/docs](/docs).
- Подробный обзор процедуры — на странице [подключения кассира](/connect-cashier).

---

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