Коротко
Счёт по телефону (kind: "phone") приходит покупателю уведомлением в приложение Kaspi. Если приложения у него нет, счёт никуда не появится — покупатель ждёт, вы ждёте. Решение простое: дайте этому покупателю QR или ссылку на оплату. QR и ссылка приходят в одном и том же ответе на создание счёта, ничего дополнительно делать не нужно.
Симптом → причина → решение
| Симптом | Причина | Решение |
|---|---|---|
| Счёт по телефону создан, покупателю ничего не пришло | У покупателя нет приложения Kaspi | Отмените счёт и дайте QR или ссылку payUrl |
| Покупатель говорит «мне ничего не приходит» | Номер чужой или введён с ошибкой | Перезапросите номер в формате 7XXXXXXXXXX |
| Покупатель за границей, Kaspi у него нет | Kaspi рассчитан на клиентов в Казахстане | Предложите QR или ссылку; если не выходит — нужен другой способ |
Счёт висит в pending, денег нет | Покупатель ещё не подтвердил оплату | Пришлите ссылку повторно или создайте новый счёт |
| Покупатель говорит «QR не читается» | Окно сканирования истекло | Создайте новый счёт: QR показывает «попробуйте позже» |
Что делать
1. Создавайте счёт в виде QR. Если не указывать kind, по умолчанию будет qr. В ответе сразу приходит несколько полей:
| Поле | Для чего |
|---|---|
qrUrl, qrImageUrl | QR для экрана или для печати |
payUrl | Ссылка, которую можно отправить в WhatsApp, Telegram, SMS |
deepLink | Ссылка, открывающая приложение на телефоне напрямую |
expiresAt | До какого момента действует этот счёт |
2. Отправьте ссылку. payUrl — обычная веб-ссылка. Покупатель открывает её из любого мессенджера, на странице есть QR и кнопка оплаты.
3. Используйте постоянную ссылку на оплату. Не под одного покупателя, а на общий случай: ссылку вида qut.kz/p/<slug> вы создаёте один раз и кладёте в профиль, в чат, в счёт на оплату. Подробнее: Ссылки на оплату.
4. На офлайн-точке — QR на экране. Тогда вообще не нужно знать, какое приложение стоит у покупателя: он сканирует QR тем, чем привык.
Про сканирование QR другим приложением
QR на экране покупатель может попробовать прочитать не только Kaspi, но и сканером своего банковского приложения. Где-то это сработает, где-то нет — это зависит от банка и от стороны Kaspi, мы этим не управляем и гарантировать не можем.
Поэтому не обещайте покупателю «оплатите любым банком». Правильная формулировка: «отсканируйте QR камерой или сканером банковского приложения, а если не откроется — оплатите через Kaspi».
А счёт по телефону (kind: "phone") работает только через приложение Kaspi. Здесь альтернативы нет.
Как проверить заранее
Перед тем как отправлять счёт на телефон:
- Спросите. Один вопрос «у вас есть приложение Kaspi?» экономит и пустой счёт, и ожидание.
- Проверьте формат номера.
7XXXXXXXXXX, 11 цифр. В другом формате счёт просто не создастся (invalid_phone). - Убедитесь, что номер принадлежит самому покупателю. Если дали номер супруга или коллеги, счёт уйдёт туда.
- Сомневаетесь — делайте QR. QR всегда безопасный выбор: он даёт и картинку, и ссылку.
В интеграции это можно автоматизировать: если покупатель при оформлении не подтвердил, что платит через Kaspi, создавайте QR-счёт по умолчанию.
Какой способ когда
| Ситуация | Что лучше |
|---|---|
| У покупателя есть Kaspi и вы знаете его номер | Счёт по телефону — самый быстрый |
| Неизвестно, есть ли Kaspi | QR + ссылка payUrl |
| Офлайн-точка, магазин, касса | QR на экране |
| Продажа в мессенджере | Ссылка payUrl |
| Регулярный повторяющийся платёж | Ссылка qut.kz/p/<slug> |
| Покупатель за границей | Может не суметь оплатить через Kaspi, договоритесь заранее |
Полное сравнение двух способов: QR-счёт или счёт по телефону.
Вопросы и ответы
Можно ли требовать от покупателя установить Kaspi? Не нужно и малополезно. Когда есть QR и ссылка, заставлять покупателя ставить приложение — это способ потерять продажу.
Счёт на телефон создан, а приложения у покупателя нет. Деньги где-то зависнут? Нет. По неоплаченному счёту никакие деньги не двигаются. Счёт истечёт и перейдёт в expired либо вы отмените его сами.
Можно ли выставить одному покупателю два счёта — на телефон и QR? Технически да, но не стоит: он может оплатить оба. Отмените первый и создайте новый.
Покупатель отсканировал QR, а там «попробуйте позже». Окно сканирования истекло. Создайте новый счёт, точный срок смотрите в поле expiresAt: Срок жизни счёта.
Покупатель открыл ссылку, но не оплатил. Что делать? Счёт в статусе new или pending, он ещё открыт. Напомните покупателю или создайте новый счёт. Когда он оплатит, вам придёт вебхук.