# Как добавить кассира в Kaspi Pay для онлайн-платежей

Пошаговая инструкция: создайте ограниченного кассира в Kaspi Pay, подготовьте отдельный номер и безопасно подключите его к xpayment API.

Чтобы подключить онлайн-платежи Kaspi Pay к сайту, Telegram-боту, CRM, мобильному приложению или n8n-сценарию через [xpayment.kz](https://xpayment.kz/), сначала лучше создать отдельного кассира в Kaspi Pay. Это не формальность. Это базовый слой безопасности: xpayment работает не с основным аккаунтом владельца бизнеса, а с ограниченной ролью кассира.

Кассир может принимать платежи и видеть свою историю операций. Он не управляет счетами компании, не переводит деньги и не видит операции других сотрудников. Поэтому именно кассира нужно использовать для подключения платежного устройства к API.

## Короткий ответ

В Kaspi Pay кассир добавляется так:

1. Откройте приложение Kaspi Pay.
2. Перейдите в `Сервисы -> Профиль компании -> Сотрудники`.
3. Нажмите `Добавить`.
4. Выберите роль `Кассир`.
5. Выберите точку продаж.
6. Введите телефон и имя кассира.
7. Подтвердите добавление.

Официальная инструкция Kaspi описывает этот путь в статье [Как добавить кассира](https://guide.kaspi.kz/partner/ru/profile/user/cashier/q1402).

## Зачем xpayment нужен отдельный кассир

xpayment подключает ваш продукт к платежной системе через устройство, привязанное к Kaspi Pay. Сейчас платформа поддерживает Kaspi Pay и дает разработчику один понятный API для платежей, webhook-уведомлений и статусов.

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

Безопасная модель выглядит так:

| Уровень | Что делает |
|---|---|
| Владелец Kaspi Pay | Управляет компанией и счетами |
| Кассир Kaspi Pay | Принимает платежи в одной точке продаж |
| xpayment | Подключает кассира как устройство и выдает API-ключ |
| Ваш продукт | Создает платежи и получает webhook о результате |

Такой подход дает минимально нужный доступ. Если вы подключаете онлайн-магазин, CRM или бота, ему не нужен доступ к балансу компании. Ему нужно только создать платеж и узнать, оплатил ли клиент заказ.

## Что подготовить заранее

Перед добавлением кассира проверьте три вещи.

### Активный аккаунт Kaspi Pay

Если у бизнеса уже есть Kaspi Pay, можно сразу переходить к добавлению сотрудника. Если аккаунта еще нет, сначала зарегистрируйте бизнес в приложении Kaspi Pay.

### Точка продаж

Кассир должен быть привязан к точке продаж. Если точки продаж нет, создайте ее в Kaspi Pay в разделе профиля компании.

### Отдельный номер телефона

Для кассира нужен номер, который будет использоваться для входа в Kaspi Pay. Это может быть номер сотрудника, отдельная SIM-карта или номер, выделенный под онлайн-платежи.

Важно: используйте номер, к которому у вас есть стабильный доступ. Он понадобится при подключении устройства в xpayment и при подтверждении OTP.

## Пошаговая инструкция

### Шаг 1. Откройте сотрудников

В приложении Kaspi Pay откройте:

```text
Сервисы -> Профиль компании -> Сотрудники
```

Этот путь совпадает с официальной инструкцией Kaspi для добавления кассира.

### Шаг 2. Нажмите `Добавить`

Kaspi Pay предложит выбрать роль сотрудника. Для интеграции с xpayment нужна роль `Кассир`.

Не выбирайте роль администратора или владельца. Для онлайн-платежей через API достаточно роли кассира.

### Шаг 3. Выберите точку продаж

Кассир работает в рамках конкретной точки продаж. Это важно для учета платежей и уведомлений.

По справке Kaspi, один кассир может принимать платежи только в одной точке продаж: [Можно ли добавить одного кассира в несколько точек продаж?](https://guide.kaspi.kz/partner/ru/profile/user/cashier/q1405)

Если у вас несколько точек продаж, создайте отдельного кассира для нужной точки.

### Шаг 4. Укажите телефон и имя

Введите телефон кассира и имя сотрудника. После добавления на этот номер придет SMS.

Kaspi описывает запуск кассира отдельно: сотрудник получает SMS со ссылкой на приложение Kaspi Pay, скачивает приложение, вводит номер телефона и подтверждает вход SMS-кодом. Источник: [Как кассиру начать принимать оплату?](https://guide.kaspi.kz/partner/ru/profile/user/cashier/q1414)

### Шаг 5. Проверьте ограничения

| Вопрос | Ответ |
|---|---|
| Можно ли одного кассира добавить в несколько точек? | Нет, один кассир работает в одной точке продаж. |
| Можно ли добавить много кассиров в одну точку? | Да, Kaspi указывает, что количество кассиров в одной точке не ограничено. |

Источник по количеству кассиров: [Сколько кассиров можно добавить в одну точку продаж?](https://guide.kaspi.kz/partner/ru/profile/user/cashier/q1409)

## Что делать после добавления кассира

После того как кассир создан и может войти в Kaspi Pay, переходите к xpayment:

1. Откройте [xpayment.kz](https://xpayment.kz/).
2. Войдите в личный кабинет.
3. Добавьте устройство или виртуального кассира.
4. Укажите номер кассира.
5. Подтвердите OTP.
6. Создайте API-ключ устройства.

После этого ваш backend, сайт, бот, CRM или n8n-сценарий сможет вызывать xpayment API и создавать платежи.

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

### Подключать основной номер владельца

Так делать не стоит. Основной аккаунт имеет слишком много прав.

### Использовать номер без постоянного доступа

Номер кассира может понадобиться для повторного подтверждения или восстановления сессии. Лучше использовать номер, который контролирует бизнес.

### Создать кассира не в той точке продаж

Если платежи должны идти через конкретную точку, проверьте привязку перед подключением xpayment.

## Следующий шаг

Когда кассир готов, подключите его как виртуального кассира в xpayment и получите API-ключ для вашего приложения.

Полезные ссылки:

- [xpayment.kz](https://xpayment.kz/) - платформа для подключения онлайн-платежей через API.
- [Документация xpayment API](https://xpayment.kz/docs) - endpoints, webhook и примеры запросов.
- [Официальная инструкция Kaspi: как добавить кассира](https://guide.kaspi.kz/partner/ru/profile/user/cashier/q1402)

## Читайте также
- [Виртуальный кассир xpayment](https://xpayment.kz/blog/xpayment-virtual-cashier-api)
- [Полное подключение xpayment](https://xpayment.kz/blog/onboarding)

---

Источник: https://xpayment.kz/blog/kaspi-pay-cashier-setup