Ветки диагностики
| Признак | Причина | Что сделать | Подробнее |
|---|---|---|---|
| Покупатель сканирует → «Попробуйте позже» | QR истёк: окно на скан меньше трёх минут, продления нет | Создать новый QR прямо перед оплатой | «Сколько на самом деле живёт QR» в «QR-счёте: окно на скан и лимиты» |
| QR «не работает» на тестах | Песочница: тестовый QR в Kaspi не существует | Включить «Рабочий режим» | Песочница и рабочий режим |
Картинка QR отдаёт 404 |
qr_image_url живёт до qr_expires_at + 60 секунд |
Создать новый QR, а не перезагружать картинку | «Ограничения QR-счёта…» в «QR-счёте» |
| Ошибка при создании QR | Описание длиннее 100 символов → 422 по полю description |
Сократить description до 100 символов |
«Ограничения QR-счёта…» в «QR-счёте» |
| Ошибка при создании QR у организации с каталогом | QR-счёт без корзины не создаётся: 422 This organization requires cart items |
Передать cart_items вместо одной суммы |
«Ограничения QR-счёта…» в «QR-счёте» |
Создание QR отдаёт 503 kaspi_session_invalid |
Авторизация кассира оборвана, QR не создан | Переподключить кассира в «Настройки → Авторизация Kaspi»; повтор запроса не поможет | «Ограничения QR-счёта…» в «QR-счёте» |
| «Второй QR сломал первый» | QR-счета сосуществуют: новый QR не отменяет прежние | Просто создавайте новый | «Можно ли держать несколько активных QR одновременно?» в «QR-счёте» |
| В интеграции «ошибка 401» | Развилка: HTTP-код или число в тексте ошибки? | Разводка ниже | — |
«401» — это число или HTTP-код?
HTTP 401 на запросе к ApiPay — невалидный API-ключ (перегенерировался? см. «API-ключ и вебхук-секрет»). Число «401» внутри текста ошибки в JSON — часть сообщения от Kaspi, а не HTTP-статус: ориентируйтесь на код ответа и поле error_code, а не на цифры в message. Присылая ошибку в поддержку, копируйте JSON целиком.
Покупатель платит не сразу? QR — не тот инструмент
QR — как касса в магазине: покупатель стоит рядом и платит сейчас. Если оплата «когда-нибудь в течение дня» — выставляйте счёт по номеру телефона: он живёт 24 часа, покупателю приходит push в Kaspi. Подробно — «Как создать счёт Kaspi по номеру».
Частые вопросы
Покупатель увидел «Попробуйте позже» — счёт пропал?
QR истёк: создайте новый и дайте отсканировать сразу. Оплата по истёкшему QR невозможна, двойного списания не будет.
QR отменился сам — это сбой?
cancelled по QR — действие покупателя (закрыл или свернул приложение). Создайте новый QR.