Организация или кассир: что вам на самом деле нужно?
- Организация в ApiPay = юрлицо (ИП или ТОО) со своим Kaspi Pay. Другое юрлицо — всегда другая организация.
- Кассир = подключение внутри организации, «руки» сервиса в одной точке продаж. У одной организации кассиров может быть несколько.
Правило выбора:
- Второй бизнес на другом ИП/ТОО (второй санаторий, магазин жены, новое ТОО) → добавляйте новую организацию. У неё будет свой кассир, свой тариф и свои 3 тестовых дня.
- Ещё одна точка того же юрлица (второй филиал, вторая касса) → добавляйте второго кассира в существующую организацию. Тариф остаётся один — он считается на организацию. При выставлении счёта через API можно указать, от какого кассира он уходит (параметр
kaspi_connection_id; без него счёт идёт через основного кассира). - Просто развести потоки заказов (сайт отдельно, Telegram-бот отдельно) → организация и кассир те же, а вот API-ключей сделайте два, каждый со своим вебхуком. Счета будут помечены источником, статистика разделится.
Как добавить вторую организацию (и не сломать первую)
В кабинете apipay.kz нажмите «Новая организация» и привяжите к ней кассира: Настройки → «Авторизация Kaspi» (кассир должен быть сотрудником именно этого юрлица в Kaspi Pay — требования к номеру те же, см. «Требования к номеру кассира»).
Типичная ошибка — вместо создания новой организации переавторизовать кассира в существующей: тогда вы не «добавите второй бизнес», а замените подключение первого. Если у вас уже так получилось — напишите в поддержку, вернём как было.
Добавлять организации и кассиров может только владелец аккаунта: менеджеры (бухгалтер, разработчик) видят счета и логи вебхуков, но кассирами не управляют.
Как считается тариф при нескольких организациях?
Каждая организация оплачивается отдельно. Подключили два ИП — два тарифа. Дневные лимиты счетов тоже считаются на организацию и между организациями не «переливаются».
Тарифы у организаций могут быть разными: боевому магазину — Business, новому проекту — Start. Тестовый период даётся каждой новой организации отдельно, так что вторую можно обкатать бесплатно — см. «Пробный период».
Полная сетка тарифов, скидки за срок и модель «фикс, не процент» — в статье «Тарифы и комиссия ApiPay»; дневные лимиты — в «Лимит счетов по тарифу».
Я платформа: как подключать оплату Kaspi моим клиентам?
Платформам доступен Partner API — серверное S2S API, которым вы подключаете своих клиентов программно: клиент вводит у вас номер своего кассира, подтверждает код из Kaspi-SMS, и ваша платформа получает для него API-ключ и вебхук. Без кода мерчанта подключить его организацию нельзя. Работает это white-label: ваши клиенты могут вообще не знать про ApiPay, а розничную цену вы назначаете сами.
Биллинг партнёрской модели — договорной: базовый вариант — единый ежемесячный счёт за активных подключённых мерчантов, без процента с оборота. Технически партнёр может платить и тариф каждой организации отдельно. Какая модель подойдёт вам, обсуждается при подключении партнёрства.
Как это устроено технически — в статье «Partner API white-label», пошаговое подключение мерчанта — в «Как партнёру подключить организацию», эндпоинты и моки — на странице Partner API.
Вопросы и ответы
Можно ли один номер кассира использовать для нескольких организаций?
В пределах вашего аккаунта подключение проходит. Но кассир в Kaspi Pay — сотрудник конкретного юрлица, поэтому для каждой организации правильнее свой номер: иначе счета двух юрлиц уходят через одну Kaspi-кассу. Если номер уже используется как кассир вне вашего аккаунта, подключение не пройдёт: кабинет покажет «Кассир сейчас недоступен», повтор не помогает — возьмите другой номер кассира или напишите в поддержку.
Мои клиенты-продавцы должны сами регистрироваться в ApiPay?
Нет, если вы партнёр: через Partner API вы подключаете их из своего продукта — мерчант только подтверждает код из Kaspi-SMS. Управление ключами и вебхуками остаётся на вашей стороне.