Сначала проверьте
- Тариф активен — и виден в этом профиле? Бывает, что оплата уходит с другого профиля (например, вы добавлены разработчиком в чужую организацию) — тогда в вашем кабинете тариф «не появился».
- Недавно привязывали организацию или переключали режим? API-ключ и вебхук-секрет перегенерировались — у партнёров тестовые организации при переходе в production удаляются целиком вместе с ключами. Возьмите новый ключ и перезабейте вебхук.
- Плашка режима. Если в кабинете горит «ТЕСТОВЫЙ РЕЖИМ … Счета не передаются в Kaspi» — дальше можно не искать.
Ветки диагностики
| Признак | Вероятная причина (частота по данным поддержки) | Что сделать | Подробнее |
|---|---|---|---|
| Покупатель по ссылке видит в Kaspi «Пожалуйста, повторите позднее»; счета «создаются», но никуда не уходят | Рабочий режим не включён — чаще всего | Настройки → включить «Рабочий режим» | «Как включить рабочий режим» в «Песочнице и рабочем режиме» |
| После перехода API отвечает 401 / «ключ не работает» | Ключи перегенерировались при переходе — часто; у партнёров тестовые организации удалены by design | Взять новый ключ в Настройках → «Подключения», перезабить Webhook URL и секрет | «Когда ключи „внезапно“ перестают работать» в «API-ключе и вебхук-секрете» |
| Переключатель режима «заблокировался», туда-сюда не щёлкает | Защита от частых переключений (тумблер-блок) — часто у активно тестирующих | Решение ниже — у этой ветки нет своей статьи | — |
| Оплатили тариф, а кабинет всё ещё «тестовый» / тариф не виден | Оплата ушла с другого профиля, или ожидание «режим включится сам» — редко | Проверить профиль оплаты (личный номер входа!) и включить режим вручную | Вход в кабинет ApiPay |
Тумблер-блок: что делать, если переключатель «залип»
Если много раз подряд переключать «тестовый ↔ рабочий», система временно блокирует переключатель — это защита, а не поломка.
- Напишите в поддержку — счётчик переключений сбросят быстро.
- Постоянно тестируете? Заведите вторую организацию как песочницу: боевых организаций может быть сколько угодно (каждая — свой тариф), а песочница бесплатна и не ограничена по времени. Тогда боевую организацию вообще не придётся переключать.
«Пожалуйста, повторите позднее» — важный маркер
Эта фраза на стороне Kaspi — почти всегда признак того, что счёт создан в песочнице и в Kaspi не существует. Проверьте у счёта is_sandbox: true и префикс SANDBOX- в kaspi_invoice_id. Для QR-счетов та же фраза чаще означает истёкший QR — см. «QR: „Попробуйте позже“».
Для вашего ИИ-агента
После перехода в прод проверяйте: is_sandbox у новых счетов (должно быть false), префикс kaspi_invoice_id (боевые без SANDBOX-), ответ 401 = ключ невалиден (перегенерирован — возьмите новый), вебхук-секрет тоже новый.
Частые вопросы
Покупатель видит «Пожалуйста, повторите позднее» — что это?
Чаще всего счёт создан в тестовом режиме и в Kaspi не существует. Включите «Рабочий режим» и выставьте счёт заново. Для QR та же фраза обычно означает истёкший QR (он живёт ~5 минут).
Почему после включения прода «пропали» мои ключи?
Ключи перегенерируются при переходе; у партнёров тестовые организации удаляются целиком («чистый старт»). Возьмите новый ключ в Настройках и перезабейте вебхук — старые значения не вернутся.
Оплатил тариф — режим переключится сам?
Нет, автоматически режим не переключается: включите «Рабочий режим» в Настройках. Если тариф после оплаты не виден — проверьте, с того ли профиля платили.
Переключатель режима не работает — сломался?
Скорее всего сработала защита от частых переключений. Напишите в поддержку (сбросят счётчик) и заведите вторую организацию-песочницу для постоянных тестов.
Нужно ли после перехода перенастраивать вебхук?
Да, проверьте: Webhook URL и секрет могли перегенерироваться. Нажмите «Проверить уведомления» — тест должен дойти.