Можно ли подключить двух кассиров к одной организации?

Кассир — это не тот, кто выставляет счета

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

Зачем вам второй кассир — и что на самом деле нужно

Прежде чем подключать, найдите свой сценарий в таблице:

Второй кассир не добавляет оплаты. Тариф считается за организацию, и все её кассиры расходуют общий суточный лимит счетов. Поэтому вопрос при второй точке — не цена подключения, а хватает ли лимита на суммарный поток: если не хватает, берут тариф выше, а не ещё одну кассу (цифры — «Тарифы и комиссия», как считается лимит — «Лимит счетов по тарифу»).

Отдельная оплата появляется только тогда, когда «вторая точка» — это другой бизнес со своим БИН/ИИН и своим Kaspi Pay: в ApiPay это отдельная организация, у неё свой тариф, и тарифы не суммируются (подробнее — «Несколько организаций и партнёрам»).

Почему два кассира — это обязательно два разных номера

Один номер кассира работает только на одной точке: использовать его на двух точках одновременно нельзя, поэтому «два кассира» технически означает два разных номера, у каждого — свой отдельный вход в Kaspi.

К каждому из этих номеров применяются те же требования, что и к первому кассиру — «Какой номер подходит для кассира».

Как счета «понимают», через какого кассира уходить (трек D)

Когда у организации больше одного активного подключения, системе нужно знать, через какого кассира отправлять конкретный счёт. Здесь два варианта:

1. Назначить основного (primary) кассира — тогда счета без явного указания уходят через него.
2. Передавать kaspi_connection_id в каждом запросе на создание счёта — явно указывать точку/кассира.

Если у организации ≥2 активных подключений, не назначен основной кассир и не передан kaspi_connection_id, создание счёта вернёт ошибку 422 connection_ambiguous — «непонятно, через какого кассира выставлять». Решение: либо назначьте primary, либо всегда передавайте kaspi_connection_id. Одна активная касса без пометки «основная» ошибки не даёт — адресат однозначен. Порядок выбора одинаков для счетов по номеру, QR-счетов, фискальных чеков, печатных QR-листов и возвратов по QR.

Что две кассы действительно разводят — живые QR-счета: ограничение «один активный QR-счёт» считается по кассе, поэтому две кассы дают две параллельные QR-сессии. Суточный лимит счетов по тарифу это не удваивает — он общий на организацию.

Как подключить второго кассира

В кабинете («Настройки» → «Авторизация Kaspi») кнопка «Сменить кассира» — это замена, а не добавление: старая связка разрывается, и платежи на неё перестают поступать (подробно — «Кассир уволился или сменился номер»). Уже подключённых кассиров кабинет показывает списком в селекторе организации в шапке — он появляется, когда касс больше одной: кассу можно переименовать и назначить основной. Удалить кассу — через API или поддержку.

Подключение второго кассира без отключения первого делается через API. Ключу нужно право can_manage_cashiers, дальше четыре вызова:

1. POST /api/v1/connections — создать кассу (можно передать label).
2. POST /api/v1/connections/{id}/auth/init — начать авторизацию.
3. POST /api/v1/connections/{id}/auth/send-phone — номер нового кассира, придёт SMS.
4. POST /api/v1/connections/{id}/auth/verify-otp — код из SMS.

Список касс — GET /api/v1/connections, основная касса — POST /api/v1/connections/{id}/primary, удаление — DELETE /api/v1/connections/{id} (последнюю и основную кассу удалить нельзя, придёт 422 cannot_delete_last_connection или cannot_delete_primary). При нескольких активных кассах передавайте kaspi_connection_id при создании счёта или назначьте основную — иначе вернётся 422 connection_ambiguous. Без API — напишите в поддержку, подключим второго кассира со своей стороны.

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