> Источник: https://apipay.kz/connect-cashier · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# Как подключить кассира Kaspi для ApiPay

**TL;DR.** Подключение кассира — это привязка вашей организации Kaspi Pay к ApiPay через штатную роль «Кассир». Вы заводите отдельную SIM-карту, добавляете её номер сотрудником с ролью «Кассир» в своём приложении Kaspi Pay, а потом в кабинете `apipay.kz` проходите мастер: «Настройки» → вкладка «Авторизация Kaspi» → «Подключить». Мастер занимает 2–3 минуты и заканчивается вводом кода из SMS, который Kaspi присылает на номер кассира. Главное правило после привязки: под этим номером больше не входить в приложение Kaspi Pay — иначе связь разорвётся.

## Что такое «кассир» и зачем он нужен

«Кассир» — это штатная роль сотрудника в приложении Kaspi Pay (для бизнеса) с ограниченными правами. Обычно её дают человеку за прилавком; здесь её занимает ApiPay: сервис выставляет счета от имени вашей организации, а деньги покупателей идут напрямую на ваш Kaspi-счёт.

Что кассир может: выставлять счета, проверять статус оплаты, делать возврат по своим счетам.

Что кассир не может: выводить деньги, видеть баланс организации, видеть счета других сотрудников, менять настройки организации, добавлять и удалять сотрудников. Состав прав роли описан в справке Kaspi.

Работает для ИП и для ТОО одинаково. На ваш QR-код, терминалы и уведомления о переводах подключение кассира не влияет — Kaspi Pay работает как раньше.

## Что нужно подготовить до начала

**Анкета о бизнесе должна быть одобрена.** Маршрут такой: регистрация → анкета «Расскажите о вашем бизнесе» → подключение кассира → боевые счета. Пока анкета не одобрена, кассира подключить нельзя, и реальных счетов у организации не будет — отлаживаться в это время можно в песочнице, она открыта сразу после регистрации. Анкета заполняется один раз, проверка обычно занимает несколько часов.

**Два разных номера телефона — не перепутайте их.**

1. **Личный номер** — им вы входите на `apipay.kz` (вход подтверждается в WhatsApp). Это номер владельца или руководителя: на него приходят уведомления о счетах, оплатах и ошибках.
2. **Номер кассира** — отдельная SIM-карта, которую вы добавляете сотрудником в Kaspi Pay. Для входа в кабинет ApiPay она не используется.

**Требования к номеру кассира — три условия:**

- **Реальная SIM-карта, а не виртуальный номер.** На неё придёт SMS с кодом, и телефон должен быть под рукой в момент подключения.
- **На ИИН владельца этой SIM нет ИП или ТОО в Kaspi Pay.** Иначе Kaspi при входе запросит пароль или видеопроверку — по SMS их пройти нельзя, и номер для роли кассира не подойдёт.
- **В Kaspi у номера только роль «Кассир»** — без ролей управляющего, бухгалтера, менеджера.

Подойдёт номер супруга, родственника, партнёра или отдельная SIM-карта (от 500 тенге). Свой основной номер лучше не использовать: Kaspi держит одну активную сессию на номер, и ваш собственный вход в Kaspi Pay будет каждый раз обрывать привязку.

Ещё две вещи заранее: номер кассира виден покупателю в уведомлении о счёте (на оплату это не влияет), а SIM должна оставаться активной: если оператор деактивирует её за долгое неиспользование, интеграция перестанет работать и понадобится новый кассир. Держите на номере минимальный баланс или тариф без абонентской платы.

## Шаги по порядку

