Коротко
Да. К одной организации можно подключить сколько угодно кассиров. У каждого — свой номер, своя привязка и своё устройство: Kaspi разрешает одному номеру только одно активное устройство, поэтому кассиров нужно держать раздельно. Одна из привязок помечается как основная: если API-ключ не привязан к конкретному кассиру, счета идут через основного. Месячный лимит счетов между кассирами не делится — он общий на организацию.
Что такое один кассир
В разделе Кассиры Kaspi каждый кассир показан отдельной карточкой. Одна карточка = один сотрудник в Kaspi Pay = один номер.
У кассира есть:
- Номер — номер сотрудника, добавленного в Kaspi Pay с ролью «Кассир»
- Состояние — активен или привязка оборвана
- Название (label) — вы задаёте сами, например «Первая точка» или «Онлайн»
Один номер нельзя использовать в двух привязках. Нужен второй кассир — нужен второй номер, и он тоже должен отвечать трём условиям: реальная SIM, на ИИН владельца не оформлены ИП или ТОО в Kaspi Pay, на номере только роль «Кассир».
Основной кассир
Одна из привязок является основной. Работает это так:
| Ситуация | Через какого кассира идёт счёт |
|---|---|
| API-ключ не привязан ни к одному кассиру | Через основного |
| Привязка основного кассира оборвана | Через другого активного кассира |
| API-ключ привязан к конкретному кассиру | Только через него, подмены не будет |
| Режим песочницы | Kaspi не участвует вообще, кассир не нужен |
Сменить основного: кабинет → Kaspi → на нужной карточке Сделать основным. Это действие доступно только владельцу организации (owner).
Смена основного кассира не затрагивает старые счета: ранее созданный счёт остаётся привязанным к тому кассиру, через которого был выставлен, и оплата отслеживается тоже через него.
Привязка API-ключа к конкретному кассиру
Любой API-ключ можно привязать к определённому кассиру. Привязанный ключ:
- Создаёт боевые счета только через этого кассира
- Видит только его счета — на чужой счёт ответит 404
- При обрыве привязки не переключается автоматически на другого кассира
Это самый чистый способ разделить точки. Подробно: Привязка API-ключа к кассиру и Раздельная отчётность по точкам.
Пока к кассиру привязан хотя бы один действующий ключ, удалить этого кассира нельзя — вернётся ошибка connection_has_keys. Сначала переведите ключи на другую привязку или удалите их.
Когда действительно нужен второй кассир
| Ситуация | Нужен второй кассир | Почему |
|---|---|---|
| Открылась вторая точка, нужен раздельный учёт | Да | Платежи каждой точки видны отдельно |
| В одной компании два разных проекта | Да | Счета не смешиваются, ключи разные |
| Большая нагрузка, хочется снизить риск простоя | Да | Если один оборвётся, второй продолжит работать |
| Нужно просто разделить отчётность | Нет | Хватит нескольких ключей у одного кассира и фильтра по источнику |
| Хочется, чтобы деньги шли на другой счёт | Нет, это не решит | Деньги приходят на счёт аккаунта Kaspi Pay; нужен другой счёт — нужна отдельная организация |
| Вы только тестируете в песочнице | Нет | В песочнице кассир Kaspi не нужен совсем |
Самое частое заблуждение — «не хватает лимита, добавлю ещё кассира». Лимит привязан к организации и тарифу, а не к кассиру. Новый кассир лимит не увеличивает.
Что общее, а что раздельное
| Что | Общее | Пояснение |
|---|---|---|
| Месячный лимит счетов | Общее | Тариф выдаётся организации, между кассирами не делится |
| Суточная защита от всплесков | Общее | Тоже на уровне организации |
| Адреса webhook | Общее | События всех кассиров приходят на один адрес |
| Кабинет и сотрудники | Общее | Роли выдаются в организации |
| Привязка Kaspi и устройство | Раздельное | У каждого номера своя сессия |
| Показ номера кассира покупателю | Раздельное | Покупатель видит, какой именно кассир выставил счёт |
| Обрыв привязки | Раздельное | Оборвался один — остальные работают |
В теле вебхука приходит информация о том, к какому кассиру относится счёт, поэтому один адрес спокойно обслуживает несколько точек — разделяете события уже у себя.
Как добавить
- В приложении Kaspi Pay (не в веб-кабинете) заводите нового сотрудника: Настройки → Сотрудники → Добавить сотрудника, роль «Кассир»
- В кабинете идёте в раздел Кассиры Kaspi и нажимаете Добавить кассира
- Вводите новый номер и подтверждаете код из SMS
Полные шаги: Как подключить кассира Kaspi.
После привязки не входите с этого номера в приложение Kaspi Pay — Kaspi тут же разорвёт нашу сессию.
Вопросы и ответы
Если кассиров несколько, лимит увеличивается? Нет. Месячное количество счетов и суточная защита зависят от тарифа организации, а не от числа кассиров.
Можно один номер подключить к двум организациям? Нет. Один номер — одна привязка. Для второй организации нужен отдельный номер.
Если оборвётся основной кассир, счета остановятся? Если ключ не привязан к конкретному кассиру — нет, счета пойдут через другого активного. Если ключ привязан — счета не будут создаваться, пока этот кассир не восстановится.
Можно сделать несколько API-ключей на одного кассира? Да, сколько угодно — например, один для сайта, второй для Telegram-бота.
Если удалить кассира, его счета пропадут? Нет, счета и отчётность остаются. Но кассира с привязанными ключами удалить нельзя — сначала переведите ключи.