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

# Не проходят оплаты: проблема у вас или у Kaspi?

**TL;DR.** Если вы выставляете счета Kaspi Pay через ApiPay и оплаты «встали», за 2 минуты это разбирается тремя вопросами: не проходит **один счёт или все**, **отдаёт ли ApiPay ошибку** при создании счёта и **открывается ли приложение Kaspi** у вас и у покупателя. Один счёт с кодом ошибки — почти всегда дело в настройке или в номере покупателя (см. «[Оплата не приходит](/guides/oplata-ne-prihodit-kaspi)»). Массовые задержки, когда у многих покупателей Kaspi пишет «Попробуйте позже», похожи на сбой на стороне Kaspi, а ответ `503 invoices_disabled` — на плановые работы ApiPay. В любом из случаев не пересоздавайте счета лавиной.

## Вы покупатель, и оплата не прошла?

Обращайтесь к продавцу или в поддержку Kaspi — ApiPay делает инструмент для продавцов и к вашему платежу доступа не имеет. Если вы продавец — читайте ниже.

## Как быстро понять, где проблема?

| Симптом | Похоже на | Что делать |
|---|---|---|
| Не проходит один счёт, есть код ошибки | Проблема у вас или у покупателя | Разобрать по «[Оплата не приходит](/guides/oplata-ne-prihodit-kaspi)» |
| Счёт долго в `processing` | Обычно это секунды. Дольше — включён режим накопления, идут плановые работы ApiPay, либо счёт вот-вот получит `error` | Не пересоздавать, дождаться вебхука; сверить `GET /account/health` → `invoicing.accumulating` |
| Массово: все счета медленные, покупатели видят «Попробуйте позже» | Сбой на стороне Kaspi | Снизить темп выставления; счета с `error_code: kaspi_throttled` выставить заново |
| Создание счёта отвечает **503 `invoices_disabled`** | Плановые работы ApiPay | Счёт не создан — повторить позже. Без заголовка `Retry-After` остановлен приём всех счетов: бэкофф в минутах. С `Retry-After` (так отвечает QR) на паузе только запросы в Kaspi: счета по номеру в это время принимаются в `processing` и уйдут в Kaspi сами — их не пересоздавать |

## Не проходит один счёт или все?

Откройте раздел «Счета» в кабинете ApiPay и посмотрите на **масштаб**.

- **Не проходит один конкретный счёт**, остальные оплачиваются нормально — проблема почти наверняка локальная: не тот номер покупателя, у покупателя нет приложения Kaspi, истёк срок счёта, закончился дневной лимит тарифа. Это разбирается в статье «[Оплата не приходит: проблема у вас](/guides/oplata-ne-prihodit-kaspi)».
- **Не проходят все или почти все счета сразу** — переходите к следующему вопросу, это уже похоже на что-то системное.

## ApiPay отдаёт ошибку — или счета создаются, но их не оплачивают?

**Ошибка при создании счёта.** У ответа есть `error_code` — он и есть диагноз, и почти всегда это «ваша» сторона: `client_not_found` и `organization_not_configured` разобраны в «[Оплата не приходит](/guides/oplata-ne-prihodit-kaspi)», `403 tariff_inactive` — в «[Тарифах и комиссии](/guides/tarify-i-komissiya-apipay)», `429 trial_daily_limit` и `429 tariff_limit_reached` — в «[Лимите счетов по тарифу](/guides/limit-schetov-po-tarifu)», `409 duplicate_idempotency_key` — в «[Счета дублируются](/guides/scheta-dubliruyutsya)». `409 kaspi_session_expired` или `503 kaspi_session_invalid` — сессия кассира оборвалась, и тогда не проходят **все** счета: переподключите кассира по «[Почему слетела сессия кассира](/guides/pochemu-sletala-sessiya-kassira)», повтор без этого не поможет. Заранее это видно в `GET /account/health` → `connection.needs_reauth`. При плановых работах ApiPay создание счёта может ответить `503 invoices_disabled` (счёт не создан), про это ниже.

