Қысқаша
Счёт paid күйінде тұрса, ал ақша көрінбесе, себебі үшеудің бірі. Біріншісі әрі ең жиісі — sandbox режимі: онда нақты ақша мүлде жүрмейді, счёт «төленді» болғанымен, транзакция болмаған. Екіншісі — қате жерден іздеу: ақша бізде ешқашан болмайды, ол тіке сіздің Kaspi Pay шотыңызға түседі, сондықтан тексеретін жер — Kaspi қосымшасы. Үшіншісі — кассир басқа Kaspi ұйымына тиесілі: ақша сол ұйымның шотына түскен.
Үшеуін ажырату бес минут алады.
1. Тест режимі қосулы ма
Ең жиі кездесетін жағдай, әрі ең жеңіл тексерілетіні. Кілтіңізге қараңыз:
| Кілт | Режим | Ақша |
|---|---|---|
qp_test_… | Sandbox | Жүрмейді. Kaspi мүлде шақырылмайды |
qp_live_… | Нақты | Жүреді, тіке Kaspi шотыңызға |
Sandbox-та бәрі нағыздай көрінеді: счёт жасалады, күйі өзгереді, webhook келеді, кабинетте счёт тұрады. Тек қана ақша қозғалмайды — өйткені Kaspi-ге ешқандай сұрау кетпеген. Sandbox-та төлемді сіз өзіңіз симуляциялайсыз, клиент те, банк те қатыспайды.
Сондықтан бірінші тексеретін нәрсе — кілттің префиксі. Ол qp_test_ болса, ары қарай іздеудің қажеті жоқ: жауап табылды.
Нақты режимге көшкенде кілтті де ауыстыру керек: режимді кабинеттен ауыстырып, кілтті сол күйі қалдырсаңыз, интеграцияңыз sandbox-та қала береді.
2. Ақшаны қайдан іздеу керек
Мұны нақты білген жөн: ақша ешқашан бізде болмайды. Qut Pay — сіздің өз Kaspi Pay аккаунтыңыз арқылы счёт шығаратын құрал. Клиент төлегенде ақша тіке сіздің Kaspi шотыңызға түседі, біздің жүйе арқылы өтпейді.
Демек, тексеретін жер — Kaspi Pay, біздің кабинет емес. Кабинет тек счёттың күйін көрсетеді.
Кестені былай оқыңыз:
| Қайда қарау керек | Не көресіз |
|---|---|
| Qut Pay кабинеті | Счёттың күйі: paid, pending, expired |
| Kaspi Pay қосымшасы / кабинеті | Транзакциялар және шоттағы қалдық |
Kaspi Pay-де транзакция бар, ал сіздің жүйеңізде тапсырыс жабылмаған болса — мәселе webhook жағында, ақшада емес. Транзакция мүлде жоқ болса, келесі бөлімге өтіңіз.
Ақшаның қашан және қандай түрде түсетінін Kaspi өзі анықтайды: біз ол мерзімге де, Kaspi-дің өз шарттарына да әсер ете алмаймыз.
3. Кассир басқа ұйымға тиесілі
Kaspi ұйымы бірінші байланыс кезінде бекітіледі. Егер қосылған кассир басқа заңды тұлғаның (басқа ЖК немесе ЖШС) Kaspi Pay аккаунтындағы қызметкер болса, ақша сол ұйымның шотына түседі — сіздікіне емес.
Бұл әсіресе мына жағдайларда кездеседі:
- Кассир нөмірін таныс адамнан немесе бұрынғы серіктестен алған
- Бір адамға бірнеше бизнес тіркелген, қай ұйым екені шатасқан
- Бухгалтер екінші ұйымның қызметкерін қосып жіберген
Тексеру: кабинеттегі Kaspi бөлімінде байланыс картасында қай ұйым көрсетіліп тұрғанын қараңыз. Сол ұйым Kaspi Pay қосымшасында өзіңіз көріп отырған ұйыммен бір ме? Екеуі бөлек болса, дұрыс ұйымның кассирін қосу керек.
Бірнеше кассирмен жұмыс істеу туралы: Бір ұйымға бірнеше кассир.
Тексеру реті
- Кілттің префиксін қараңыз.
qp_test_болса — sandbox, ақша жүрмеген. Аяқталды. - Kaspi Pay-ді ашыңыз. Транзакция бар ма? Болса, ақша орнында, мәселе сіздің жүйеңіздің есебінде.
- Сома мен уақытты салыстырыңыз. Kaspi-дегі транзакция мен кабинеттегі счёт бір-біріне сәйкес пе?
- Байланыс картасындағы ұйымды тексеріңіз. Ол сіздің ұйымыңыз ба?
- Счёттың толық тарихын қараңыз.
GET /api/v1/invoices/{id}оқиғалары мен қайтаруларын қоса береді — қайтару жасалып кетпеген бе?
Ештеңе шешілмесе, екі минуттық жалпы диагностикадан өтіңіз: Мәселе менде ме, Kaspi-де ме.
Тағы екі жағдай
Қайтару жасалып кеткен. Счёт refunded немесе partially_refunded күйінде тұрса, ақша клиентке қайтарылған. Мұны кодтағы қате де жасауы мүмкін — қайтару логикасын тексеріңіз.
Ақша кешігіп келген. Счёт cancelled немесе expired болып жабылған, ал ақша кейін түскен. Ондайда invoice.paid оқиғасы late: true белгісімен келеді: Кеш келген төлем.
Не істемеу керек
- Клиенттен қайта төлеуді сұрамаңыз, алдымен Kaspi Pay-ді тексермей тұрып. Екі рет төлем алу — қайтарумен аяқталатын артық жұмыс.
- Счётты қайта жасамаңыз. Егер ақша келген болса, екінші счёт тек шатастырады.
- Kaspi қолдауына бірден жазбаңыз. Алдымен режимді тексеріңіз: жағдайлардың басым бөлігі сонымен бітеді.
Қолдауға не жинау керек
- Счёттың
id-і жәнеexternalOrderIdмәні - Төлемнің шамамен қай уақытта болғаны
- Кілттің префиксі:
qp_test_пе,qp_live_пе - Kaspi Pay-де сол сомадағы транзакция бар ма, жоқ па
- Кабинеттегі Kaspi бөлімінде көрсетілген ұйым атауы
Байланыс: WhatsApp +7 778 881 3333, Telegram @qutpaybot, kazprose@gmail.com.
Жиі қойылатын сұрақтар
Ақшаны сіздер ұстап тұрасыздар ма? Жоқ. Ақша біздің жүйе арқылы мүлде өтпейді, тіке Kaspi шотыңызға түседі. Біз транзакциядан пайыз да алмаймыз — қызмет ақысы айлық жазылым түрінде.
Sandbox-та жасаған счёттарым ақшаға айнала ма? Жоқ. Sandbox счёттары нақты режимге көшірілмейді, олар тек сынау үшін.
Kaspi шотында ақша бар, ал кабинетте счёт pending тұр. Бұл кеш өңдеу болуы мүмкін. Біраз күтіп, счёттың күйін қайта оқыңыз.
Kaspi өз комиссиясын алады ма? Kaspi өз шарттарын өзі анықтайды, оны Kaspi Pay аккаунтыңыздан көресіз. Біз ол туралы Kaspi атынан айта алмаймыз.
Ақша қай шотқа түсетінін өзгертуге бола ма? Ол сіздің Kaspi Pay аккаунтыңыздың баптауы, бізде емес. Qut Pay қай шотқа түсетінін таңдамайды. Толығырақ: Qut Pay деген не.