Шаг 1. Клиенту приходит счёт в его Kaspi
Вы (или ваш сайт/бот через API) выставляете счёт на номер телефона клиента. Дальше работает сам Kaspi: клиенту приходит push-уведомление о выставленном счёте — по опыту оплат тарифов ApiPay тем же механизмом, уведомление приходит в течение минуты. Если push потерялся (отключены уведомления, плохая связь) — счёт всё равно ждёт клиента внутри приложения Kaspi, достаточно его открыть.
В уведомлении о счёте клиент видит номер, с которого выставлен счёт, — это номер вашего кассира (почему так устроено); это штатное поведение Kaspi и на оплату не влияет. Как именно выглядит карточка счёта на экране покупателя — сумма, описание, название — определяет интерфейс Kaspi.
Важно, чего клиент не видит: ссылок «перейдите на сайт для оплаты», форм ввода карты, упоминаний посредников. ApiPay — независимый сервис поверх вашего Kaspi Pay: счёт выставляется штатной функцией Kaspi, деньги идут напрямую на ваш Kaspi-счёт, ApiPay к деньгам доступа не имеет.
Шаг 2. Оплата в пару касаний
Клиент открывает Kaspi и подтверждает оплату — так же, как оплачивает любой счёт Kaspi. Платит тем, чем привык: Kaspi Gold, Kaspi Red, рассрочка или кредит, счёт бизнеса — способ выбирает сам, вам различие не важно: вы в любом случае получаете полную сумму на свой Kaspi-счёт (способ оплаты потом виден в кабинете, в колонке «Статус» списка счетов).
Вы узнаёте об оплате мгновенно: статус в кабинете сменится на «Оплачен» (страница «Счета» обновляется сама), а если настроены вебхуки — уведомление придёт и вашему сайту или боту. В данных оплаты вам приходит имя плательщика в формате «Иван И.» — фамилию целиком Kaspi не передаёт.
Вариант с QR: оплата на кассе
Для офлайн-точки сценарий ещё короче: вы показываете QR (с экрана или кассы) — клиент сканирует его своим приложением Kaspi и подтверждает сумму. Телефон клиента спрашивать не нужно. QR-счёт живёт около 5 минут — этого хватает на оплату у кассы; точный момент истечения определяет Kaspi. Кстати, вы можете видеть момент, когда клиент отсканировал QR, ещё до оплаты — в интеграции это событие qr_scanned. Подробности и лимиты: QR-счёт: TTL и лимиты.
Что видит клиент, если счёт истёк или отменён?
- Счёт по номеру живёт 24 часа (или срок, который вы задали). Не оплатил вовремя — счёт становится недействительным, у вас статус «Истек». Хочет оплатить позже — просто выставьте новый счёт, это бесплатно и занимает секунды.
- QR истёк (~5 минут) — сгенерируйте новый QR, клиент отсканирует ещё раз.
- Клиент сам закрыл счёт в Kaspi или свернул приложение, не подтвердив, — у вас статус «Отменен». Это решение клиента, а не сбой: при QR-оплате Kaspi различает «явно отказался» и «не подтвердил».
- Редкий, но штатный случай: клиент успел оплатить в момент, когда счёт отменялся или истекал, — оплата побеждает, счёт становится «Оплачен». Не паникуйте при переходе «Отменен → Оплачен»: деньги пришли, всё честно.
Что видит клиент при возврате?
Возврат вы делаете из кабинета («Возврат» в строке счёта) или через API — полный или частичный. Деньги возвращаются клиенту через Kaspi; окно возврата — около 14 дней с момента оплаты. Правила, лимиты и разбор отказов: Возвраты Kaspi через API.
Частые ошибки
- Бояться, что «клиент испугается незнакомого сервиса». Клиент не встречает никакого сервиса — только штатный счёт Kaspi в своём приложении.
- Выставлять счёт на номер без Kaspi. Счёт не создастся (ошибка «этот номер не зарегистрирован в Kaspi»), клиент ничего не получит. Кабинет проверяет номер заранее: «Клиент найден» / «Номер не найден в Kaspi». Разбор: Оплата не приходит.
- Не предупредить про номер кассира. Клиент видит счёт с незнакомого номера — лучше заранее сказать «придёт счёт Kaspi» при продаже.
- Держать клиента у кассы со «старым» QR. QR живёт ~5 минут — если пауза затянулась, просто сгенерируйте новый.
- Паниковать при «Отменен → Оплачен». Это легитимная гонка: оплата выиграла, деньги на вашем Kaspi-счёте.
- Обещать клиенту «спишется автоматически» при подписке. Подписка в ApiPay — авто-выставление счёта: клиент каждый раз подтверждает оплату сам.
Вопросы и ответы
Увидит ли клиент название моего магазина?
В уведомлении о счёте клиент видит номер вашего кассира — это подтверждено. Отображается ли рядом название организации и в каком виде — зависит от интерфейса Kaspi. Надёжная практика — предупреждать клиента «сейчас придёт счёт Kaspi» при продаже.
Что если у клиента нет Kaspi?
Счёт просто не выставится: система вернёт ошибку «этот номер телефона не зарегистрирован в Kaspi» (client_not_found), и клиент ничего не увидит. Попросите другой номер — например, номер родственника с Kaspi. Маршрут диагностики: Оплата не приходит.
Клиент говорит «мне ничего не пришло». Что делать?
Попросите открыть приложение Kaspi — счёт ждёт внутри, даже если push потерялся. Если счёта нет и там, проверьте статус в кабинете: возможно, счёт ещё выставляется, истёк или номер был указан с ошибкой.
Может ли клиент оплатить частично или поторговаться в приложении?
Нет, счёт оплачивается целиком одной суммой. Скидку задаёте вы при создании счёта; частичный возврат возможен после оплаты.
Видит ли клиент, что я пользуюсь ApiPay?
Нет. ApiPay — независимый сервис поверх вашего Kaspi Pay: он автоматизирует выставление счетов, но клиент взаимодействует только с Kaspi, и деньги идут напрямую на ваш Kaspi-счёт.