> Источник: https://apipay.kz/guides/apipay-dlya-platform-i-saas · Обновлено: 2026-07-06 · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# Как SaaS-платформе принимать оплату Kaspi за своих клиентов?

**TL;DR.** Да, ApiPay подходит платформам, CRM и агрегаторам, у которых десятки под-бизнесов: садики, салоны, таксопарки, рестораны. Главный принцип: **каждый ваш клиент получает деньги напрямую на свой Kaspi-счёт** — вы не становитесь платёжным агрегатором и не трогаете чужие деньги. Ваш клиент подключает свою организацию к ApiPay (для этого от него нужен только код с номера кассира), вы храните его API-ключ у себя и выставляете счета от его имени. Для автоматизации массового подключения есть Partner API, для монетизации — партнёрская программа.

ApiPay — независимый сервис поверх Kaspi Pay ваших клиентов. Он работает через штатную роль «Кассир» в Kaspi Pay. Это не официальная интеграция Kaspi.

## Почему платформа не может «принимать за всех на себя»

Классическая боль SaaS в Казахстане: вы не платёжный агрегатор юридически — принимать деньги на себя и потом распределять их между клиентами вы не имеете права, а собственного платёжного шлюза у платформы обычно нет. ApiPay решает задачу: каждый под-бизнес получает деньги на свой счёт. Развилок ровно две. Если каждый под-бизнес должен получать деньги на свой счёт — у каждого должен быть свой ApiPay. Если же принимать всё в одном месте на счёт платформы и потом распределять — это и есть та самая боль подобных решений: без статуса агрегатора или договорённости с банком так делать нельзя.

ApiPay решает задачу первым способом: **все заведены, деньги у каждого свои, автоматизация — ваша**.

## Как это работает у вас

Схема на пальцах, в терминах вашей платформы:

**Клиент платформы (например, садик) регистрируется в ApiPay → даёт вам код с номера кассира → у вас в базе появляется его API-ключ → ваша платформа выставляет счета родителям от имени садика → родитель получает push в Kaspi → оплатил → ApiPay шлёт вебхук на ваш URL → вы отмечаете оплату в своей системе.**

Деньги при этом идут напрямую на Kaspi-счёт садика. Промежуточного счёта нет. ApiPay берёт фиксированную подписку с каждой организации, не процент с оборота.

### Три модели денег — выберите свою

| Модель | Кто получает деньги | Когда подходит |
|---|---|---|
| Каждый клиент на свой счёт | Под-бизнес | Основная модель: вы — софт, деньги не ваши |
| Всё от вашего счёта | Вы (платформа) | Услуга по сути ваша, клиенты — подрядчики |
| От бизнеса + постоплата вам | Под-бизнес, вы выставляете ему счёт за период | Агрегаторы: платежи от ресторана, в конце месяца — ваш счёт за сервис |

Ориентир при выборе: если деньги за услугу предназначены вам — выставляйте счёт от своего счёта, если под-бизнесу (например, ресторану) — от его имени. Можно принимать все платежи от имени под-бизнеса, а в конце периода выставить ему отдельный счёт за ваши услуги по постоплате.

## Компоненты ApiPay для платформы

Платформа получает полный [Kaspi API](/kaspi-api) и инструменты мультиаккаунта:

| Компонент | Зачем платформе |
|---|---|
| API-ключ на организацию (`X-API-Key`) | Вы храните ключи всех клиентов и подставляете нужный при выставлении счёта |
| Вебхуки per-key | Свой `webhook_url` на каждую организацию — статусы оплат прилетают в вашу систему |
| Partner API (`X-Partner-Key`) | Программное подключение клиентов: создание организаций, привязка кассира, выпуск ключей — без ручного онбординга |
| Мультиорганизации | Один клиент с несколькими юрлицами/точками = несколько организаций |
| Партнёрская программа | Вознаграждение за каждого приведённого клиента, пока тот платит; условия — индивидуально |
| Песочница | Отладка всей мульти-клиентской логики без реальных денег |

Важно про биллинг: **каждая организация = отдельный тариф, лимиты не суммируются** — ключевой момент для мультиорганизационных схем.

## Пошаговый сетап

1. **Зарегистрируйте свой аккаунт** на apipay.kz и изучите модель на одной организации (своей) в песочнице — см. [«Песочница и рабочий режим»](/guides/pesochnitsa-i-rabochiy-rezhim).
2. **Выберите модель денег** из трёх выше и зафиксируйте её в оферте с клиентами.
3. **Подключите первого клиента вручную**: он регистрируется в ApiPay, заводит номер кассира (требования — [в этой статье](/guides/trebovaniya-k-nomeru-kassira)) и передаёт вам API-ключ. Клиенту удобно дать готовый шаблон обращения в поддержку: короткое приветствие, упоминание, что он подключается из вашей платформы, и номер кассира.
4. **Постройте хранилище ключей**: таблица «организация клиента → API-ключ → webhook-секрет», ключ подставляется в каждый запрос выставления счёта.
5. **Настройте вебхуки** на каждую организацию — свой URL или один общий с маршрутизацией по подписи/ключу.
6. **Переходите на Partner API**, когда клиентов станет больше нескольких: заявка в партнёрском разделе сайта → `X-Partner-Key` → создание организаций и привязка кассира программно (`apipay.kz/partners/api`).
7. **Подключите партнёрскую программу**, чтобы возвращать себе часть тарифа клиентов — условия обсудим при подключении, напишите нам.

## Грабли именно платформ

- **«В обоих вариантах оплата будет от нас?»** — путаница, чей счёт. Нет: счёт всегда выставляется от той организации, чей 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 — его собственность: аккаунт, ключи и деньги остаются у него. Вы просто перестаёте выставлять счета от его имени.

**Ограничены ли мы одним юрлицом клиента?**
Нет: у клиента может быть несколько организаций, у каждой — свой тариф и свой кассир.

---

ApiPay — независимый сервис и не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.
База знаний: https://apipay.kz/guides