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

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

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

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

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

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

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

Официальная инструкция Kaspi описывает этот путь в статье Как добавить кассира.

Зачем 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 откройте:

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

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

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

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

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

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

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

По справке Kaspi, один кассир может принимать платежи только в одной точке продаж: Можно ли добавить одного кассира в несколько точек продаж?

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

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

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

Kaspi описывает запуск кассира отдельно: сотрудник получает SMS со ссылкой на приложение Kaspi Pay, скачивает приложение, вводит номер телефона и подтверждает вход SMS-кодом. Источник: Как кассиру начать принимать оплату?

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

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

Источник по количеству кассиров: Сколько кассиров можно добавить в одну точку продаж?

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

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

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

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

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

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

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

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

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

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

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

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

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

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