Почему платформа не может «принимать за всех на себя»
Классическая боль SaaS в Казахстане: вы не платёжный агрегатор юридически — принимать деньги на себя и потом распределять их между клиентами вы не имеете права, а собственного платёжного шлюза у платформы обычно нет. ApiPay решает задачу: каждый под-бизнес получает деньги на свой счёт. Развилок ровно две. Если каждый под-бизнес должен получать деньги на свой счёт — у каждого должен быть свой ApiPay. Если же принимать всё в одном месте на счёт платформы и потом распределять — это и есть та самая боль подобных решений: без статуса агрегатора или договорённости с банком так делать нельзя.
ApiPay решает задачу первым способом: все заведены, деньги у каждого свои, автоматизация — ваша.
Как это работает у вас
Схема на пальцах, в терминах вашей платформы:
Клиент платформы (например, садик) регистрируется в ApiPay → даёт вам код с номера кассира → у вас в базе появляется его API-ключ → ваша платформа выставляет счета родителям от имени садика → родитель получает push в Kaspi → оплатил → ApiPay шлёт вебхук на ваш URL → вы отмечаете оплату в своей системе.
Деньги при этом идут напрямую на Kaspi-счёт садика. Промежуточного счёта нет. ApiPay берёт фиксированную подписку с каждой организации, не процент с оборота.
Три модели денег — выберите свою
| Модель | Кто получает деньги | Когда подходит |
|---|---|---|
| Каждый клиент на свой счёт | Под-бизнес | Основная модель: вы — софт, деньги не ваши |
| Всё от вашего счёта | Вы (платформа) | Услуга по сути ваша, клиенты — подрядчики |
| От бизнеса + постоплата вам | Под-бизнес, вы выставляете ему счёт за период | Агрегаторы: платежи от ресторана, в конце месяца — ваш счёт за сервис |
Ориентир при выборе: если деньги за услугу предназначены вам — выставляйте счёт от своего счёта, если под-бизнесу (например, ресторану) — от его имени. Можно принимать все платежи от имени под-бизнеса, а в конце периода выставить ему отдельный счёт за ваши услуги по постоплате.
Компоненты ApiPay для платформы
Платформа получает полный Kaspi API и инструменты мультиаккаунта:
| Компонент | Зачем платформе |
|---|---|
API-ключ на организацию (X-API-Key) |
Вы храните ключи всех клиентов и подставляете нужный при выставлении счёта |
| Вебхуки per-key | Свой webhook_url на каждую организацию — статусы оплат прилетают в вашу систему |
Partner API (X-Partner-Key) |
Программное подключение клиентов: создание организаций, привязка кассира, выпуск ключей — без ручного онбординга |
| Мультиорганизации | Один клиент с несколькими юрлицами/точками = несколько организаций |
| Партнёрская программа | Вознаграждение за каждого приведённого клиента, пока тот платит; условия — индивидуально |
| Песочница | Отладка всей мульти-клиентской логики без реальных денег |
Важно про биллинг: каждая организация = отдельный тариф, лимиты не суммируются — ключевой момент для мультиорганизационных схем.
Пошаговый сетап
- Зарегистрируйте свой аккаунт на apipay.kz и изучите модель на одной организации (своей) в песочнице — см. «Песочница и рабочий режим».
- Выберите модель денег из трёх выше и зафиксируйте её в оферте с клиентами.
- Подключите первого клиента вручную: он регистрируется в ApiPay, заводит номер кассира (требования — в этой статье) и передаёт вам API-ключ. Клиенту удобно дать готовый шаблон обращения в поддержку: короткое приветствие, упоминание, что он подключается из вашей платформы, и номер кассира.
- Постройте хранилище ключей: таблица «организация клиента → API-ключ → webhook-секрет», ключ подставляется в каждый запрос выставления счёта.
- Настройте вебхуки на каждую организацию — свой URL или один общий с маршрутизацией по подписи/ключу.
- Переходите на Partner API, когда клиентов станет больше нескольких: заявка в партнёрском разделе сайта →
X-Partner-Key→ создание организаций и привязка кассира программно (apipay.kz/partners/api). - Подключите партнёрскую программу, чтобы возвращать себе часть тарифа клиентов — условия обсудим при подключении, напишите нам.
Грабли именно платформ
- «В обоих вариантах оплата будет от нас?» — путаница, чей счёт. Нет: счёт всегда выставляется от той организации, чей API-ключ вы подставили. Название в push у покупателя — название точки этой организации.
- Клиент сам пользуется номером кассира. Если сотрудник клиента заходит в приложение Kaspi Pay под номером кассира — привязку приходится подключать заново, счета встают. Правило для всех клиентов платформы: номер кассира — отдельная SIM, в неё никто не заходит.
- Только владелец аккаунта добавляет организации. Роли «менеджер» и «разработчик» не могут привязывать новые организации — планируйте онбординг через владельца.
- Несколько точек = несколько кассиров. 1 номер кассира может быть только в 1 точке продаж. У клиента 5 филиалов — нужно 5 номеров.
- Развилка «один счёт или раздельные»: если клиенту нужны деньги на каждое юрлицо отдельно — это 2 кассира и 2 тарифа; если на один счёт, но с разделением потоков — 2 API-ключа и 2 вебхука внутри 1 организации.
- Партнёрский нюанс ключей: повторный выпуск ключа саб-мерчанта через Partner API перегенерирует ключ — старый мгновенно перестаёт работать. Обновляйте ключ в своей базе атомарно.
Мини-кейс: платформа для детских садов
Рассмотрим типовую вертикаль — платформа, через которую родители ежемесячно оплачивают детский сад. Владелец такой платформы обычно упирается в один и тот же вопрос: принимать деньги на себя он не может, потому что это уже работа платёжного агрегатора.
Схема на ApiPay снимает эту проблему. Каждый детский сад заводится в ApiPay как отдельная организация, и деньги родителей идут напрямую на его счёт — платформа денежный поток не трогает. От самого сада для подключения нужен только код с номера кассира. API-ключи всех садов хранятся на стороне платформы: она подставляет нужный ключ и выставляет счёт от имени конкретного сада. По тарифам всё так же раздельно: у каждого сада — свой тариф ApiPay, а платформа получает партнёрское вознаграждение, пока подключённые организации остаются активными.
Частые вопросы
Мы становимся платёжным агрегатором, если подключим клиентов через ApiPay?
Нет. Деньги идут напрямую с Kaspi покупателя на Kaspi-счёт вашего клиента. Вы не касаетесь денежного потока — только автоматизируете выставление счетов. Юридическую оценку своей схемы закажите своему юристу.
Сколько это стоит клиентам платформы?
Каждая организация платит свой фиксированный тариф ApiPay (без процента с оборота). Актуальные цены: Старт 10 000 ₸/мес (до 30 счетов/день), Бизнес 25 000 ₸ (до 100), Про 60 000 ₸ (100–300); больше 300 — договорная.
Можно подключать клиентов программно, без ручной переписки?
Да, через Partner API: создание организаций, ввод номера кассира и кода, выпуск API-ключей — по X-Partner-Key. Есть песочница.
Что если клиент уйдёт с платформы?
Его организация в ApiPay — его собственность: аккаунт, ключи и деньги остаются у него. Вы просто перестаёте выставлять счета от его имени.
Ограничены ли мы одним юрлицом клиента?
Нет: у клиента может быть несколько организаций, у каждой — свой тариф и свой кассир.