1. **Добавьте номер кассира в свой Kaspi Pay.** В приложении или на сайте Kaspi Pay: Настройки (в некоторых версиях — Профиль) → Сотрудники → «+ Добавить сотрудника» → укажите номер и выберите роль **только «Кассир»**. Ставить приложение на телефон кассира и входить под его номером не нужно — от этого телефона требуется только приём SMS.
2. **Не пугайтесь сообщения про скачивание приложения.** После добавления сотрудника Kaspi отправит на его номер ссылку на приложение Kaspi Pay — скачивать ничего не надо ни вам, ни кассиру. Это сообщение значит, что сотрудник добавлен.
3. **Войдите в кабинет ApiPay.** Откройте `apipay.kz` и войдите по своему личному номеру — вход подтверждается в WhatsApp. Регистрация, если её ещё не было, занимает около минуты.
4. **Откройте «Настройки» → вкладка «Авторизация Kaspi» и нажмите «Подключить».** Откроется мастер подключения кассира; на первом экране написано, что он займёт 2–3 минуты.
5. **Отметьте три галочки.** Мастер попросит подтвердить: номер добавлен в «Сотрудники»; роль у него только «Кассир»; под этим номером вы не будете входить в Kaspi Pay после подключения. Кнопка «Дальше» активна только когда отмечены все три.
6. **Введите номер кассира и укажите его роль.** Номер вводится в формате `+7 (7XX) XXX-XX-XX`. Если выбрать любую роль, кроме «Кассир», мастер сразу скажет, что номер не подойдёт, и подскажет, как поменять роль в Kaspi Pay.
7. **Подтвердите предупреждение и запросите SMS.** Отдельный экран ещё раз просит не входить в Kaspi Pay под этим номером; отметьте галочку и нажмите кнопку отправки SMS.
8. **Введите код из SMS и нажмите «Подтвердить».** Код приходит от Kaspi и действует около минуты — вводите сразу. Если код не пришёл, кнопка «Отправить ещё раз» станет доступной через 60 секунд.
9. **Готово.** Мастер покажет экран «Кассир подключён» с вашей организацией и номером.

Держите весь процесс в одном заходе: у авторизации есть окно примерно в 10 минут, после которого мастер нужно начинать заново.

## Что будет после подключения

- Можно выставлять счета — из кабинета ApiPay или по API.
- **При первом подключении организации включаются 3 дня бесплатного тестового доступа.** Повторная привязка кассира в той же организации триал уже не открывает, поэтому не подключайте кассира «на будущее».
- **Под номером кассира нельзя входить в приложение Kaspi Pay (для бизнеса).** Любой такой вход вытесняет сессию ApiPay: новые счета перестанут выставляться, пока кассира не подключат заново по SMS. Обычным личным приложением Kaspi на этом номере пользоваться можно.
- Если привязка оборвалась, переподключение — самообслуживание: те же «Настройки» → «Авторизация Kaspi», кнопка «Подключить заново», номер тот же.
- Организация закрепляется за первым подключённым кассиром и потом не меняется. Поэтому подключайте кассира той организации Kaspi, к которой относится этот кабинет: если привязать кассира другой организации, мастер откажет, а уже закреплённую организацию сменить нельзя. У бизнеса с двумя организациями Kaspi заведите под каждую отдельный кабинет ApiPay.
- Отключить кассира можно двумя способами: удалить его из «Сотрудников» в Kaspi Pay или нажать «Отключить» на вкладке «Авторизация Kaspi». Учтите денежное последствие: после отключения ApiPay не сможет провести возврат по ранее оплаченным счетам — такие возвраты делаются вручную в приложении Kaspi Pay.

## Если не получается

| Что вы видите | Причина | Что делать |
|---|---|---|
| Kaspi просит пароль или видеопроверку вместо кода | На ИИН владельца номера есть ИП/ТОО в Kaspi Pay, либо у номера есть роли сверх кассира | Взять другой номер: отдельная SIM, свободная от бизнеса, роль только «Кассир» |
| «Этого номера нет в Kaspi Pay» или просят ИИН | Номер не заведён сотрудником | Добавить номер в Kaspi Pay → Сотрудники с ролью «Кассир» и начать подключение заново с первого шага |
| «Этот номер есть в Kaspi, но не заведён кассиром» | У номера есть роли, кроме кассира | Kaspi Pay → Сотрудники → выбрать сотрудника → изменить роль на «Кассир» |
| SMS не приходит | SIM выключена, вне сети, виртуальная или не принимает сообщения | Проверить номер и связь, включить телефон, подождать пару минут и запросить код заново |
| «Код неверный или устарел» | Код живёт около минуты | Запросить новый и ввести сразу, держа телефон кассира в руках |
| «Слишком много попыток» | Сработала защита от частых попыток | Дождаться, пока кнопка повтора разблокируется сама; не перебирать номера наугад |
| «Сессия привязки истекла» | Мастер был открыт дольше окна авторизации | Начать подключение с первого шага |
| «Кассир сейчас недоступен» / «Kaspi временно недоступен» | Сторона Kaspi | Повтор с тем же номером может не помочь — подождать и попробовать снова либо написать в поддержку |
| Подключение вообще не открывается | Анкета о бизнесе ещё не одобрена | Дождаться одобрения анкеты, пока работать в песочнице |

