Қысқаша
Ең жиі кездесетін белгі: счёттар жасалып жатыр, қате жоқ, бірақ клиентке ештеңе келмейді және ақша түспейді. Бұл дерлік әрқашан sandbox режимі. Sandbox-та Kaspi мүлде шақырылмайды: счёт бізде жасалады, QR көрінеді, ал ол нақты төлем емес.
Тексерудің ең жылдам жолы — кілттің префиксі. qp_test_… — sandbox, qp_live_… — нақты режим. Көшу үшін кабинеттен режимді ауыстырып, интеграциядағы кілтті live кілтіне алмастыру керек — екеуі де қажет.
Симптом → себеп → шешім
| Симптом | Себебі | Шешімі |
|---|---|---|
| Счёт жасалады, клиентке келмейді | Sandbox режимі | Live-қа көшіп, кілтті ауыстырыңыз |
| Клиент «төледім» дейді, ақша жоқ | Тест счёты симуляцияланған | Live кілтпен жаңа счёт жасаңыз |
| Кабинетте счёттар бар, Kaspi-де жоқ | Kaspi шақырылмаған | Режимді тексеріңіз |
| Кабинет live, ал счёттар бәрібір тест | Интеграцияда ескі qp_test_ кілт қалған | Кілтті ауыстырыңыз |
| Лимит есебі өспей тұр | Sandbox счёттары лимитке кірмейді | Бұл қалыпты, режимді тексеріңіз |
| Сынақ мерзімі басталмай тұр | Сынақ бірінші live счёттан басталады | Live счёт жасаңыз |
Қалай тексеру керек
Үш тәуелсіз белгі бар, үшеуін де қараған дұрыс.
1. Кілттің префиксі. Интеграция нақты қай кілтпен жұмыс істеп тұр? qp_test_ — sandbox. Бұл ең сенімді белгі, себебі ол интеграцияның өзінде тұр.
2. Кабинеттегі белгі. Sandbox қосулы кезде кабинетте тест режимінің белгісі көрінеді, счёттар тізімінде де тест счёттары ажыратылып тұрады.
3. Kaspi байланысы бар ма. Sandbox үшін Kaspi кассирі мүлде керек емес. Егер сізде бірде-бір қосылған кассир болмаса, ал счёттар жасалып жатса — бұл сөзсіз sandbox.
Екі жақты да ауыстыру керек
Бұл жерде ең жиі кездесетін қате: адам кабинеттен режимді live-қа ауыстырады да, интеграциядағы ескі qp_test_… кілтті қалдырып кетеді. Нәтижесінде бәрі бұрынғыдай: счёттар жасалады, клиентке келмейді.
| Не | Қайдан ауыстырылады |
|---|---|
| Режим | Кабинеттен |
| Кілт | Интеграцияның баптауынан немесе айнымалысынан |
Көшу реті:
- Kaspi кассирі қосулы ма, тексеріңіз. Live режимде ол міндетті.
- Кабинеттен режимді нақтыға ауыстырыңыз.
- Live кілт жасаңыз және оған керекті scope-тарды беріңіз.
- Интеграциядағы кілтті ауыстырыңыз — сервердегі айнымалыда, плагиннің баптауында, CRM-де, барлық жерде.
- Қызметті қайта іске қосыңыз. Ескі кілт жадта қалып қоймауы үшін.
- Ең кіші сомамен бір нақты счёт жасап, өзіңіз төлеп көріңіз. Ақша Kaspi шотыңызға түсті ме, webhook келді ме — екеуін де тексеріңіз.
- Ескі тест кілттерін жойыңыз, әйтпесе біреу оларды қайта қойып жіберуі мүмкін.
Толық чек-парақ: Нақты режимге қалай көшу керек. Көшкен соң істемей қалса: Нақты режимге көштім, бірақ істемей жатыр.
Тест счёттарына не болады
| Сұрақ | Жауап |
|---|---|
| Тест счёттары нақты режимге көше ме | Жоқ. Олар sandbox-та қалады |
| Лимитке кіре ме | Жоқ. Sandbox счёттары айлық лимитке де, тәуліктік қорғанысқа да кірмейді |
| Сынақ мерзімін бастай ма | Жоқ. Сынақ бірінші live счёттан басталады |
| Ақша қозғала ма | Жоқ. Kaspi мүлде шақырылмайды |
| Оларды жою керек пе | Қажет емес. Олар live есептеріне араласпайды |
| Webhook келе ме | Иә, sandbox-та да келеді — интеграцияны сынау үшін |
Яғни sandbox-та қаншама счёт жасасаңыз да, ол сізге ештеңеге тұрмайды және сынақ мерзіміңізді жеп қоймайды. Бұл әдейі солай: интеграцияны еркін сынау үшін.
Қайталанбауы үшін
- Кілттерді орта бойынша бөліңіз. Тест ортасында тек
qp_test_, өндірісте текqp_live_. Бір файлда екеуі қатар тұрмасын. - Кілтті кодқа жазбаңыз, ортаның айнымалысынан алыңыз.
- Іске қосылғанда тексеріңіз. Қызмет басталғанда кілттің префиксін оқып, күтілген ортаға сәйкес келмесе, ескерту жазыңыз немесе тіпті іске қосылмасын.
- Мониторингке қосыңыз. Тәулігіне бір де бір live счёт болмаса, бұл да белгі.
Кілттерді сақтау мен ауыстыру: API кілттер.
Жиі қойылатын сұрақтар
Sandbox-та жасалған счётты нақтыға айналдыруға бола ма? Жоқ. Live режимде жаңа счёт жасайсыз.
Клиент тест счётын төлеп қойды дейді. Ақша қайда? Ешқайда кетпеген. Sandbox-та Kaspi шақырылмайды, сондықтан клиент нақты ақша аудара алмайды. Ол «төледім» дегенде басқа нәрсені айтып тұрған болуы мүмкін — есеп-шотты тексеріңіз.
Sandbox-та Kaspi кассирі керек пе? Жоқ. Кассирсіз-ақ счёт жасай, симуляциялай, webhook сынай аласыз.
Live кілтті sandbox-та пайдалануға бола ма? Жоқ, бұл қате немесе күтпеген мінез береді. Әр режимнің өз кілті.
Режимді кері қайтаруға бола ма? Иә, кабинеттен қайта sandbox-қа ауысуға болады. Бірақ сол сәтте интеграцияны да тест кілтіне қайтару керек.
Ақша түспей жатқанының басқа себебі болуы мүмкін бе? Иә, бірақ сирек. Тест режимін жоққа шығарған соң қалған себептер бөлек қаралған: Клиентке төлем келмей жатыр.