Қысқаша
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 — нақты ұйым туралы.
Не істеу керек
- Қай ұйымда тұрғаныңызды қараңыз. Кабинетке кіріп, ұйым ауыстырғышын тексеріңіз. Бірнеше ұйым болса, қайсысы белсенді екені бірден көрінеді: Бір аккаунтта бірнеше ұйым.
- Жұмыс істеп тұрған ұйымның кілтін алыңыз. Дұрыс ұйымды таңдап, Интеграциялар бөлімінен жаңа кілт жасаңыз. Оның scope-тары мен кассирге байлануы ескісіндей болсын.
- Серверде ауыстырыңыз.
.envнемесе құпиялар қоймасы, CMS плагині, автоматтандыру сценарийлері — бәрінде. - Бір сынақ сұрау жіберіңіз.
GET /api/v1/statusнемесе кішкене sandbox счёты. - Дәл сол ұйым керек болса, қолдауға жазыңыз. Кейбір жағдайда ұйымды қайта белсенді етуге болады.
Есіңізде болсын: ұйым ауысса, кассир байланысы мен webhook баптаулары да сол жаңа ұйымның ішінде жеке болады. Бір ұйымның баптауы екіншісіне көшпейді.
Қолдауға нені жазу керек
Тез шешілуі үшін мыналарды бірден жазыңыз:
- Ұйымның атауы (кабинетте көрінетіндей)
- Қате шыққан нақты уақыт, сағат-минутымен
- Қате толық мәтіні:
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 ұйымына тиесілі.