# У покупателя нет приложения Kaspi — как принять оплату

> Счёт по телефону (kind phone) приходит в приложение Kaspi покупателя, и без приложения он просто не дойдёт. Вместо него нужен QR или ссылка на оплату. Как проверить заранее.

## Коротко

Счёт по телефону (`kind: "phone"`) приходит покупателю **уведомлением в приложение Kaspi**. Если приложения у него нет, счёт никуда не появится — покупатель ждёт, вы ждёте. Решение простое: дайте этому покупателю **QR или ссылку на оплату**. QR и ссылка приходят в одном и том же ответе на создание счёта, ничего дополнительно делать не нужно.

## Симптом → причина → решение

| Симптом | Причина | Решение |
|---|---|---|
| Счёт по телефону создан, покупателю ничего не пришло | У покупателя нет приложения Kaspi | Отмените счёт и дайте QR или ссылку `payUrl` |
| Покупатель говорит «мне ничего не приходит» | Номер чужой или введён с ошибкой | Перезапросите номер в формате `7XXXXXXXXXX` |
| Покупатель за границей, Kaspi у него нет | Kaspi рассчитан на клиентов в Казахстане | Предложите QR или ссылку; если не выходит — нужен другой способ |
| Счёт висит в `pending`, денег нет | Покупатель ещё не подтвердил оплату | Пришлите ссылку повторно или создайте новый счёт |
| Покупатель говорит «QR не читается» | Окно сканирования истекло | Создайте новый счёт: [QR показывает «попробуйте позже»](/kb/ru/qr-expired) |

## Что делать

**1. Создавайте счёт в виде QR.** Если не указывать `kind`, по умолчанию будет `qr`. В ответе сразу приходит несколько полей:

| Поле | Для чего |
|---|---|
| `qrUrl`, `qrImageUrl` | QR для экрана или для печати |
| `payUrl` | Ссылка, которую можно отправить в WhatsApp, Telegram, SMS |
| `deepLink` | Ссылка, открывающая приложение на телефоне напрямую |
| `expiresAt` | До какого момента действует этот счёт |

**2. Отправьте ссылку.** `payUrl` — обычная веб-ссылка. Покупатель открывает её из любого мессенджера, на странице есть QR и кнопка оплаты.

**3. Используйте постоянную ссылку на оплату.** Не под одного покупателя, а на общий случай: ссылку вида `qut.kz/p/<slug>` вы создаёте один раз и кладёте в профиль, в чат, в счёт на оплату. Подробнее: [Ссылки на оплату](/kb/ru/payment-links).

**4. На офлайн-точке — QR на экране.** Тогда вообще не нужно знать, какое приложение стоит у покупателя: он сканирует QR тем, чем привык.

## Про сканирование QR другим приложением

QR на экране покупатель может попробовать прочитать не только Kaspi, но и сканером своего банковского приложения. Где-то это сработает, где-то нет — это зависит от банка и от стороны Kaspi, мы этим не управляем и **гарантировать не можем**.

Поэтому не обещайте покупателю «оплатите любым банком». Правильная формулировка: «отсканируйте QR камерой или сканером банковского приложения, а если не откроется — оплатите через Kaspi».

А счёт по телефону (`kind: "phone"`) работает только через приложение Kaspi. Здесь альтернативы нет.

## Как проверить заранее

Перед тем как отправлять счёт на телефон:

1. **Спросите.** Один вопрос «у вас есть приложение Kaspi?» экономит и пустой счёт, и ожидание.
2. **Проверьте формат номера.** `7XXXXXXXXXX`, 11 цифр. В другом формате счёт просто не создастся (`invalid_phone`).
3. **Убедитесь, что номер принадлежит самому покупателю.** Если дали номер супруга или коллеги, счёт уйдёт туда.
4. **Сомневаетесь — делайте QR.** QR всегда безопасный выбор: он даёт и картинку, и ссылку.

В интеграции это можно автоматизировать: если покупатель при оформлении не подтвердил, что платит через Kaspi, создавайте QR-счёт по умолчанию.

## Какой способ когда

| Ситуация | Что лучше |
|---|---|
| У покупателя есть Kaspi и вы знаете его номер | Счёт по телефону — самый быстрый |
| Неизвестно, есть ли Kaspi | QR + ссылка `payUrl` |
| Офлайн-точка, магазин, касса | QR на экране |
| Продажа в мессенджере | Ссылка `payUrl` |
| Регулярный повторяющийся платёж | Ссылка `qut.kz/p/<slug>` |
| Покупатель за границей | Может не суметь оплатить через Kaspi, договоритесь заранее |

Полное сравнение двух способов: [QR-счёт или счёт по телефону](/kb/ru/qr-vs-phone).

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

**Можно ли требовать от покупателя установить Kaspi?** Не нужно и малополезно. Когда есть QR и ссылка, заставлять покупателя ставить приложение — это способ потерять продажу.

**Счёт на телефон создан, а приложения у покупателя нет. Деньги где-то зависнут?** Нет. По неоплаченному счёту никакие деньги не двигаются. Счёт истечёт и перейдёт в `expired` либо вы отмените его сами.

**Можно ли выставить одному покупателю два счёта — на телефон и QR?** Технически да, но не стоит: он может оплатить оба. Отмените первый и создайте новый.

**Покупатель отсканировал QR, а там «попробуйте позже».** Окно сканирования истекло. Создайте новый счёт, точный срок смотрите в поле `expiresAt`: [Срок жизни счёта](/kb/ru/invoice-expiry).

**Покупатель открыл ссылку, но не оплатил. Что делать?** Счёт в статусе `new` или `pending`, он ещё открыт. Напомните покупателю или создайте новый счёт. Когда он оплатит, вам придёт вебхук.