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

# QR Kaspi показывает «Попробуйте позже» — что делать?

**TL;DR.** Если вы продавец и принимаете оплату QR-счётом ApiPay (`POST /invoices/qr`), «Попробуйте позже» у покупателя почти всегда означает, что **QR уже истёк**: окно на скан — **меньше трёх минут**, точный момент приходит в `qr_expires_at`, продления нет. Что делать: создайте новый QR прямо перед оплатой и дайте покупателю отсканировать его сразу — ждать или сканировать старый QR повторно бесполезно. Каждый созданный QR, в том числе сгоревший, занимает место в дневном лимите тарифа — выпускайте новый, когда покупатель готов сканировать, а не по кругу. Если тестируете, проверьте, что выключена песочница: тестового QR в Kaspi не существует. Остальные причины — в таблице ниже, эндпоинты и поля — в [документации API](/docs).

## Вы покупатель и видите «Попробуйте позже»?

Попросите продавца показать новый QR или прислать новую ссылку на оплату. ApiPay — инструмент продавца: доступа к вашему счёту и платежам в Kaspi у него нет. С вопросами о самом приложении Kaspi обращайтесь в поддержку Kaspi. Если вы продавец — читайте дальше.

## QR выпущен не через ApiPay?

Статья — про QR-счёт, который создаёт ApiPay по запросу вашей кассы, сайта или бота. Если QR показан или напечатан в самом Kaspi Pay без ApiPay, смотрите справку Kaspi для продавцов — [guide.kaspi.kz](https://guide.kaspi.kz/).

## Почему ещё QR может не работать?

| Признак | Причина | Что сделать | Подробнее |
|---|---|---|---|
| Покупатель сканирует → «Попробуйте позже» | QR истёк: окно на скан меньше трёх минут, продления нет | Создать новый QR прямо перед оплатой; каждый QR — место в дневном лимите тарифа | «Сколько на самом деле живёт QR?» в статье «[Сколько живёт QR-счёт Kaspi](/guides/qr-schet-ttl-i-limity)» |
| QR «не работает» на тестах | Песочница: тестовый QR в Kaspi не существует | Включить «Рабочий режим» | [Песочница и рабочий режим](/guides/pesochnitsa-i-rabochiy-rezhim) |
| «Попробуйте позже» у многих покупателей сразу, на свежих QR | Похоже на временный сбой на стороне Kaspi | Не пересоздавать QR лавиной; проверить по шагам | [Проблема у вас или у Kaspi](/guides/problema-u-vas-ili-u-kaspi) |
| Картинка QR отдаёт `404` | `qr_image_url` живёт до `qr_expires_at + 60 секунд` | Создать новый QR, а не перезагружать картинку | «Как создать QR-счёт через API?» в статье «[Сколько живёт QR-счёт Kaspi](/guides/qr-schet-ttl-i-limity)» |
| Ошибка при **создании** QR | Описание длиннее 100 символов → `422` по полю `description` | Сократить `description` до 100 символов | «Какие ограничения у QR-счёта надо знать заранее?» в статье «[Сколько живёт QR-счёт Kaspi](/guides/qr-schet-ttl-i-limity)» |
| Ошибка при **создании** QR у организации с каталогом | QR-счёт без корзины не создаётся: `422 catalog_requires_cart_items` (сообщение «This organization requires cart items») | Передать `cart_items` вместо одной суммы | «Какие ограничения у QR-счёта надо знать заранее?» в статье «[Сколько живёт QR-счёт Kaspi](/guides/qr-schet-ttl-i-limity)» |
| Создание QR отдаёт `409 kaspi_session_expired` (реже `503 kaspi_session_invalid`) | Авторизация кассира оборвана, QR не создан | Переподключить кассира в «Настройки → Авторизация Kaspi»; повтор запроса не поможет | [Привязка кассира разорвалась](/guides/pochemu-sletala-sessiya-kassira) |
| Создание QR отдаёт `503 invoices_disabled` | Технические работы ApiPay, QR не создан | Повторить позже; кассира переподключать не нужно. С заголовком `Retry-After` на паузе только запросы в Kaspi: повторите не раньше, чем через паузу из `Retry-After` (это подсказка, а не срок окончания работ), а на время паузы принимайте оплату счётом по номеру телефона — он примется в `processing` и уйдёт в Kaspi сам после работ, не пересоздавайте его. Без `Retry-After` остановлен приём всех счетов | «Какие ограничения у QR-счёта надо знать заранее?» в статье «[Сколько живёт QR-счёт Kaspi](/guides/qr-schet-ttl-i-limity)» |
| «Второй QR сломал первый» | QR-счета сосуществуют: новый QR не отменяет прежние | Просто создавайте новый | «Можно ли держать несколько активных QR одновременно?» в статье «[Сколько живёт QR-счёт Kaspi](/guides/qr-schet-ttl-i-limity)» |
| В интеграции «ошибка 401» | Развилка: HTTP-код или число в тексте ошибки? | Разводка ниже | — |

Одним статусом `409` или `503` приходят разные причины — ветвитесь по коду в теле ответа (`error_code`, а если его нет — `error`), а не по HTTP-статусу.

## «401» — это число или HTTP-код?

**HTTP 401** на запросе к ApiPay — невалидный API-ключ (перегенерировался? см. «[API-ключ и вебхук-секрет](/guides/api-klyuch-i-webhook-secret)»). Число «401» **внутри текста ошибки** в JSON — часть сообщения от Kaspi, а не HTTP-статус: ориентируйтесь на код ответа и поле `error_code`, а не на цифры в `message`. Присылая ошибку в поддержку, копируйте JSON целиком.

## Что делать, если покупатель платит не сразу?

QR — как касса в магазине: покупатель стоит рядом и платит сейчас. Если оплата «когда-нибудь в течение дня» — выставляйте **счёт по номеру телефона**: он живёт 24 часа, покупателю приходит push в Kaspi. Подробно — «[Как создать счёт Kaspi по номеру](/guides/kak-sozdat-schet-kaspi-po-nomeru)». Обзор сценариев приёма оплаты — «[Как принимать оплату Kaspi через API](/kaspi-api)».

## Частые вопросы

**Почему покупатель видит «Попробуйте позже» при сканировании QR Kaspi?**
Чаще всего QR-счёт истёк: окно на скан — меньше трёх минут (точный момент в `qr_expires_at`), продления нет. Создайте новый QR непосредственно перед оплатой. При тестах проверьте, что не включена песочница — тестового QR в Kaspi не существует.

**Покупатель увидел «Попробуйте позже» — счёт пропал?**
Если QR истёк, оплатить его уже нельзя: создайте новый и дайте отсканировать сразу. Прежний счёт сам перейдёт в `expired` — ориентируйтесь на статус каждого счёта из вебхука.

**Почему не создаётся QR-счёт?**
Проверьте код ошибки: `422` по полю `description` — описание длиннее 100 символов; `422 catalog_requires_cart_items` («This organization requires cart items») — организации с каталогом нужен `cart_items`; `409 kaspi_session_expired` — переподключите кассира; `503 invoices_disabled` — технические работы, повторите позже.

**QR отменился сам — это сбой?**
`cancelled` по QR — действие покупателя (закрыл или свернул приложение). Создайте новый QR.

---

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