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

# Что где находится в кабинете ApiPay?

**TL;DR.** Кабинет apipay.kz — это 8 рабочих зон: **Главная** (сводка и карточка подключения), **Счета** (вся выручка: поиск, фильтры, экспорт в Excel/CSV/PDF, создание счёта по телефону или QR), **Автоплатежи** (подписки), **Возвраты**, **Настройки** (кассир, API-ключи, лог уведомлений — 7 вкладок), **Мой тариф**, **Партнёрам** и переключатель организаций в шапке. На каждой странице есть встроенная экскурсия: кнопка **«Помощь» → «Гид по странице»**. Часть вкладок видна не всем — «Подключение» и «Лог уведомлений» доступны с роли developer и выше, поэтому если у коллеги «нет такой вкладки» — дело в роли, а не в поломке.

## Коротко

| Зона | Что там делают | Неочевидная фишка |
|---|---|---|
| Главная | Сводка + карточка подключения | «Ваш ID: …» — назовите его поддержке |
| Счета | Вся выручка, поиск, экспорт | Фильтры зеркалятся в URL — ссылку можно сохранить |
| Создать счет | Счёт по телефону или QR на кассе | Онлайн-проверка «Клиент найден» до отправки |
| Автоплатежи | Подписки (авто-выставление счетов) | Подписка ≠ автосписание с карты |
| Возвраты | Возвраты по оплаченным счетам | Возвраты кассира из Kaspi тоже подтягиваются |
| Настройки | Кассир, ключи, лог уведомлений | «Повторить» — ре-отправка вебхука из лога |
| Мой тариф | Оплата и автопродление | Остаток триала не сгорает при оплате |
| Шапка | Организации, язык, «Помощь» | Тариф каждой организации виден прямо в списке |

## Главная: с чего начинается день

Дашборд показывает состояние дел и — пока подключение не завершено — карточку «Подключение организации» с тремя шагами и кнопками «Подключить самостоятельно» / «Написать в поддержку». Здесь же строка **«Ваш ID: … — укажите его при обращении в поддержку»**: с ID разговор с поддержкой начинается сразу с дела. Фишка: если счетов ещё нет, пустой экран сам ведёт к делу — «Создайте первый счет».

## «Счета»: главный рабочий экран

Таблица всех счетов: **«№ / Клиент»** (плюс бейджи «Тест» у sandbox-счетов и «Авто» у счетов подписок), «Описание», «Сумма» (с оранжевым тегом возврата «-N ₸»), «Статус» (вместе со способом оплаты: Kaspi Gold, Kaspi Red, рассрочка и т.д.), «Дата», «Источник» (имя API-ключа) и «Действия». Статусы обновляются сами — страница опрашивает сервер каждые 5 секунд, пока есть «живые» счета; F5 не нужен.

Что здесь делают: ищут счёт (поиск «по номеру или описанию»), фильтруют по статусу и датам, выгружают отчёт кнопкой **«Экспорт»** (Excel/CSV/PDF, с опцией «Включить товары»), делают «Возврат» и «Отменить счет» прямо из строки, а в песочнице — «Симулировать» оплату.

**Неочевидная фишка**: все фильтры, сортировка и страница зеркалятся в адресную строку — отфильтрованный список можно сохранить в закладки или отправить коллеге ссылкой. Вторая: кнопка **«Колонки»** настраивает состав и порядок колонок (например, включить «Источник», который по умолчанию виден только на широких экранах). Разрез выручки по точкам и ключам — отдельная тема: [Раздельная отчётность по точкам](/guides/razdelnaya-otchetnost-po-tochkam).

## «Создать счет»: счёт по телефону или QR на кассе

Переключатель **«Счёт по телефону» / «QR-код на кассе»**. По телефону: номер клиента (формат 87XXXXXXXXX), сумма, описание, срок действия (по умолчанию 24 часа). QR — для кассы: «Телефон клиента не нужен», покажите QR — клиент отсканирует приложением Kaspi; QR действует несколько минут, описание — до 100 символов.

**Фишка**: при вводе телефона кабинет сразу проверяет клиента — «Клиент найден» / «Номер не найден в Kaspi». Это спасает от главной причины неоплат ещё до выставления счёта. Подробно про счета и статусы: [Как создать счёт Kaspi по номеру](/guides/kak-sozdat-schet-kaspi-po-nomeru).

## «Автоплатежи»: подписки

Регулярные счета: система сама выставляет клиенту счёт по расписанию. Важно понимать: подписка в ApiPay — это **авто-выставление счёта, а не автосписание с карты** — клиент каждый раз подтверждает оплату в своём Kaspi. Здесь управляют паузами, возобновлением и отменой. Подробно: [Подписки ApiPay](/guides/podpiski-apipay).

## «Возвраты»: журнал возвратов

Все возвраты по оплаченным счетам: полные и частичные, со статусами. **Фишка**: возвраты, которые кассир сделал руками в приложении Kaspi, тоже подтягиваются в этот журнал автоматически. Правила и ограничения (окно ~14 дней, 3 попытки): [Возвраты Kaspi через API](/guides/vozvraty-kaspi-cherez-api).

## «Настройки»: сердце интеграции

