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

# Как разделить счета по точкам в одной организации?

**TL;DR.** Ставьте на каждый счёт метку точки — префикс в номере заказа `external_order_id` (например, `ABAY-1024`) или внутреннюю заметку `internal_comment` («Точка на Абая») — и отбирайте счета точки поиском: он работает в списке счетов кабинета, в сводке над ним, в выгрузке и в API (`GET /invoices?search=…`, итоги — `GET /invoices/stats`). Чтобы уведомления об оплате каждой точки шли в её систему, заведите на точку отдельный API-ключ со своим адресом вебхука. Разделение получается учётным, а не финансовым: деньги всех точек приходят на один Kaspi-счёт организации, тариф и лимиты общие; полностью разделить их можно только отдельными организациями.

## Коротко

| Вопрос | Ответ |
|---|---|
| Чем пометить точку | Префикс в `external_order_id` или заметка `internal_comment` |
| Как отобрать счета точки | Поиск по метке: список, сводка и выгрузка в кабинете, `search` в API |
| Как посчитать оборот точки | `GET /invoices/stats` с тем же `search` — поле `paid_amount` |
| Вебхуки по точкам | Свой API-ключ на точку — свой `webhook_url` и свой секрет |
| Полное разделение денег и тарифа | Отдельные организации |

## Как посмотреть обороты Kaspi Pay по каждой точке?

