Қысқаша
Ең жиі кездесетін себеп — тест режимі қосулы қалып қойған. Sandbox-та нақты Kaspi шақырылмайды: счёт бізде жасалады, күйі де өзгереді, бірақ клиенттің телефонына ештеңе бармайды және ақша жүрмейді. Ең алдымен кілттің басын қараңыз: qp_test_ болса, сіз sandbox-тасыз. Live кілт — qp_live_. Егер режим дұрыс болса, төмендегі ретпен алты нәрсені тексеріңіз.
Симптом бойынша
| Не көріп тұрсыз | Ықтимал себебі | Не істеу керек |
|---|---|---|
| Счёт жасалады, клиентке ештеңе келмейді | Тест режимі | Кілттің басын және кабинеттегі режимді тексеріңіз |
| API счёт жасамай, қате қайтарады | Кассир байланысы жоқ немесе үзілген | Кабинет → Kaspi → байланысты қалпына келтіріңіз |
tariff_inactive қатесі | Сынақ мерзімі бітті немесе тариф төленбеген | Кабинет → Тариф |
invalid_phone қатесі | Нөмір пішімі қате | 7XXXXXXXXXX, 11 сан, бос орынсыз |
| Push кетті, клиент көрмейді | Клиентте Kaspi қосымшасы жоқ немесе басқа нөмірде | QR немесе төлем сілтемесін беріңіз |
| QR ашылады, бірақ «кейінірек көріңіз» дейді | Сканерлеу терезесі өтіп кеткен | QR «кейінірек көріңіз» деп тұр |
Тексеру реті
1. Режим. Кабинетте қай режим қосулы тұрғанын қараңыз. Sandbox-та Kaspi мүлде қатыспайды: клиентке push бармайды, QR нақты төлемді қабылдамайды, ақша жүрмейді. Бұл қате емес, sandbox солай жұмыс істеуі керек — тек сіз оны жабуды ұмытып кеткенсіз.
Белгісі: счёттар сәтті жасалып тұр, күйлері де өзгеріп жатыр, бірақ Kaspi шотыңызға ешқандай ақша түспейді, ал клиенттер «ештеңе келмеді» дейді.
2. Кілт. Кодыңыз қай кілтті жіберіп тұр? Кілттің басы бәрін айтады:
| Кілт | Режим | Не болады |
|---|---|---|
qp_test_… | Sandbox | Нақты ақша жүрмейді, Kaspi шақырылмайды, төлемді өзіңіз симуляциялайсыз |
qp_live_… | Live | Нақты Kaspi QR, нақты ақша |
Жиі кездесетін жағдай: кабинетте режим live-қа ауыстырылған, ал серверде ортаның айнымалысында әлі сынақ кілті тұр. Немесе керісінше — өнімдік серверде бәрі дұрыс, ал сынақ стендінің кілтімен жұмыс істеп жатырсыз. Кілтті кодтың өзінен емес, серверде нақты орындалып жатқан мәнінен тексеріңіз.
3. Кассир белсенді ме? Live режимде счёт Kaspi-дегі «Кассир» рөлі арқылы шығады. Байланыс үзілген болса, счёт мүлде жасалмайды. Кабинет → Kaspi бөлімінде байланыс картасы белсенді тұр ма, қараңыз.
Ең жиі кездесетін себеп: кассир нөмірімен біреу Kaspi Pay қосымшасына кірген — Kaspi бір нөмірге бір ғана белсенді құрылғыға рұқсат береді, сондықтан біздің сессия үзіледі.
4. Клиент нөмірінің пішімі. phone түріндегі счёт клиенттің Kaspi қосымшасына push жібереді, сондықтан customer.phone дұрыс болуы керек: 7XXXXXXXXXX — 11 сан, +, бос орын, жақша, сызықшасыз. 8 цифрынан басталатын нөмірді өзіңіз 7-ге түрлендіріңіз.
Тағы бір жиі кездесетіні: нөмір техникалық тұрғыда дұрыс, бірақ клиенттің Kaspi-і басқа нөмірге тіркелген. Мұны біз тексере алмаймыз — клиенттен Kaspi-дегі нөмірін сұраңыз.
5. Клиентте Kaspi қосымшасы бар ма? Телефонға счёт тек Kaspi қосымшасы орнатылған және сол нөмірге тіркелген клиентке ғана жетеді. Қосымшасы жоқ адамға push та, счёт та келмейді. Мұндай жағдайда qr түріндегі счёт жасап, QR-ды немесе төлем сілтемесін беріңіз.
6. Тариф белсенді ме? Сынақ мерзімі бітіп, тариф төленбесе, API tariff_inactive қайтарады да, жаңа счёттар жасалмайды. Кабинет → Тариф бөлімінде күйін көресіз. Сынақ мерзімі 7 күн және ол тіркелген күннен емес, бірінші нақты счёттан басталады.
Екі минутта қалай ажырату керек
Мәселе бізде ме, Kaspi-де ме, әлде кодыңызда ма — реті қарапайым:
- Кабинеттен қолмен счёт жасап көріңіз. Жасалмаса — мәселе кодта емес, байланыста немесе тарифте.
- Кабинеттен жасалған счёт клиентке жетті ме? Жетсе — кодыңыз басқа кілтпен немесе басқа режимде жұмыс істеп тұр.
- Счёттар тізімінде жаңа счёт бар ма? Болмаса — сұрауыңыз бізге мүлде жетпеген.
Жиі жіберілетін қателер
- Кабинетте режимді ауыстырып, кодтағы кілтті ауыстырмау. Екеуін бірге жасау керек.
- Тиынмен сома жіберу. Телефонға счёт бүтін теңгемен ғана жүреді.
- Клиенттің нөмірін формадан тазаламай алу.
+7 (777) 123-45-67түріндегі мәтін қабылданбайды. - Счёт жасалғанын webhook келмегеніне қарап бағалау. Бұл екі бөлек мәселе: Webhook келмей жатыр.
Жиі қойылатын сұрақтар
Sandbox-та клиентке нақты хабарлама келе ме? Жоқ. Sandbox Kaspi-ге мүлде жүгінбейді, ол тек сіздің кодыңызды сынауға арналған.
Sandbox-та жасалған счёттар тарифтің лимитіне кіре ме? Жоқ, sandbox счёттары айлық лимитке есептелмейді және сынақ мерзімін де бастамайды.
Кассир нөмірімен клиенттің нөмірі бір бола ала ма? Жоқ, бұл екі бөлек нөмір. Оның үстіне кассир нөмірімен Kaspi Pay қосымшасына кірмеу керек — байланыс үзіледі.
Клиентке счёт қайта жіберуге бола ма? Ескісін болдырмай, жаңа счёт жасаңыз. Сол сомамен жаңа push кетеді.
Клиент «нөмірімді білмейсіңдер ме» деп сұрайды. Счёт туралы хабарламада кассир нөмірі көрінеді — бұл Kaspi-дің қалыпты жұмысы, сіздің баптауыңызға байланысты емес.