# Ошибка «организация в архиве» — что делать

> Если API отвечает organization_inactive (410), дело не в ключе, а в том, что организация неактивна. Новый ключ не поможет. Причины, как выбрать правильный ключ и что указать в обращении в поддержку.

## Коротко

Ошибка `organization_inactive` (HTTP 410) не означает, что ключ недействителен. Она означает: «ключ верный, мы даже видим, какой организации он принадлежит, но сама **организация неактивна**». Поэтому **создание нового ключа не помогает**: новый ключ будет принадлежать той же архивной организации, и ошибка повторится слово в слово. Нужен ключ работающей организации либо возврат организации в активное состояние.

## Как распознать эту ошибку

```json
{ "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](/kb/ru/api-401).

## Почему новый ключ не помогает

Ключ всегда создаётся внутри конкретной организации. Это не ключ от подъезда, а ключ от определённой комнаты. Если комната закрыта, делать новый ключ от неё бессмысленно.

Поэтому эти действия результата не дадут:

- Создать новый ключ
- Переключиться между `qp_test_…` и `qp_live_…`
- Привязать ключ к другому кассиру или снять привязку
- Оплатить тариф (активность тарифа и активность организации — разные вещи)
- Сменить адрес webhook

Работают только два пути: **использовать ключ нужной организации** или **вернуть организацию в активное состояние**.

## Причины

**1. Организацию убрали в архив в кабинете.** Если вы ведёте несколько организаций, старую могли заархивировать и перейти на новую, а на сервере остался ключ от старой. Самая частая причина.

**2. Ключ взят от другой организации.** В тестовом контуре и в проде могли использоваться разные организации, и одну из них заархивировали.

**3. Аккаунт ограничен по правилам сервиса.** В этом случае поддержка вас уведомляет.

**4. Организацию закрыли по запросу.** Кто-то попросил закрыть её, а потом тот же ключ снова пошёл в работу.

Стоит различать: `account_blocked` (403) — это отдельная ошибка про блокировку аккаунта. `organization_inactive` — про конкретную организацию.

## Что делать

1. **Посмотрите, в какой организации вы находитесь.** Зайдите в кабинет и проверьте переключатель организаций. Если их несколько, сразу видно, какая активна: [Несколько организаций в одном аккаунте](/kb/ru/multiple-organizations).
2. **Возьмите ключ работающей организации.** Выберите нужную организацию и создайте ключ в разделе **Интеграции**. Права и привязку к кассиру повторите как у старого.
3. **Замените его на сервере.** В `.env` или хранилище секретов, в плагине CMS, в сценариях автоматизации — везде.
4. **Сделайте проверочный запрос.** `GET /api/v1/status` или небольшой счёт в песочнице.
5. **Если нужна именно та организация — напишите в поддержку.** В части случаев её можно вернуть в активное состояние.

Помните: при смене организации привязка кассира и настройки вебхуков тоже будут свои, внутри новой организации. Настройки одной организации не переносятся в другую.

## Что написать в поддержку

Чтобы вопрос решился быстро, сразу укажите:

- Название организации — так, как оно видно в кабинете
- Точное время ошибки, с часами и минутами
- Полный текст ошибки: код `error` и `message`
- **Только первые несколько символов ключа** — например `qp_live_ab…`
- При каком действии она возникает (создание счёта, запрос статуса, возврат)
- Вы архивировали эту организацию намеренно или ошибка появилась неожиданно

**Полное значение ключа не присылайте никогда.** Если вы написали его в чат, считайте, что ключ утёк: [API-ключ утёк](/kb/ru/leaked-key).

Контакты: WhatsApp [+7 778 881 3333](https://wa.me/77788813333), Telegram [@qutpaybot](https://t.me/qutpaybot), email `kazprose@gmail.com`.

## Что происходит со счетами и деньгами

| Что | Состояние |
|---|---|
| Ранее созданные счета | Не пропадают |
| Ранее полученные деньги | На вашем счёте Kaspi, не затронуты |
| Создание новых счетов | Не работает, приходит 410 |
| Возвраты | Не работают |
| Другая ваша активная организация | Не затронута, работает сама по себе |

Организация в архиве — это не удаление данных. Закрыта только возможность совершать новые операции от её имени.

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

**Могу ли я сам вернуть организацию из архива?** Если такой возможности в кабинете нет, напишите в поддержку.

**Если оплатить тариф, ошибка уйдёт?** Нет. Неактивный тариф даёт другую ошибку (`tariff_inactive`, 403). К `organization_inactive` тариф отношения не имеет.

**У меня две организации, одна работает. Достаточно сменить ключ?** Да, если в новой организации подключён кассир и активен тариф. Учтите, что счета при смене организации не переезжают.

**Как посмотреть счета старой организации?** Спросите у поддержки про доступ к просмотру из кабинета. По API запросы к архивной организации не проходят.

**Нужно ли заново подключать кассира?** Если вы переходите на новую организацию — да: у каждой организации свой кассир. Учтите также, что организация Kaspi фиксируется при первой привязке: [Кассир принадлежит другой организации Kaspi](/kb/ru/kaspi-org-mismatch).