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

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

**TL;DR.** Когда оплаты «встали», сначала определите масштаб тремя вопросами: (1) не проходит **один счёт или все**? (2) API **отдаёт ошибку** или счета создаются, но покупатели не платят? (3) **открывается ли приложение Kaspi** у вас и у покупателя? Один счёт с ошибкой — почти всегда дело в настройке или конкретном номере (см. «[Оплата не приходит](/guides/oplata-ne-prihodit-kaspi)»). Массовые задержки, когда покупатели видят у себя «Попробуйте позже», а приложение Kaspi подтормаживает у всех, — похоже на сбой на стороне приёма. Каждый счёт по номеру идёт в Kaspi **одной реальной попыткой** и всегда доходит до терминального статуса: `pending` либо `error` с `error_code`. Не пересоздавайте счета лавиной.

## Коротко

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

## Вопрос 1. Один счёт или все?

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

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

## Вопрос 2. Ошибка в ответе API — или счета создаются, но их не оплачивают?

**API отдаёт ошибку при создании счёта.** У ответа есть `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)». Признак техработ ApiPay — `503 invoices_disabled` (счёт не создан), про него ниже.

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

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

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

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

## Три исхода — и что делать в каждом

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

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

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

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

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

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

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

У техработ есть машинный признак — **HTTP 503**. `POST /invoices`, `/invoices/bulk`, `/invoices/qr` отвечают `503 {"error_code": "invoices_disabled"}` **до** создания счёта: счёт в системе не появляется, повтор позже дубля не даст. Стоп бывает точечным по кассиру: счёт, адресованный другому кассиру организации (`kaspi_connection_id`), создаётся штатно. Подключение и переавторизация кассира на это время отвечают `503 entrance_auth_disabled`, а уже подключённые кассиры работают. Чтение счетов, отмена, возврат, вебхуки и каталог продолжают работать. Ретрайте с бэкоффом в минутах, не в секундах.

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

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

**Потеряются ли оплаты, пока у Kaspi сбой?**
По счетам, которые уже созданы в Kaspi, уведомления об оплате придут после восстановления связи. Счета, не доехавшие до Kaspi, закончатся статусом `error` с причиной — их выставляют заново.

---

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