# «Ұйым архивте» деген қате — не істеу керек

> 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/api-401).

## Неге жаңа кілт көмектеспейді

Кілт әрқашан бір ұйымның ішінде жасалады. Ол — есік кілті емес, белгілі бір бөлменің кілті. Бөлме жабық тұрса, оның жаңа кілтін жасаудың мәні жоқ.

Сондықтан мына әрекеттер нәтиже бермейді:

- Жаңа кілт жасау
- Кілтті `qp_test_…` мен `qp_live_…` арасында ауыстыру
- Кілтті басқа кассирге байлау немесе байлауды алып тастау
- Тарифті төлеу (тариф пен ұйымның белсенділігі — екі басқа нәрсе)
- Webhook адресін ауыстыру

Нәтиже беретіні екеу ғана: **дұрыс ұйымның кілтін қолдану** немесе **ұйымды қайта белсенді ету**.

## Себептері

**1. Ұйым кабинетте архивке салынған.** Бірнеше ұйым жүргізсеңіз, ескісін архивке салып, жаңасымен жұмыс істеп жүрген боларсыз. Ал серверде ескі ұйымның кілті қалып қойған. Ең жиі кездесетін себеп.

**2. Кілт басқа ұйымнан алынған.** Тест ортасы мен продакшенде әртүрлі ұйым қолданылып, бірі архивке салынған болуы мүмкін.

**3. Аккаунт тәртібі бойынша шектелген.** Бұл жағдайда қолдау сізге хабарлайды.

**4. Ұйым сұрау бойынша жабылған.** Біреу ұйымды жабуды сұраған да, кейін сол кілт қайтадан қолданылған.

Айырып қарау керек: `account_blocked` (403) — аккаунт бөгелген деген бөлек қате. `organization_inactive` — нақты ұйым туралы.

## Не істеу керек

1. **Қай ұйымда тұрғаныңызды қараңыз.** Кабинетке кіріп, ұйым ауыстырғышын тексеріңіз. Бірнеше ұйым болса, қайсысы белсенді екені бірден көрінеді: [Бір аккаунтта бірнеше ұйым](/kb/multiple-organizations).
2. **Жұмыс істеп тұрған ұйымның кілтін алыңыз.** Дұрыс ұйымды таңдап, **Интеграциялар** бөлімінен жаңа кілт жасаңыз. Оның scope-тары мен кассирге байлануы ескісіндей болсын.
3. **Серверде ауыстырыңыз.** `.env` немесе құпиялар қоймасы, CMS плагині, автоматтандыру сценарийлері — бәрінде.
4. **Бір сынақ сұрау жіберіңіз.** `GET /api/v1/status` немесе кішкене sandbox счёты.
5. **Дәл сол ұйым керек болса, қолдауға жазыңыз.** Кейбір жағдайда ұйымды қайта белсенді етуге болады.

Есіңізде болсын: ұйым ауысса, кассир байланысы мен webhook баптаулары да сол жаңа ұйымның ішінде жеке болады. Бір ұйымның баптауы екіншісіне көшпейді.

## Қолдауға нені жазу керек

Тез шешілуі үшін мыналарды бірден жазыңыз:

- Ұйымның атауы (кабинетте көрінетіндей)
- Қате шыққан нақты уақыт, сағат-минутымен
- Қате толық мәтіні: `error` коды мен `message`
- Кілттің **алғашқы бірнеше таңбасы ғана** — мысалы `qp_live_ab…`
- Қандай әрекет жасағанда шыққаны (счёт жасау, күйді сұрау, қайтару)
- Сол ұйымды әдейі архивке салдыңыз ба, әлде күтпеген жерден шықты ма

**Кілттің толық мәнін ешқашан жібермеңіз.** Оны чатқа жазсаңыз, кілт шығып кетті деп есептеу керек: [API кілт сыртқа шығып кетті](/kb/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/kaspi-org-mismatch).