Организация или кассир: что вам на самом деле нужно?
Самая частая путаница. Разложим по-простому:
- Организация в ApiPay = юрлицо (ИП или ТОО) со своим Kaspi Pay. Другое юрлицо — всегда другая организация.
- Кассир = подключение внутри организации, «руки» сервиса в одной точке продаж. У одной организации кассиров может быть несколько.
Правило выбора:
- Второй бизнес на другом ИП/ТОО (второй санаторий, магазин жены, новое ТОО) → добавляйте новую организацию. У неё будет свой кассир, свой тариф и свои 3 тестовых дня.
- Ещё одна точка того же юрлица (второй филиал, вторая касса) → добавляйте второго кассира в существующую организацию. Тариф остаётся один — он считается на организацию. При выставлении счёта через API можно указать, от какого кассира он уходит (параметр
kaspi_connection_id; без него счёт идёт через основного кассира). - Просто развести потоки заказов (сайт отдельно, Telegram-бот отдельно) → организация и кассир те же, а вот API-ключей сделайте два, каждый со своим вебхуком. Счета будут помечены источником, статистика разделится.
Из опыта поддержки: большинству хватает одного кассира и пары ключей — не усложняйте, пока не появится реальное второе юрлицо.
Как добавить вторую организацию (и не сломать первую)
В кабинете apipay.kz нажмите «Новая организация» и привяжите к ней кассира: Настройки → «Авторизация Kaspi» (кассир должен быть сотрудником именно этого юрлица в Kaspi Pay — требования к номеру те же, см. «Требования к номеру кассира»).
Типичная ошибка — вместо создания новой организации переавторизовать кассира в существующей: тогда вы не «добавите второй бизнес», а замените подключение первого. Если у вас уже так получилось — напишите в поддержку, вернём как было.
Ограничение ролей: добавлять организации и кассиров может только владелец аккаунта. Менеджеры (до 5 на организацию — бухгалтер, разработчик) видят счета и логи вебхуков, но кассирами не управляют.
Как считается тариф при нескольких организациях?
Прямо и без сюрпризов: каждая организация оплачивается отдельно. Подключили два ИП — два тарифа, например Старт (10 000 ₸/мес) для каждого. Дневные лимиты счетов тоже считаются на организацию и между организациями не «переливаются».
Почему так: тариф привязан к реальной инфраструктуре — отдельный Kaspi Pay, отдельный кассир, отдельная синхронизация оплат. Каждая организация потребляет ресурс сервиса независимо.
Что это значит на практике:
- Тарифы у организаций могут быть разными: боевому магазину — Business, новому проекту — Start.
- 3 тестовых дня даются каждой новой организации — вторую можно спокойно обкатать бесплатно.
- Скидки за срок (3/6/12 месяцев: −5/−10/−15%) применяются к каждому тарифу отдельно.
Полная сетка тарифов и модель «фикс, не процент» — в статье «Тарифы и комиссия ApiPay».
Я платформа: как подключать оплату Kaspi моим клиентам?
Если вы делаете CRM, конструктор ботов, маркетплейс услуг или SaaS для салонов — вашим клиентам-продавцам нужен приём Kaspi-платежей, но заводить каждого вручную в ApiPay неудобно. Для этого есть Partner API — серверное API для платформ:
- Вы подключаете своих мерчантов программно. Клиент вводит у вас номер своего кассира, Kaspi присылает ему SMS, он подтверждает код — и ваша платформа получает для него API-ключ и вебхук. Доступ всегда подтверждает сам мерчант через Kaspi-SMS: без его кода подключить его организацию нельзя.
- White-label: ваши клиенты могут вообще не знать про ApiPay — вы встраиваете приём Kaspi в свой продукт под своим брендом и сами назначаете розничную цену.
- Песочница партнёра — self-service: тестовые организации и моки доступны сразу после регистрации, боевой доступ открывается после одобрения и договора.
Биллинг партнёрской модели — договорной: базовый вариант — единый ежемесячный счёт за активных подключённых мерчантов (ориентир — 10 000 ₸/мес за мерчанта с лимитом до 30 счетов в день), без процента с оборота. Какая модель подойдёт вам — оплата тарифа каждой организации через Partner API или единый договорной счёт — обсуждается при подключении партнёрства. Розничную цену для своих клиентов вы устанавливаете сами.
Есть и простой вариант без интеграции — реферальная программа: рекомендуете ApiPay, получаете вознаграждение с платежей приведённых клиентов, пока они платят; условия обсуждаются индивидуально — напишите нам в WhatsApp.
Технические детали, эндпоинты и моки — на странице Partner API.
Частые ошибки
- Переавторизовать кассира вместо «Новая организация» — вторая организация так не появится, а первая отвяжется.
- Ждать «общий тариф» на все организации — тарифы считаются на организацию и не суммируются; это не скрытое условие, а базовая модель.
- Подключать один номер кассира к двум организациям — кассир принадлежит одному юрлицу в Kaspi Pay; для второй организации нужен свой номер.
- Давать менеджеру задачу «подключи кассира» — не сможет: операции с кассирами доступны только владельцу.
- Городить вторую организацию ради разделения сайта и бота — достаточно двух API-ключей с разными вебхуками внутри одной организации.
Вопросы и ответы
Сколько организаций можно добавить в один аккаунт?
Ограничения нет: добавляйте столько юрлиц, сколько ведёте. Переключение между ними — в кабинете.
Можно ли один номер кассира использовать для нескольких организаций?
Нет. Кассир — сотрудник конкретного юрлица в Kaspi Pay. Для каждой организации — свой номер кассира.
У меня одно ИП и три точки продаж — мне нужны три организации?
Нет, одна организация и до трёх кассиров (по точке на кассира). Тариф при этом один — на организацию.
Как разделить счета от сайта и от Telegram-бота?
Создайте два API-ключа в одной организации, каждому — свой вебхук. Счета будут атрибуцированы источнику.
Мои клиенты-продавцы должны сами регистрироваться в ApiPay?
Нет, если вы партнёр: через Partner API вы подключаете их из своего продукта — мерчант только подтверждает код из Kaspi-SMS. Управление ключами и вебхуками остаётся на вашей стороне.
Партнёр платит один счёт или за каждого мерчанта?
Модель договорная: ориентир — единый ежемесячный счёт за активных мерчантов (от 10 000 ₸/мес за мерчанта до 30 счетов/день), розницу для своих клиентов вы назначаете сами; детали модели — при подключении партнёрства.