Кассир — это не тот, кто выставляет счета
Главная путаница, из-за которой вообще возникает вопрос про «двух кассиров». В ApiPay счёт создаёт кабинет, API или менеджер — человек за компьютером или ваш код. А «кассир» (в терминах системы — Kaspi-подключение) — это лишь держатель Kaspi-сессии, канал, через который готовый счёт уходит в Kaspi. Кассир сам ничего не «выставляет» — он просто должен быть подключён, чтобы платёж дошёл до Kaspi.
Отсюда следствие: если вы хотите, чтобы два человека выставляли счета — им обоим не нужен отдельный Kaspi-кассир. Им нужен доступ в один и тот же кабинет. А второй кассир нужен только тогда, когда у вас физически две независимые Kaspi-точки с разными номерами.
Зачем вам второй кассир — и что на самом деле нужно
Прежде чем подключать, найдите свой сценарий в таблице:
| Что вы хотите | Правильное решение |
|---|---|
| Два сотрудника создают и ведут счета в кабинете | Менеджерский доступ — до 5 человек на организацию, приглашение по SMS, приглашает только владелец. Отдельный Kaspi-кассир не нужен |
| Две физические точки / два независимых Kaspi-кассира | Два кассира (два подключения) = два разных номера, каждый со своим входом в Kaspi |
| Раздельные бренды, раздельная отчётность и раздельные деньги | Отдельные организации — у каждой свой тариф, свой Kaspi-вход, свой список счетов и свои деньги |
| Автоматизация: «кассир» — это интеграция, а не человек | Один кассир + выставление счетов через API/бот/сайт — код шлёт счета, кассир держит сессию |
Половина обращений «дайте второго кассира» закрывается первой строкой: людям нужен не второй кассир, а второй человек в кабинете. А запрос «хочу всё раздельно — деньги, отчёты, тариф» — это третья строка, отдельные организации (подробнее — в статье «Несколько организаций и партнёрам»).
Почему два кассира — это обязательно два разных номера
Правило простое: один номер кассира работает только на одной точке. Поэтому:
- один и тот же номер нельзя использовать на двух точках одновременно — для каждой точки нужен свой номер;
- «два кассира» технически означает два разных номера кассира, у каждого — свой отдельный вход в Kaspi.
К каждому из этих номеров применяются те же три требования, что и к первому кассиру: реальная SIM, на ИИН владельца нет ИП/ТОО в Kaspi Pay, только роль «Кассир». Подробно — в статье «Какой номер подходит для кассира».
Как счета «понимают», через какого кассира уходить (трек D)
Когда у организации больше одного активного подключения, системе нужно знать, через какого кассира отправлять конкретный счёт. Здесь два варианта:
- Назначить основного (primary) кассира — тогда счета без явного указания уходят через него.
- Передавать
kaspi_connection_idв каждом запросе на создание счёта — явно указывать точку/кассира.
Если у организации ≥2 активных подключений, не назначен основной кассир и не передан kaspi_connection_id, создание счёта вернёт ошибку 422 connection_ambiguous — «непонятно, через какого кассира выставлять». Это защита от случайной отправки не через ту точку. Решение: либо назначьте primary, либо всегда передавайте kaspi_connection_id.
Как подключить второго кассира в кабинете сегодня
Честно о текущем состоянии интерфейса. На вкладке «Настройки» → «Авторизация Kaspi» сейчас доступны две кнопки для уже подключённой организации:
- «Сменить кассира» — это замена, а не добавление. При старте система показывает модал: «Текущая Kaspi-связка кассира будет разорвана, и платежи на него перестанут поступать. Продолжить?» То есть старый кассир после этого отключается.
- «Отключить» — полностью снять привязку кассира.
Подключение второго кассира без отключения первого через интерфейс кабинета пока недоступно — движок это поддерживает, а экрана для этого в кабинете ещё нет. Через API это уже работает: эндпоинты /connections (создание и управление кассами) доступны API-ключам с правом can_manage_cashiers; при нескольких активных кассах указывайте kaspi_connection_id при создании счёта или назначьте основную кассу — иначе вернётся 422 connection_ambiguous. Без API — напишите в поддержку WhatsApp: подключим второго кассира вручную. Сроки появления кнопки в интерфейсе мы не называем: как только она будет — обновим эту статью.
Если вам нужен второй кассир прямо сейчас — напишите в поддержку, подскажем актуальный путь.
Частые ошибки
- Заводить второго кассира, когда нужен второй человек в кабинете. Если оба сотрудника просто создают счета — им нужен менеджерский доступ (до 5 человек), а не второй Kaspi-кассир.
- Пытаться использовать один номер на двух точках. Один номер кассира работает только на одной точке. Две точки = два разных номера.
- Нажать «Сменить кассира», думая, что добавляешь второго. Это замена: старая связка разрывается, платежи на неё перестают приходить.
- С двумя кассирами не назначить основного и не передавать
kaspi_connection_id. Получите422 connection_ambiguousпри создании счёта. - Ждать, что два кассира разделят деньги и отчётность. Деньги и список счетов остаются общими на организацию. Настоящее разделение — это отдельные организации.
Частые вопросы
Сколько кассиров можно подключить к одной организации?
Несколько — модель «организация ↔ кассир» устроена как 1:N. Ограничение только одно: каждый кассир — это отдельный номер телефона, а один номер работает только на одной точке.
Второй кассир отключит первого?
Нет. Добавление второго кассира не трогает первого — они сосуществуют. Отключается старый кассир только при осознанном действии «Сменить кассира» (замена).
Мне нужно, чтобы двое сотрудников выставляли счета. Заводить второго кассира?
Скорее всего нет. Счета создаёт кабинет, а не кассир. Дайте второму сотруднику менеджерский доступ (до 5 человек на организацию, приглашение по SMS, приглашает владелец) — оба будут работать в одном кабинете.
У меня две точки с разными Kaspi. Что делать?
Это как раз случай двух кассиров: два разных номера, каждый со своим входом в Kaspi. Дальше назначьте основного кассира или указывайте kaspi_connection_id в каждом счёте.
А если нужны раздельные деньги и раздельная отчётность по точкам?
Тогда два кассира не помогут — деньги и список счетов у них общие на организацию. Настоящее разделение — это отдельные организации, у каждой свой тариф и свой Kaspi-счёт.
Можно ли подключить второго кассира прямо из кабинета?
Пока нет: в интерфейсе есть только «Сменить кассира» (замена). Через API — уже да: эндпоинты /connections с правом can_manage_cashiers. Без API — напишите в поддержку, подключим вручную.