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

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

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

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

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

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

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

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

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

Фишка: при вводе телефона кабинет сразу проверяет клиента — «Клиент найден» / «Номер не найден в Kaspi». Это спасает от главной причины неоплат ещё до выставления счёта. Подробно про счета и статусы: Как создать счёт Kaspi по номеру.

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

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

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

Все возвраты по оплаченным счетам: полные и частичные, со статусами. Фишка: возвраты, которые кассир сделал руками в приложении Kaspi, тоже подтягиваются в этот журнал автоматически. Правила и ограничения (окно ~14 дней, 3 попытки): Возвраты Kaspi через API.

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

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

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

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

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

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

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

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

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

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

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

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