**Счета создаются (`processing` или `pending`), но покупатели не платят.** Покупатель мог просто не открыть Kaspi — счёт по номеру ждёт его 24 часа. Если застряли **многие** счета и покупатели жалуются, что у них «не проходит», — переходите к вопросу про приложение Kaspi.

> Счёт по номеру проходит путь `processing` → `pending` → `paid` / `cancelled` / `expired`. `processing` — счёт ещё не отправлен в Kaspi; обычно это секунды, дальше счёт получает `pending` (создан в Kaspi и ждёт оплаты) либо `error` с причиной. `pending` — не финал: такой счёт живёт свой срок и уходит в `paid`, `cancelled` или `expired`. Долгое ожидание в `processing` бывает при включённом режиме накопления (проверьте `GET /account/health` → `invoicing.accumulating`: `true` — счета копятся и в Kaspi не уходят) и во время плановых работ ApiPay; в обоих случаях счёт не пересоздают. Подробно про статусы — «[Жизненный цикл счёта](/guides/zhiznennyy-tsikl-scheta)».

## Открывается ли приложение Kaspi?

Откройте **приложение Kaspi** на своём телефоне: тормозит, не грузит, показывает ошибки? Спросите покупателя, не пишет ли Kaspi при оплате **«Попробуйте позже»**. Если так у многих — с высокой вероятностью проблема не в вашей настройке, а во временном сбое на стороне Kaspi. Справка Kaspi для продавцов — [guide.kaspi.kz](https://guide.kaspi.kz/).

## Что делать в каждом из трёх случаев?

### Похоже, проблема у вас

Признаки: не проходит один-два счёта; в ответе есть конкретный `error_code`; у покупателя нет приложения Kaspi; неактивна подписка или исчерпан дневной лимит тарифа; недавно перевыпускали ключи; слетела сессия кассира («[Почему слетела сессия кассира](/guides/pochemu-sletala-sessiya-kassira)»). Маршрут по симптомам — «[Оплата не приходит](/guides/oplata-ne-prihodit-kaspi)».

### Похоже, сбой на стороне Kaspi

Признаки: массовые задержки сразу по многим счетам; покупатели видят «Попробуйте позже»; приложение Kaspi подтормаживает у разных людей.

**Как это выглядит в ApiPay:**
- счёт, который Kaspi отбил по частоте запросов, получает статус `error` с `error_code: kaspi_throttled` и вебхук. Автоматических повторов по такому счёту нет — заказ выставляют заново новым счётом через 2–3 минуты;
- счёт, не доехавший до Kaspi из-за сетевого сбоя, получает `error` с `network_unavailable` — такой заказ выставляют заново через 1–3 минуты;
- уже созданные в Kaspi счета (`pending`) живут своим сроком. Как только ApiPay видит у такого счёта новый статус, он присылает вебхук `invoice.status_changed`; проверить статус самому можно в кабинете или через `GET /invoices/{id}`.

**Что делать вам:**
- **снизьте темп выставления** — счёт с `kaspi_throttled` нужно выставлять заново, и залпом вы получите ту же ошибку по всей пачке;
- **не пересоздавайте счёт, пока он в `processing`**: получатся два живых счёта, и покупатель может оплатить оба. Перевыставляйте по вебхуку со статусом `error` или `expired`, а не по таймауту;
- предупредите покупателей о возможной задержке оплаты;
- **различайте два финала.** Счёт, уже созданный в Kaspi (`pending`), доживает свой срок и уходит в `expired`, если его не оплатили; счёт, не доехавший до Kaspi, получает `error` — ждать его не нужно, заказ выставляют заново. В обоих случаях заказ выставляют заново, повтор с тем же `external_order_id_idempotency` дубля не даст («[Счета дублируются](/guides/scheta-dubliruyutsya)»). Поздний `paid` по уже закрытому счёту обрабатывайте так же, как обычный — см. «[Жизненный цикл счёта](/guides/zhiznennyy-tsikl-scheta)».

### Похоже, плановые работы ApiPay

У техработ есть машинный признак — **HTTP 503**. Работы бывают двух видов:

- **Полная остановка приёма счетов.** Все ручки создания счетов и ссылок на оплату (`POST /invoices`, `/invoices/bulk`, `/invoices/qr`, `POST /static-qr`) отвечают `503 {"error_code": "invoices_disabled"}` без заголовка `Retry-After`. Счёт **не создан**, и повтор позже дубля не даст. Ретрайте с бэкоффом в минутах, не в секундах. Чтение счетов, отмена, возврат и статусы при этом продолжают работать.
- **Пауза только запросов в Kaspi.** Счёт по номеру телефона принимается как обычно — `201` со статусом `processing` — и уходит в Kaspi сам после работ: не пересоздавайте его. QR-счёт в это время отвечает `503 invoices_disabled` с заголовком `Retry-After`: QR не создан; повторите не раньше, чем через паузу из `Retry-After`: это подсказка, а не срок окончания работ. Другие операции, которым нужен ответ Kaspi (чеки, касса, возврат по ссылке), в это время тоже могут отвечать `503` своими кодами — повторите позже.

Подключение и переавторизация кассира во время работ могут отвечать `503 entrance_auth_disabled`, а уже подключённые кассиры работают.

О плановых работах ApiPay пишет в WhatsApp на ваш личный номер — ориентируйтесь на указанное в сообщении время окончания.

## Как узнавать о сбое раньше покупателя?

Проверять всё это руками имеет смысл, пока счетов немного. Автоматизировать диагностику стоит, когда:

- счета выставляет сайт, бот или CRM, и о сбое вы узнаёте от покупателей;
- счетов в день сотни, и перебирать их в кабинете долго;
- другая система (склад, выдача доступа) ждёт статус оплаты.

ApiPay отдаёт то же самое машине: `GET /account/health` показывает состояние подключения кассира, тарифа и режима накопления, а вебхук `invoice.status_changed` приносит `error` с `error_code` по каждому счёту — ваша система может сама притормозить выставление при `kaspi_throttled` и перевыставить заказ с тем же `external_order_id_idempotency`. Это тот же ApiPay, тот же тариф и кабинет — переносить ничего не нужно. Подробнее — [Kaspi API](/kaspi-api) и [документация API](/docs); код может написать ваш ИИ-агент — дайте ему [apipay.kz/for-ai](https://apipay.kz/for-ai).

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

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

**У меня как покупателя не списалась оплата Kaspi — что делать?**
Обращайтесь к продавцу или в поддержку Kaspi. ApiPay — сервис для продавцов, к платежам покупателей доступа у него нет.

**Потеряются ли оплаты, пока у Kaspi сбой?**
ApiPay к деньгам доступа не имеет: оплата идёт напрямую на Kaspi-счёт продавца. Счета, уже созданные в Kaspi (`pending`), живут своим сроком, и новый статус ApiPay присылает вебхуком `invoice.status_changed`, как только его видит. Счета, не доехавшие до Kaspi, получают `error` с причиной — их выставляют заново.

**Что делать прямо сейчас, если у Kaspi сбой?**
Снизить темп выставления, не пересоздавать счета, которые ещё в `processing`, предупредить покупателей о возможной задержке. Перевыставлять заказ — по статусу `error` или `expired`, с тем же `external_order_id_idempotency`.

**ApiPay предупреждает о плановых работах?**
Да, о плановых работах ApiPay пишет в WhatsApp на ваш личный номер. Работы бывают двух видов. При полной остановке приёма создание любого счёта отвечает `503 invoices_disabled` без заголовка `Retry-After` — счёт не создан, повторяйте позже. При паузе только запросов в Kaspi счёт по номеру принимается в `processing` и уйдёт в Kaspi сам после работ — не пересоздавайте его, а QR отвечает `503 invoices_disabled` с `Retry-After`.

---

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