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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Мини-кейс: работа без API на одном кабинете

Типичный сценарий небольшого бизнеса без программиста в штате. Подключение начинается «попробовать», а через несколько месяцев превращается в основную работу: стабильно десятки–сотни удалённых счетов в день, всё вручную из кабинета. Утром — список клиентов, по каждому номер, сумма и отправка; возвраты по кнопке; в конце месяца — выгрузка в Excel для бухгалтера. Вопросов про API за всё время не возникает — лишь изредка требуется переподключить кассира или выставить счёт на продление тарифа. Позже в кабинет обычно добавляют удалённого технического специалиста «менеджером», чтобы не пересылать друг другу коды входа. Урок простой: кабинет — не витрина для тестов, а полноценный рабочий инструмент, и API нужен не всем.

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