Самый насыщенный раздел — до 7 вкладок (на мобильном вместо вкладок — выпадающий список «Выберите раздел»):

- **«Профиль»** — ваши данные.
- **«Об организации»** — видна только владельцу и не в песочнице.
- **«Подключение»** (developer+) — API-ключи и уведомления: «Создать новый ключ», карточки ключей с хвостом `****hint`, «Проверить уведомления», меню «Ещё» с «Создать секретный ключ подписи». Здесь же карточка «Подключаете с помощью ИИ-помощника?» с кнопкой «Копировать инструкцию для ИИ». Подробно: [API-ключ и webhook secret](/guides/api-klyuch-i-webhook-secret).
- **«Менеджеры»** (developer+) — коллеги в кабинете, до 5 менеджеров.
- **«Лог уведомлений»** (developer+) — история вебхуков за 14 дней: HTTP-код с человеческой расшифровкой («404 — Адрес не найден»), время ответа и — главная фишка — кнопка **«Повторить»**, которая ре-отправляет вебхук вручную. Разбор недоставок: [Настройка вебхуков](/guides/nastroyka-webhookov-apipay).
- **«Авторизация Kaspi»** — статус кассира («Активна» / «Истекла»…), кнопки «Подключить» / «Сменить кассира» / «Отключить». Видна под аккаунтом владельца.
- Над вкладками — баннер режима **«ТЕСТОВЫЙ РЕЖИМ» / «РАБОЧИЙ РЕЖИМ»** с кнопкой переключения. Фишка-предохранитель: режим можно менять не чаще раза в 5 минут — таймер на кнопке это норма, а не глюк.

Важно: про роли ещё раз: инструкция «зайдите в Настройки → Подключение» молча не сработает у менеджера — вкладки «Подключение», «Менеджеры» и «Лог уведомлений» открываются с роли developer и выше, «Об организации» — только у владельца.

## «Мой тариф»: оплата доступа

Визард из трёх шагов «Тариф → Период → Оплата»: выбираете тариф (лимит — счетов в день; «При превышении блокировки не будет — наш менеджер напишет и предупредит»), период со скидкой, вводите номер телефона — и оплачиваете счёт в своём Kaspi. Плашка **«Пробный период: осталось N дн.»** живёт здесь же. **Фишка**: остаток триала не сгорает — «После оплаты оставшиеся дни добавятся к новой подписке». Есть автопродление: счёт выставляется автоматически за 3 дня до истечения. Цены и логика описаны в отдельной статье о тарифах и комиссии ApiPay.

## Шапка: организации и «Помощь»

Кнопка с именем организации открывает переключатель: у каждой организации в списке видны роль, метка «Тест» и статус оплаты «Оплачена» / «Пробный» / «Не оплачена» — **тариф у каждой организации свой**, и это видно не заходя внутрь. Внизу списка — «Новая организация». Несколько бизнесов — тема отдельной статьи о мультиорганизациях.

И главная кнопка для новичка: **«Помощь» → «Гид по странице»** — встроенная экскурсия подсветит элементы прямо на текущем экране (есть на Главной, в Счетах, Настройках и создании счёта). «Помощь» → «Написать в поддержку» — живой человек в WhatsApp.

## Частые ошибки

- **«У меня нет вкладки Подключение»** — это роль, а не баг: вкладка видна с developer и выше. Попросите владельца повысить роль или сделать нужное действие.
- **Искать кнопку «обновить» в Счетах** — статусы обновляются сами каждые 5 секунд.
- **Пугаться таймера на переключении режима** — смена режима доступна раз в 5 минут, это предохранитель.
- **Путать «Автоплатежи» с автосписанием** — подписка выставляет счёт, оплату клиент подтверждает сам.
- **Не заметить «Гид по странице»** — половина вопросов новичков снимается встроенной экскурсией.
- **Создавать новую организацию, когда слетела сессия кассира** — нужна не «Новая организация», а «Настройки» → «Авторизация Kaspi» → восстановить подключение.

## Вопросы и ответы

**С чего начать знакомство с кабинетом?**
Нажмите «Помощь» → «Гид по странице» на Главной — 6 шагов экскурсии, затем то же в «Счетах». Дальше кабинет объясняет себя сам.

**Почему я не вижу вкладку «Лог уведомлений»?**
Она открывается с роли developer и выше. То же с «Подключением» и «Менеджерами»; «Об организации» видит только владелец.

**Где взять API-ключ?**
«Настройки» → вкладка «Подключение» → «Создать новый ключ». Ключ и секрет показываются один раз — сохраните сразу.

**Как выгрузить счета в Excel?**
«Счета» → кнопка «Экспорт» → формат Excel (XLSX), CSV или PDF; можно включить товары. Экспорт уважает поиск, статусы и даты.

**Где посмотреть, дошёл ли вебхук до моего сайта?**
«Настройки» → «Лог уведомлений»: история за 14 дней, HTTP-коды с расшифровкой и кнопка «Повторить» для ручной ре-отправки.

**Можно ли вести несколько бизнесов в одном кабинете?**
Да — переключатель организаций в шапке; у каждой организации свой тариф и свои ключи. Подробно — в статье о мультиорганизациях.

---

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