Общие обороты организации видны в самом приложении Kaspi Pay ([справка Kaspi](https://guide.kaspi.kz/)). Оборот отдельной точки ApiPay считает по счетам, на которых стоит её метка:

- **в кабинете** — введите метку точки в поиск над списком «Счета»: таблица, сводка над ней и кнопка «Экспорт» работают с тем, что сейчас в фильтрах, поэтому выгрузится файл только по этой точке;
- **через API** — тот же поиск передайте в сводку. Период задаётся парой `start_date`/`end_date` или параметром `period`:

```
GET /api/v1/invoices/stats?search=ABAY-&start_date=2026-09-01&end_date=2026-09-30&date_field=paid_at
```

Сумма оплаченного — поле `paid_amount`, число счетов — `total_invoices`. С `date_field=paid_at` счёт попадает в месяц, когда его оплатили, а не когда выставили. Счета с частичным возвратом в `paid_amount` не входят; если такие были, деньги сверяйте по статье «[Сверка кассы со счетами](/guides/sverka-kassy-so-schetami-apipay)». Счета точки поштучно отдаёт `GET /invoices?search=ABAY-` с теми же датами (`date_from`/`date_to`). Все параметры — в [документации API](/docs), обзор возможностей — на странице [Kaspi Pay API](/kaspi-api).

Если отчёт нужен каждое утро или его ждёт другая система (1С, таблица, бот), не выгружайте его руками: один запрос к `GET /invoices/stats` по каждой метке делает это по расписанию. Код такого запроса напишет ваш ИИ-агент — дайте ему [apipay.kz/for-ai](/for-ai).

## Как пометить счёт точкой?

| Способ | Где задаётся | Когда подходит |
|---|---|---|
| Префикс в `external_order_id` (`ABAY-1024`, `DOST-77`) | Поле `external_order_id` в `POST /invoices`, в кабинете — «ID заказа» | Счета выставляет ваша программа, у заказа уже есть номер |
| Заметка `internal_comment` («Точка на Абая») | Поле `internal_comment` в `POST /invoices`, в кабинете — «Заметка для себя» | Счета выставляют люди в кабинете, или метку нужно поправить позже |

Как выбрать метку, чтобы поиск не путал точки:

1. **Метка без цифр и не встречается в обычном тексте.** Поиск ищет подстроку в номере заказа, заметке, описании счёта и имени клиента, а цифры из запроса сверяет ещё и с телефоном покупателя и номером операции Kaspi. Поэтому по метке «Точка 2» найдутся и чужие счета, а по `ABAY-` — нет.
2. **Одна точка — одна метка**, и у всех сотрудников она пишется одинаково.
3. **Забытую метку можно дописать** в любом статусе счёта, даже у оплаченного: в кабинете — «Добавить заметку» у счёта, через API — `PATCH /invoices/{id}`. Заметка в Kaspi не уходит, покупатель её не видит.

## Как разослать уведомления об оплате по точкам?

Если у каждой точки своя система, лист или бот, заведите на точку отдельный API-ключ:

1. Откройте **«Настройки» → «Подключение»** (вкладка видна роли developer и выше) и нажмите **«Создать новый ключ»**.
2. На шаге «Название» задайте **имя ключа = имя точки** (до 50 символов): «Точка на Абая», «Instagram-бот».
3. На шаге «Уведомления» укажите **адрес вебхука этой точки**. Секрет подписи ApiPay создаст сам. **Ключ и секрет показываются один раз — сохраните их сразу**, потерянные придётся выпускать заново.
4. Выставляйте счета каждой точки **её ключом** (заголовок `X-API-Key`) и ставьте на них метку точки.

Что это даёт:

- события счетов, возвратов и подписок, созданных ключом точки, приходят на её адрес; в теле вебхука поле `source` — имя ключа-создателя, а `internal_comment` — заметка счёта, если она есть;
- ключ с настройкой «Получать все уведомления организации» дополнительно получает события **всех** точек и счетов из кабинета — удобно для общего учёта; поэтому одно событие может прийти на два адреса;
- события каталога (`catalog.*`) и фискальных чеков (`receipt.*`) по точкам не разделяются — они уходят на все адреса организации, не стройте на них правило «пришло сюда — значит, это эта точка»;
- в списке ключей у каждого ключа виден счётчик «Счетов создано».

Что такое ключ и секрет — в статье «[Чем API-ключ отличается от вебхук-секрета](/guides/api-klyuch-i-webhook-secret)». Как настроить и проверить сами вебхуки — «[Как настроить вебхуки ApiPay](/guides/nastroyka-webhookov-apipay)».

## Что остаётся общим на всю организацию?

1. **Деньги** — оплаты всех точек приходят на один Kaspi-счёт организации.
2. **Тариф и дневные лимиты счетов** — считаются на организацию, а не на точку.
3. **Продажи мимо ApiPay** — оплаты, проведённые прямо в приложении Kaspi Pay, подтягиваются в список из истории Kaspi без метки. Заметку с меткой точки им можно дописать, как любому счёту, а отделить их от своих счетов можно фильтром «Происхождение» в кабинете или параметром `origin` в API.

Если на каждой точке нужен свой кассир — второй кассир оплачивается отдельно: каждая касса подключается как отдельная организация со своим тарифом, подробнее — «[Можно ли подключить двух кассиров](/guides/dva-kassira-na-organizatsiyu)». Если нужно разделить **деньги, тариф и списки счетов** по-настоящему — это отдельные организации: у каждой свой тариф, свой Kaspi-вход, свой список «Счета» и свои деньги. Подробнее — «[Несколько организаций и партнёрам](/guides/multiorganizatsii-i-partnyoram)».

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

**Как посмотреть оборот одной точки за месяц?**
Введите метку точки в поиск над списком «Счета» и выберите период — сводка над таблицей посчитает сумму только по этой точке. Через API — `GET /invoices/stats` с параметром `search`, датами и `date_field=paid_at`, сумма оплаченного в поле `paid_amount`; счета с частичным возвратом туда не входят.

**Можно ли выгрузить в Excel счета одной точки?**
Да. Отберите счета поиском по метке точки и нажмите «Экспорт» — выгружается то, что сейчас в фильтрах.

**Нужен ли отдельный API-ключ на каждую точку?**
Для отчёта — нет, достаточно метки на счетах. Отдельный ключ нужен, если уведомления об оплате каждой точки должны уходить на свой адрес.

**Можно ли разделить деньги по точкам?**
Внутри одной организации — нет: оплаты всех точек приходят на один Kaspi-счёт. Для раздельных денег и тарифов нужны отдельные организации.

---

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