Главная
Дашборд показывает состояние дел и — пока подключение не завершено — карточку «Подключение организации» с тремя шагами и кнопками «Подключить самостоятельно» / «Написать в поддержку». Здесь же строка «Ваш ID: … — укажите его при обращении в поддержку»: с ID разговор с поддержкой начинается сразу с дела.
«Счета»: главный рабочий экран
Таблица всех счетов: «№ / Клиент» (плюс бейджи «Тест» у sandbox-счетов и «Авто» у счетов подписок), «Описание», «Сумма» (с оранжевым тегом возврата «-N ₸»), «Статус» (вместе со способом оплаты: Kaspi Gold, Kaspi Red, рассрочка и т.д.), «Дата», «Источник» (имя API-ключа) и «Действия». Статусы обновляются сами — страница опрашивает сервер каждые 5 секунд, пока есть «живые» счета; F5 не нужен.
Что здесь делают: ищут счёт (поиск «по номеру или описанию»), фильтруют по статусу и датам, выгружают отчёт кнопкой «Экспорт» (Excel/CSV/PDF, с опцией «Включить товары»), делают «Возврат» и «Отменить счет» прямо из строки, а в песочнице — «Симулировать» оплату.
Неочевидная фишка: все фильтры, сортировка и страница зеркалятся в адресную строку — отфильтрованный список можно сохранить в закладки или отправить коллеге ссылкой. Вторая: кнопка «Колонки» настраивает состав и порядок колонок (например, включить «Источник», который по умолчанию виден только на широких экранах). Разрез выручки по точкам и ключам — отдельная тема: Раздельная отчётность по точкам.
«Создать счет»: счёт по телефону или QR на кассе
Переключатель «Счёт по телефону» / «QR-код на кассе». По телефону: номер клиента (формат 87XXXXXXXXX), сумма, описание, срок действия (по умолчанию 24 часа). QR — для кассы: «Телефон клиента не нужен», покажите QR — клиент отсканирует приложением Kaspi. Живёт такой код недолго, правила окна и лимитов — QR-счёт: TTL и лимиты.
Фишка: при вводе телефона кабинет сразу проверяет клиента — «Клиент найден» / «Номер не найден в Kaspi». Это спасает от главной причины неоплат ещё до выставления счёта. Подробно про счета и статусы: Как создать счёт Kaspi по номеру.
«Автоплатежи»: подписки
Регулярные счета: система сама выставляет клиенту счёт по расписанию — это авто-выставление счёта, а не автосписание с карты, клиент каждый раз подтверждает оплату в своём Kaspi. Здесь управляют паузами, возобновлением и отменой. Подробно: Подписки ApiPay.
«Возвраты»: журнал возвратов
Все возвраты по оплаченным счетам: полные и частичные, со статусами. Фишка: возвраты, которые кассир сделал руками в приложении Kaspi, тоже подтягиваются в этот журнал автоматически. Правила и ограничения: Возвраты Kaspi через API.
«Настройки»: сердце интеграции
Самый насыщенный раздел — до 6 вкладок (на мобильном вкладок нет: сначала список разделов, тап открывает нужный):
- «Профиль» — ваши данные.
- «Организация» — данные организации, верификация и накопление счетов; в песочнице не показывается, доступна владельцу.
- «Подключение» (developer+) — API-ключи и уведомления: «Создать новый ключ», карточки ключей с хвостом
****hint, «Проверить уведомления», блок «Уведомления об оплатах» с полем «Секретный ключ» и кнопкой «Сгенерировать». Здесь же карточка «Подключаете с помощью ИИ-помощника?» с кнопкой «Копировать инструкцию для ИИ». Подробно: API-ключ и webhook secret. - «Сотрудники» (видна с developer) — коллеги в кабинете. Тот же раздел вынесен отдельным пунктом меню «Сотрудники», так что заходить в настройки необязательно. Приглашать, менять роль и удалять может только владелец: у developer список открывается на чтение. Пункт меню «Сотрудники» появляется с роли developer; у роли «Менеджер» его нет, как нет и самой вкладки в настройках.
- «Лог уведомлений» (developer+) — история отправленных вебхуков с HTTP-кодами и — главная фишка — кнопка «Повторить», которая ре-отправляет вебхук вручную. Разбор недоставок: Настройка вебхуков.
- «Авторизация Kaspi» — статус кассира («Активна» / «Истекла»…), кнопки «Подключить» / «Сменить кассира» / «Отключить». Видна под аккаунтом владельца.
- Над вкладками — баннер режима «ТЕСТОВЫЙ РЕЖИМ» / «РАБОЧИЙ РЕЖИМ» с кнопкой переключения; переключение доступно владельцу и developer. Что меняется при переходе: Песочница и рабочий режим.
«Мой тариф»: оплата доступа
Визард из трёх шагов «Тариф → Период → Оплата»: выбираете тариф, период со скидкой, вводите номер телефона — и оплачиваете счёт в своём Kaspi. Плашка «Пробный период: осталось N дн.» живёт здесь же. Фишка: остаток триала не сгорает — «После оплаты оставшиеся дни добавятся к новой подписке». Счёт на продление можно выставлять автоматически — за 3 дня до конца тарифа он придёт в Kaspi; деньги при этом не списываются. Цены — Тарифы и комиссия ApiPay, дневной лимит счетов — Лимит счетов по тарифу.
Шапка: организации и «Помощь»
Кнопка с именем организации открывает переключатель: у каждой организации в списке видны роль, метка «Тест» и статус оплаты «Оплачена» / «Пробный» / «Не оплачена» — тариф у каждой организации свой, и это видно не заходя внутрь. Внизу списка — «Новая организация».
Если у текущей организации больше одной кассы, под её именем разворачивается список касс: галочкой отмечена основная (в неё уходят счета без kaspi_connection_id), карандашом касса переименовывается, кликом — назначается основной.
Кнопка «Помощь» даёт три пункта: «Гид по странице» (экскурсия подсвечивает элементы текущего экрана — есть на Главной, в Счетах, Настройках и создании счёта), «Написать в поддержку» и «База знаний».
Вопросы и ответы
Почему я не вижу вкладку «Лог уведомлений»?
Она открывается с роли developer и выше. То же с «Подключением» и «Сотрудниками»; вкладку «Организация» видит владелец, и её нет в песочнице.
Где взять API-ключ?
«Настройки» → вкладка «Подключение» → «Создать новый ключ». Ключ и секрет показываются один раз — сохраните сразу.
Можно ли вести несколько бизнесов в одном кабинете?
Да — переключатель организаций в шапке; у каждой организации свой тариф и свои ключи. Подробно: Мультиорганизации и партнёрам.