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

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

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

## Что такое ApiPay для платформы?

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

## Как это работает у платформы?

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

### Куда идут деньги покупателей?

Только на Kaspi-счёт организации, от имени которой выставлен счёт, — то есть на счёт садика. Схема «собрать всё на счёт платформы и потом распределить» в ApiPay не поддерживается, другой модели денег нет. ApiPay берёт фиксированную подписку с каждой организации, не процент с оборота.

## Что ApiPay даёт платформе?

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

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

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

## Как подключить платформу по шагам?

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

## Где платформы ошибаются чаще всего?

- **От чьего имени уходит счёт.** От той организации, чей API-ключ подставлен в запрос. В уведомлении покупатель видит **номер кассира** этой организации; что Kaspi показывает рядом — не в нашем контроле.
- **Клиент сам пользуется номером кассира.** Если сотрудник клиента заходит в приложение Kaspi Pay под номером кассира — привязку приходится подключать заново, счета встают ([Почему слетела сессия кассира](/guides/pochemu-sletala-sessiya-kassira)). Правило для всех клиентов платформы: номер кассира — отдельная SIM, в неё никто не заходит.
- **Что действительно owner-only.** Удаление организации, управление менеджерами и регенерация API-ключей. Отдельный гард на кассиров — per-key флаг `can_manage_cashiers`, по умолчанию **выключен**: без него `/api/v1/connections*` отдаёт `403 cashier_management_disabled`.
- **Номер кассира — только для ApiPay.** Kaspi держит одну сессию на номер: любой другой вход под этим номером в Kaspi Pay обрывает сессию ApiPay, и счета перестают выставляться. Если кабинет пишет «Кассир сейчас недоступен», этот номер подключить нельзя, повтор не поможет. Каждой организации клиента давайте свой номер; требования — в «[Требованиях к номеру кассира](/guides/trebovaniya-k-nomeru-kassira)».
- **Несколько точек = несколько кассиров.** 1 номер кассира может быть только в 1 точке продаж: у клиента 5 филиалов — 5 номеров. Второй и следующие кассиры оплачиваются отдельно: каждая касса подключается и оплачивается как отдельная организация — по тарифной сетке или на условиях вашего партнёрского договора. Суточный лимит у каждой свой, лимиты не складываются. Подробнее — «[Два кассира на организацию](/guides/dva-kassira-na-organizatsiyu)».
- **Подключение кассира может не пройти, и причину вам не покажут.** И партнёрская, и мерчантская ветка на конфликте отвечают нейтральным отказом: различить причину программно нельзя, повтор не помогает — ведите клиента на другой номер или в поддержку. Есть и суточный лимит на **новые** номера кассиров, так что массовый онбординг растягивайте по дням. Разбор — [Подключение организации партнёром](/guides/partner-connect-organization).
- **Развилка «один счёт или раздельные»**: если клиенту нужны деньги на каждое юрлицо отдельно — это 2 кассира и 2 тарифа; если на один счёт, но с разделением потоков — 2 API-ключа и 2 вебхука внутри 1 организации.
- **Партнёрский нюанс ключей**: повторный выпуск ключа саб-мерчанта через Partner API перегенерирует ключ — старый мгновенно перестаёт работать. Обновляйте ключ в своей базе атомарно.

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

**Проходят ли деньги через платформу?**
Нет. Деньги идут с Kaspi покупателя на Kaspi-счёт вашего клиента напрямую — платформа только выставляет счета по его API-ключу.

**Можно ли использовать номер кассира ApiPay в других сервисах или у других партнёров?**
Нет. Kaspi держит одну сессию на номер кассира, и любой другой вход под этим номером в Kaspi Pay обрывает сессию ApiPay — подробнее в статье [Почему слетела сессия кассира](/guides/pochemu-sletala-sessiya-kassira). Держите для ApiPay отдельный номер.

**Сколько это стоит клиентам платформы?**
Каждая организация платит свой фиксированный тариф ApiPay, без процента с оборота — суммы и лесенка в статье [Тарифы и комиссия](/guides/tarify-i-komissiya-apipay). Платить может и сама платформа: по `X-Partner-Key` доступны состояние подписки клиента, её оплата и выставление счёта на оплату.

**Что если клиент уйдёт с платформы?**
Деньги всегда остаются у клиента: они приходят на его Kaspi-счёт, а не проходят через вас. Если клиент заводил аккаунт ApiPay сам, аккаунт и ключи остаются у него, и вы просто перестаёте выставлять счета от его имени. Если организацию создали вы через Partner API, её передачу обсуждайте с нами.

---

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