> Источник: https://apipay.kz/guides/chto-vidit-pokupatel · Обновлено: 2026-07-06 · apipay.kz
> ApiPay — независимый сервис приёма платежей поверх вашего Kaspi Pay.

# Что видит покупатель, когда вы выставляете счёт через ApiPay?

**TL;DR.** Покупатель не видит ни ApiPay, ни «незнакомых сервисов» — он видит **обычный счёт Kaspi в своём собственном приложении Kaspi**, тем же способом, каким ему выставил бы счёт любой продавец. Счёт приходит уведомлением в течение ~минуты и живёт **24 часа**; QR на кассе клиент сканирует приложением Kaspi, такой счёт действует **около 5 минут**. Оплата — пара касаний: открыть Kaspi → подтвердить, платит со своего Kaspi Gold, Kaspi Red или в рассрочку. Никаких ссылок на сторонние сайты, никаких вводов карты — поэтому «клиент испугается» на практике не случается: для него это привычная оплата Kaspi.

## Коротко

| Вопрос | Ответ |
|---|---|
| Куда приходит счёт | В приложение Kaspi покупателя, уведомлением — обычно в течение минуты |
| Сколько живёт счёт по номеру | 24 часа (срок можно задать при создании) |
| Сколько живёт QR-счёт | ~5 минут; точный момент истечения определяет Kaspi |
| Чем платит клиент | Своим Kaspi: Gold, Red, рассрочка/кредит, счёт бизнеса |
| Нужны ли ссылки или ввод карты | Нет — всё внутри приложения Kaspi |
| Что нужно от клиента | Только номер телефона, зарегистрированный в Kaspi |
| Если клиент не в Kaspi | Счёт не выставится (ошибка client_not_found), клиент ничего не увидит |

## Шаг 1. Клиенту приходит счёт в его Kaspi

Вы (или ваш сайт/бот через API) выставляете счёт на номер телефона клиента. Дальше работает сам Kaspi: клиенту приходит push-уведомление о выставленном счёте — по опыту оплат тарифов ApiPay тем же механизмом, уведомление приходит **в течение минуты**. Если push потерялся (отключены уведомления, плохая связь) — счёт всё равно ждёт клиента внутри приложения Kaspi, достаточно его открыть.

В уведомлении о счёте клиент видит номер, с которого выставлен счёт, — это **номер вашего кассира** ([почему так устроено](/guides/trebovaniya-k-nomeru-kassira)); это штатное поведение Kaspi и на оплату не влияет. Как именно выглядит карточка счёта на экране покупателя — сумма, описание, название — определяет интерфейс Kaspi.

Важно, чего клиент **не** видит: ссылок «перейдите на сайт для оплаты», форм ввода карты, упоминаний посредников. ApiPay — независимый сервис поверх вашего Kaspi Pay: счёт выставляется штатной функцией Kaspi, деньги идут напрямую на ваш Kaspi-счёт, ApiPay к деньгам доступа не имеет.

## Шаг 2. Оплата в пару касаний

Клиент открывает Kaspi и подтверждает оплату — так же, как оплачивает любой счёт Kaspi. Платит тем, чем привык: **Kaspi Gold, Kaspi Red, рассрочка или кредит, счёт бизнеса** — способ выбирает сам, вам различие не важно: вы в любом случае получаете полную сумму на свой Kaspi-счёт (способ оплаты потом виден в кабинете, в колонке «Статус» списка счетов).

Вы узнаёте об оплате мгновенно: статус в кабинете сменится на «Оплачен» (страница «Счета» обновляется сама), а если настроены [вебхуки](/guides/nastroyka-webhookov-apipay) — уведомление придёт и вашему сайту или боту. В данных оплаты вам приходит имя плательщика в формате «Иван И.» — фамилию целиком Kaspi не передаёт.

## Вариант с QR: оплата на кассе

Для офлайн-точки сценарий ещё короче: вы показываете QR (с экрана или кассы) — клиент **сканирует его своим приложением Kaspi** и подтверждает сумму. Телефон клиента спрашивать не нужно. QR-счёт живёт **около 5 минут** — этого хватает на оплату у кассы; точный момент истечения определяет Kaspi. Кстати, вы можете видеть момент, когда клиент отсканировал QR, ещё до оплаты — в интеграции это событие `qr_scanned`. Подробности и лимиты: [QR-счёт: TTL и лимиты](/guides/qr-schet-ttl-i-limity).

