Как выставлять счета Kaspi вручную из кабинета — без кода?

Как это работает у вас

Вы в кабинете apipay.kz (с телефона или компьютера)
        │
«Выставить счёт»: номер покупателя + сумма + описание
        │
Покупателю приходит push в приложении Kaspi (счёт живёт 24 часа)
        │
Покупатель оплачивает → статус счёта в кабинете меняется на «Оплачен»
        │
Деньги — напрямую на ваш Kaspi-счёт (ApiPay денег не касается)

Никакого сайта, бота или интеграции. Единственная «техническая» часть — один раз подключить номер кассира; не хочется делать самим — способ 2: напишите в поддержку, и подключение сделают за вас.

Что понадобится

Программист, сайт, онлайн-касса — не нужны.

Пошаговый сетап

1. Зарегистрируйтесь на apipay.kz. Вход — по WhatsApp на ваш личный номер, он не имеет отношения к номеру кассира.
2. Попробуйте в песочнице. Сразу после регистрации весь функционал доступен в тестовом режиме: выставьте себе «счёт», посмотрите статусы — денег это не касается.
3. Подключите номер кассира. Возьмите отдельную SIM, добавьте её сотрудником-кассиром в Kaspi Pay и пройдите «Настройки → Авторизация Kaspi» в кабинете (Подключение кассира). Не получается — способ 2: поддержка подключит за вас.
4. Включите рабочий режим и выставьте первый настоящий счёт: номер покупателя, сумма, описание (до 60 символов). ⚠️ Пока не одобрена анкета о бизнесе на /business-profile, организация выставляет 1 реальный счёт в сутки — счета из кабинета в этот лимит тоже входят: Анкета о бизнесе и лимит.
5. Добавьте команду, если нужно: в кабинете ApiPay есть пункт меню «Сотрудники» — там сотрудник заводится «менеджером» (выставляет счета) или «разработчиком» — у каждого свой вход, ваш код от кабинета никому передавать не нужно.

Что умеет кабинет без единой строчки кода

• Счета по номеру телефона — push покупателю в приложение Kaspi, счёт живёт 24 часа и ждёт внутри приложения; описание — до 60 символов: Kaspi показывает покупателю только первые 60. Ссылки на оплату у такого счёта нет: если нужна именно ссылка или бумажный код, это печатный QR под сделку.
• Возвраты — полный и частичный, по кнопке у оплаченного счёта в разделе «Счета».
• Статусы и история — видно, что оплачено, что ожидает, что отменилось.
• Экспорт отчётов — выгрузка счетов в CSV/XLSX/PDF (до 10 000 строк за раз): для бухгалтерии и сверки.
• Регулярные счета — расписание автоматического выставления (например, ежемесячная оплата абонемента): это авто-выставление счёта, а не автосписание денег.
• Команда — до 10 сотрудников с собственными входами (лимит общий на менеджеров и разработчиков).

Когда пора автоматизировать?

Кабинета достаточно, пока счетов десятки в день и они выставляются «по событию, которое вы видите сами». Задуматься об API стоит, когда:

• счета должны создаваться без вашего участия — из бота, сайта, CRM или по расписанию сложнее, чем «раз в месяц»;
• объём стабильно выше сотни-двух в день и ручной ввод стал узким местом;
• статусы оплат нужно передавать в другую систему (склад, CRM, выдача доступа) автоматически.

Kaspi API — это тот же самый ApiPay, тариф и кабинет; переносить ничего не придётся. А код может написать ваш ИИ-агент: дайте ему страницу apipay.kz/for-ai, например в Lovable.

Грабли этого бизнеса

1. Путаница номеров. Их три: ваш личный (вход в кабинет), номер кассира (отдельная SIM для Kaspi) и номер покупателя (кому счёт). Войдёте номером кассира — вместо своего кабинета попадёте в новый пустой аккаунт или в вопрос «Этот номер уже подключён к ApiPay как номер кассира. Создать для него отдельный аккаунт?» (409 cashier_phone_signup). Выберите «Ввести другой номер» и войдите личным — Вход в кабинет.
2. «Оплата не приходит» в песочнице. Песочница — это имитация: реальных денег там нет. Перед боевыми счетами включите рабочий режим.
3. Код входа — от кабинета ApiPay, не от Kaspi. Сотруднику заводите отдельный доступ «менеджер»: свой код он получит на свой номер, ваш передавать не нужно.
4. Возврат «не проходит» — чаще всего на балансе Kaspi недостаточно средств (возврат уходит с вашего счёта, с учётом комиссии Kaspi). Подробно — возвраты.
5. Под номером кассира не входите в приложение Kaspi Pay — привязка разорвётся, и счета перестанут выставляться, пока вы не переподключите кассира в «Настройки → Авторизация Kaspi». Подробно — Почему слетела сессия кассира.

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