Қысқаша
Live-қа көшкеннен кейінгі мәселелердің дерлік бәрі бес себептің біреуі: кілт әлі test күйінде, кассир қосылмаған не байланысы үзілген, тариф белсенді емес не лимитке жеттіңіз, webhook адресі сырттан ашылмайды, режим шынымен live болып ауыспаған. Төмендегі бес қадамды ретімен өтіңіз — әдетте бесеуін тексеруге бес минут та кетпейді.
Қадам 1. Кілт live ме
Ең жиі себебі. qp_test_ кілті нақты счёт жасай алмайды.
- Қайдан қарайсыз: кабинет → Интеграциялар → API кілттер. Тізімде әр кілттің префиксі көрінеді
- Не болуы керек: сіздің серверіңіз қолданып жүрген кілт
qp_live_префиксімен - Не істейсіз: live кілт жоқ болса, жаңасын жасайсыз. Кілт бір рет қана толық көрсетіледі, сол сәтте көшіріп алыңыз. Содан кейін серверіңіздегі орта айнымалысын жаңартып, қызметті қайта іске қосасыз
Тексеру амалы: серверде қандай кілт тұрғанын логтан немесе env-тен қараңыз, бірақ кілттің өзін логқа толық жазбаңыз — префиксі мен соңғы төрт таңбасы жеткілікті.
Сіз кілтті жаңарттыңыз деп ойласаңыз да, қызмет қайта іске қосылмаған болса, ол ескі кілтпен жұмыс істеп тұрған болуы мүмкін. Бұл өте жиі кездеседі.
Белгілері: API 401 қайтарады — API 401 қайтарады.
Қадам 2. Кассир белсенді ме
Sandbox-та кассир керек емес еді, сондықтан оны қоспай қалу оңай.
- Қайдан қарайсыз: Kaspi бөлімі
- Не болуы керек: кемінде бір карточка белсенді, қасында «Себебі» деген жол жоқ
- Не істейсіз:
- Карточка мүлде жоқ болса — кассир қосасыз: Kaspi кассирін қалай қосу керек
- Карточка белсенді емес болса — нөмірді енгізіп, SMS кодымен қайта байланыстырасыз. Бір минут алады
- Кілтіңіз нақты кассирге байланған болса, дәл сол кассирдің белсенді екенін тексеріңіз: байланған кілт басқа кассирге ауыспайды
Байланыс үзілуінің ең жиі себебі — кассир нөмірімен біреу Kaspi Pay қосымшасына кіріп кеткен. Kaspi бір нөмірге бір ғана белсенді құрылғыға рұқсат береді.
Қадам 3. Тариф пен лимит
- Қайдан қарайсыз: кабинет → Тариф
- Не болуы керек: тариф белсенді, айлық лимитке жетпегенсіз
- Не істейсіз:
- Тариф белсенді емес болса — төлейсіз немесе қолдауға жазасыз
- Лимитке жеткен болсаңыз — тарифті жоғарылатасыз
Екі бөлек қатені шатастырмаңыз:
| Қате | Мағынасы | Не істеу керек |
|---|---|---|
tariff_limit_reached | Айлық счёт лимиті бітті | Тарифті жоғарылату немесе келесі айды күту |
tariff_daily_burst | Тәуліктік қорғаныс іске қосылды | Кодты тексеру: бір жерде цикл болуы мүмкін |
tariff_inactive немесе 403 | Тариф белсенді емес | Тариф бөлімінен төлеу |
Тәуліктік сан — бизнес лимиті емес, циклге түскен интеграциядан қорғаныс. Толығырақ: Лимитке жеттім.
Қадам 4. Webhook адресі сырттан ашыла ма
Счёт жасалып тұрса, бірақ төлем туралы хабар өз жүйеңізге келмесе — мәселе осында.
- Қайдан қарайсыз: кабинет → Интеграциялар → webhook журналы. Онда әр жіберудің жауабы жазылады
- Не болуы керек: адресіңіз
https://және нақты домен, сырттан авторизациясыз ашылады, 2xx қайтарады - Не істейсіз: адресті сырттағы құрылғыдан (мысалы, мобильді интернеттен) ашып көріңіз
Жиі кездесетін себептер:
- Адрес локалды немесе туннель арқылы: продакшенде IP-адрес пен уақытша туннель қабылданбайды
- Адрес авторизациямен жабық: біз кіре алмаймыз, 401/403 аламыз
- Адрес басқа жерге қайта бағыттайды: 307/308 тек сол адрестің өзіне (http→https, қиғаш сызық) ұсталады, басқа доменге апаратын қайта бағыттау ұсталмайды
- Сіздің жағыңыз 2xx емес қайтарады: онда жіберу 11 рет қайталанады, 10 секундтан 1 сағатқа дейін өсіп
Егер қолтаңба сәйкес келмей жатса — денені өзгертілмеген байт күйінде тексеріп жатқаныңызды қарап шығыңыз: Webhook қолтаңбасы сәйкес келмейді.
Қадам 5. Режим шынымен live па
Соңғы, ең қарапайым тексеру. Кейде ауыстырғыш басылмай қалады немесе басқа ұйымда ауыстырылады.
- Қайдан қарайсыз: кабинет → Баптау → режим ауыстырғышы
- Не болуы керек: Нақты (live) күйінде
- Қосымша тексеру: кабинеттің жоғарғы жағында қай ұйымда тұрғаныңызға қараңыз. Бірнеше ұйымыңыз болса, режимді басқа ұйымда ауыстырып қойған болуыңыз мүмкін
Белгісі: счёттар жасалып жатыр, қате жоқ, бірақ клиент QR-ды сканерлегенде нақты төлем бетін көрмейді, ал кабинеттегі счёт test деп белгіленген.
Бәрі дұрыс, бірақ әлі істемей жатыр
Сол бес қадам таза болса, мәселе Kaspi жағында болуы мүмкін:
- Қызмет күйін тексеріңіз
- Сол сәтте Kaspi қосымшасының өзі қалыпты жұмыс істеп тұрғанын қараңыз
- Екі минуттық диагностика: Мәселе менде ме, Kaspi-де ме
Одан кейін де шешілмесе, қолдауға жазыңыз. Жазғанда мыналарды қоса жіберіңіз: счёттың идентификаторы, шамамен қай уақытта болғаны, қате мәтіні, кілттің префиксі (толық кілтті емес).
Жиі қойылатын сұрақтар
Sandbox-та бәрі істеп тұрған, live-та неге бұзылды? Sandbox-та Kaspi мүлде қатыспайды және кассир керек емес. Live-та қосымша үш нәрсе пайда болады: кассир, тариф және нақты Kaspi жауабы. Бұзылу солардың біреуінен.
Кілтті ауыстырдым, бірақ әлі 401 келеді. Қызмет қайта іске қосылды ма? Ескі кілт жадта қалып қоюы мүмкін. Сондай-ақ тақырыптың аты дәл X-API-Key екенін тексеріңіз.
Счёт жасалады, бірақ paid күйіне ауыспайды. Poller әр 3 секунд сайын жүреді, жаңа счёт әр айналымда тексеріледі. Бір минуттан асып кетсе — кассир байланысын және клиенттің шынымен төлегенін тексеріңіз.
Live-қа көшкенде ескі test счёттарым не болады? Тізімде қалады, бірақ олар нақты счёт емес және айлық лимитке кірмейді.
Қайта sandbox-қа қайтып, сынауға бола ма? Иә. Режимді кері ауыстырып, qp_test_ кілтімен сынай беріңіз. Бірақ басталған сынақ мерзімі тоқтамайды.