Не помогло — **запасной путь**: напишите в WhatsApp **+7 700 307 65 12**, специалист подключит кассира вместе с вами. Поддержка работает с 9:00 до 21:00 по Алматы, без выходных. Зарегистрироваться на `apipay.kz` нужно в любом случае: кассир привязывается к вашему аккаунту.

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

**У меня Kaspi, а не Kaspi Pay. В чём разница?**
Kaspi — личное приложение для переводов и покупок. Kaspi Pay — отдельное приложение для предпринимателей, через которое принимают платежи от клиентов. Для ApiPay нужен именно Kaspi Pay; подключается он на `kaspi.kz/pay`.

**Это безопасно? Кассир не выведет деньги?**
У роли «Кассир» минимальные права: выставить счёт, посмотреть статус, сделать возврат по своим счетам. Вывод денег, баланс организации и её настройки кассиру недоступны.

**Можно ли использовать свой основной номер?**
Технически да, если на вашем ИИН нет другого ИП или ТОО в Kaspi Pay. Но не рекомендуем: одна активная сессия на номер означает, что ваш личный вход в Kaspi Pay будет рвать привязку.

**Можно ли подключить нескольких кассиров?**
Да, к одной организации — несколько кассиров, каждому нужен свой отдельный номер. Второй кассир не заменяет первого; кнопка «Сменить кассира» в кабинете — это именно замена, старая связка рвётся в момент подтверждения. Отдельной платы нет: тариф считается на организацию, и все её кассиры делят один тариф и один суточный лимит счетов. Добавить вторую кассу, не отключая первую, можно через API (`POST /connections` и авторизация по SMS) или через поддержку — кнопки для этого в кабинете нет.

**Кассир уволился или сменился его номер.**
«Настройки» → «Авторизация Kaspi» → «Сменить кассира» → новый номер, 2–3 минуты. Счета и история платежей хранятся на организации и при смене кассира остаются на месте.

**Сколько стоит ApiPay?**
Четыре тарифа: Старт — 10 000 ₸/мес (до 30 счетов в день), Бизнес — 25 000 ₸/мес (до 100 в день), Про — 60 000 ₸/мес (до 300 в день), Про Макс — 90 000 ₸/мес (до 600 в день). Больше 600 счетов в день — договорная цена. Процента с платежей ApiPay не берёт, только фиксированную подписку. Комиссию за приём платежа удерживает Kaspi по вашим условиям Kaspi Pay.

## Куда дальше

- Подробный разбор мастера подключения: https://apipay.kz/guides/podklyuchenie-kassira-kaspi.md
- Не подключается — диагностика по симптомам: https://apipay.kz/guides/kassir-ne-podklyuchaetsya.md
- Какой номер подходит для кассира: https://apipay.kz/guides/trebovaniya-k-nomeru-kassira.md
- Привязка разорвалась, как переподключить: https://apipay.kz/guides/pochemu-sletala-sessiya-kassira.md
- Несколько кассиров на одну организацию: https://apipay.kz/guides/dva-kassira-na-organizatsiyu.md
- Кассир уволился, сменился номер или владелец: https://apipay.kz/guides/smena-kassira-nomera-vladeltsa.md
- Анкета о бизнесе и что закрыто до её одобрения: https://apipay.kz/guides/anketa-o-biznese-i-limit.md
- Обзор приёма оплаты Kaspi через API: https://apipay.kz/kaspi-api.md

---

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