## Что видит клиент, если счёт истёк или отменён?

- **Счёт по номеру** живёт 24 часа (или срок, который вы задали). Не оплатил вовремя — счёт становится недействительным, у вас статус «Истек». Хочет оплатить позже — просто выставьте новый счёт, это бесплатно и занимает секунды.
- **QR истёк** (~5 минут) — сгенерируйте новый QR, клиент отсканирует ещё раз.
- **Клиент сам закрыл счёт** в Kaspi или свернул приложение, не подтвердив, — у вас статус «Отменен». Это решение клиента, а не сбой: при QR-оплате Kaspi различает «явно отказался» и «не подтвердил».
- Редкий, но штатный случай: клиент успел оплатить в момент, когда счёт отменялся или истекал, — **оплата побеждает**, счёт становится «Оплачен». Не паникуйте при переходе «Отменен → Оплачен»: деньги пришли, всё честно.

## Что видит клиент при возврате?

Возврат вы делаете из кабинета («Возврат» в строке счёта) или через API — полный или частичный. Деньги возвращаются клиенту через Kaspi; окно возврата — **около 14 дней** с момента оплаты. Правила, лимиты и разбор отказов: [Возвраты Kaspi через API](/guides/vozvraty-kaspi-cherez-api).

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

- **Бояться, что «клиент испугается незнакомого сервиса».** Клиент не встречает никакого сервиса — только штатный счёт Kaspi в своём приложении.
- **Выставлять счёт на номер без Kaspi.** Счёт не создастся (ошибка «этот номер не зарегистрирован в Kaspi»), клиент ничего не получит. Кабинет проверяет номер заранее: «Клиент найден» / «Номер не найден в Kaspi». Разбор: [Оплата не приходит](/guides/oplata-ne-prihodit-kaspi).
- **Не предупредить про номер кассира.** Клиент видит счёт с незнакомого номера — лучше заранее сказать «придёт счёт Kaspi» при продаже.
- **Держать клиента у кассы со «старым» QR.** QR живёт ~5 минут — если пауза затянулась, просто сгенерируйте новый.
- **Паниковать при «Отменен → Оплачен».** Это легитимная гонка: оплата выиграла, деньги на вашем Kaspi-счёте.
- **Обещать клиенту «спишется автоматически» при подписке.** Подписка в ApiPay — авто-выставление счёта: клиент каждый раз подтверждает оплату сам.

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

**Увидит ли клиент название моего магазина?**
В уведомлении о счёте клиент видит номер вашего кассира — это подтверждено. Отображается ли рядом название организации и в каком виде — зависит от интерфейса Kaspi. Надёжная практика — предупреждать клиента «сейчас придёт счёт Kaspi» при продаже.

**Что если у клиента нет Kaspi?**
Счёт просто не выставится: система вернёт ошибку «этот номер телефона не зарегистрирован в Kaspi» (client_not_found), и клиент ничего не увидит. Попросите другой номер — например, номер родственника с Kaspi. Маршрут диагностики: [Оплата не приходит](/guides/oplata-ne-prihodit-kaspi).

**Клиент говорит «мне ничего не пришло». Что делать?**
Попросите открыть приложение Kaspi — счёт ждёт внутри, даже если push потерялся. Если счёта нет и там, проверьте статус в кабинете: возможно, счёт ещё выставляется, истёк или номер был указан с ошибкой.

**Может ли клиент оплатить частично или поторговаться в приложении?**
Нет, счёт оплачивается целиком одной суммой. Скидку задаёте вы при создании счёта; частичный возврат возможен после оплаты.

**Видит ли клиент, что я пользуюсь ApiPay?**
Нет. ApiPay — независимый сервис поверх вашего Kaspi Pay: он автоматизирует выставление счетов, но клиент взаимодействует только с Kaspi, и деньги идут напрямую на ваш Kaspi-счёт.

---

ApiPay — независимый сервис и не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.
База знаний: https://apipay.kz/guides