Коротко
Ошибка organization_inactive (HTTP 410) не означает, что ключ недействителен. Она означает: «ключ верный, мы даже видим, какой организации он принадлежит, но сама организация неактивна». Поэтому создание нового ключа не помогает: новый ключ будет принадлежать той же архивной организации, и ошибка повторится слово в слово. Нужен ключ работающей организации либо возврат организации в активное состояние.
Как распознать эту ошибку
{ "error": "organization_inactive", "message": "..." }HTTP-статус — 410. Это важный признак: он отличается и от 401, и от 403.
| Ошибка | HTTP | Где проблема |
|---|---|---|
unauthorized | 401 | В самом ключе: нет, записан неверно или удалён |
invalid_api_key | 422 | В формате ключа |
forbidden | 403 | Ресурс принадлежит другой организации |
insufficient_scope | 403 | У ключа нет права на это действие |
tariff_inactive | 403 | Тариф неактивен или закончился пробный период |
organization_inactive | 410 | Сама организация в архиве или удалена |
Если вы видите 401, эта статья не про вас: API отвечает 401.
Почему новый ключ не помогает
Ключ всегда создаётся внутри конкретной организации. Это не ключ от подъезда, а ключ от определённой комнаты. Если комната закрыта, делать новый ключ от неё бессмысленно.
Поэтому эти действия результата не дадут:
- Создать новый ключ
- Переключиться между
qp_test_…иqp_live_… - Привязать ключ к другому кассиру или снять привязку
- Оплатить тариф (активность тарифа и активность организации — разные вещи)
- Сменить адрес webhook
Работают только два пути: использовать ключ нужной организации или вернуть организацию в активное состояние.
Причины
1. Организацию убрали в архив в кабинете. Если вы ведёте несколько организаций, старую могли заархивировать и перейти на новую, а на сервере остался ключ от старой. Самая частая причина.
2. Ключ взят от другой организации. В тестовом контуре и в проде могли использоваться разные организации, и одну из них заархивировали.
3. Аккаунт ограничен по правилам сервиса. В этом случае поддержка вас уведомляет.
4. Организацию закрыли по запросу. Кто-то попросил закрыть её, а потом тот же ключ снова пошёл в работу.
Стоит различать: account_blocked (403) — это отдельная ошибка про блокировку аккаунта. organization_inactive — про конкретную организацию.
Что делать
- Посмотрите, в какой организации вы находитесь. Зайдите в кабинет и проверьте переключатель организаций. Если их несколько, сразу видно, какая активна: Несколько организаций в одном аккаунте.
- Возьмите ключ работающей организации. Выберите нужную организацию и создайте ключ в разделе Интеграции. Права и привязку к кассиру повторите как у старого.
- Замените его на сервере. В
.envили хранилище секретов, в плагине CMS, в сценариях автоматизации — везде. - Сделайте проверочный запрос.
GET /api/v1/statusили небольшой счёт в песочнице. - Если нужна именно та организация — напишите в поддержку. В части случаев её можно вернуть в активное состояние.
Помните: при смене организации привязка кассира и настройки вебхуков тоже будут свои, внутри новой организации. Настройки одной организации не переносятся в другую.
Что написать в поддержку
Чтобы вопрос решился быстро, сразу укажите:
- Название организации — так, как оно видно в кабинете
- Точное время ошибки, с часами и минутами
- Полный текст ошибки: код
errorиmessage - Только первые несколько символов ключа — например
qp_live_ab… - При каком действии она возникает (создание счёта, запрос статуса, возврат)
- Вы архивировали эту организацию намеренно или ошибка появилась неожиданно
Полное значение ключа не присылайте никогда. Если вы написали его в чат, считайте, что ключ утёк: API-ключ утёк.
Контакты: WhatsApp +7 778 881 3333, Telegram @qutpaybot, email kazprose@gmail.com.
Что происходит со счетами и деньгами
| Что | Состояние |
|---|---|
| Ранее созданные счета | Не пропадают |
| Ранее полученные деньги | На вашем счёте Kaspi, не затронуты |
| Создание новых счетов | Не работает, приходит 410 |
| Возвраты | Не работают |
| Другая ваша активная организация | Не затронута, работает сама по себе |
Организация в архиве — это не удаление данных. Закрыта только возможность совершать новые операции от её имени.
Вопросы и ответы
Могу ли я сам вернуть организацию из архива? Если такой возможности в кабинете нет, напишите в поддержку.
Если оплатить тариф, ошибка уйдёт? Нет. Неактивный тариф даёт другую ошибку (tariff_inactive, 403). К organization_inactive тариф отношения не имеет.
У меня две организации, одна работает. Достаточно сменить ключ? Да, если в новой организации подключён кассир и активен тариф. Учтите, что счета при смене организации не переезжают.
Как посмотреть счета старой организации? Спросите у поддержки про доступ к просмотру из кабинета. По API запросы к архивной организации не проходят.
Нужно ли заново подключать кассира? Если вы переходите на новую организацию — да: у каждой организации свой кассир. Учтите также, что организация Kaspi фиксируется при первой привязке: Кассир принадлежит другой организации Kaspi.