Қысқаша
Тікелей эфирде уақыт жоқ: клиент комментарийде «аламын» деп жазады, сіз бірнеше секундта счёт шығаруыңыз керек. Ең ыңғайлы жол — телефон нөмірі бойынша счёт (kind: "phone"): клиенттің Kaspi қосымшасына push келеді, ол ештеңе сканерлемейді, эфирден шықпайды. Счётты Telegram боттың /invoice командасымен телефоннан шығарасыз немесе көмекшіңіз кабинеттен жасайды. Экранда QR көрсету — қосымша нұсқа, негізгісі емес.
Эфир кезіндегі жұмыс реті
| Қадам | Кім | Не істейді |
|---|---|---|
| 1 | Клиент | Комментарийде «аламын», сосын директке нөмірін жібереді |
| 2 | Көмекші | Нөмірді алып, /invoice арқылы счёт шығарады |
| 3 | Клиент | Kaspi-де push-ты растайды |
| 4 | Бот | «Төленді» деп жазады |
| 5 | Көмекші | Тізімге белгілеп, тапсырысты жинайды |
Сіз эфирді жүргізе бересіз. Счёт шығару мен бақылауды көмекші істейді — эфирде екеуін бір адам істеу мүмкін емес.
Қандай API әдісі қолданылады
Кодсыз істесеңіз API қажет емес. Ішкі схемасы мынау: POST /api/v1/invoices, kind: "phone", customer.phone — 7XXXXXXXXXX пішімінде.
Телефонға счёттың ерекшелігі:
- Сома бүтін теңге болуы керек, тиын жүрмейді
- Сипаттама 60 таңбаға дейін
customer.phoneміндетті
QR счёт үшін (kind: "qr") нөмір керек емес, сипаттама 100 таңба, сома екі ондыққа дейін болады. Жауапта qrImageUrl мен payUrl келеді.
Егер эфирге өз жүйеңізді жазсаңыз (мысалы, комментарийлерді өңдейтін скрипт), externalOrderId ретінде эфир нөмірі мен лот нөмірін беріңіз, metadata ішіне TikTok никін жазыңыз — кейін кімге не жіберу керегін сол өрістен табасыз.
Telegram боттан счёт шығару
Эфир кезінде ең жылдам жол. Ботты кабинетке бір рет байланыстырасыз, сосын телефоннан:
/invoice— счёт шығару/last— соңғы счёттар, кім төледі/today— бүгінгі бәрі/cancel— қате шыққан счётты болдырмау/status— қызмет күйі/support— қолдауға жазу
Ботты топ чатқа қосуға болады — сонда сіз бен көмекшіңіз бір жерден көріп отырасыз. Нұсқаулық: Telegram бот.
Экранда QR көрсету
Кейде клиент нөмірін бергісі келмейді немесе сіз бір лотты бәріне бірдей бағамен сатып жатырсыз. Сонда экранда QR көрсетуге болады, бірақ екі шектеуді ескеріңіз.
Бірінші: сканерлеу терезесі шамамен үш минут. Оны Kaspi белгілейді, expiresAt өрісінен нақты уақытын көресіз. Эфирде QR-ды жарты сағат бойы қойып қоюға болмайды — ол жұмысын тоқтатады. Лот сайын жаңа счёт жасаңыз.
Екінші: бір QR — бір счёт. Бір QR-ды бес адам сканерлесе, олардың бәрі бір счётқа төлейді немесе біреуі ғана өтеді. Жеке тапсырыстарды осылай жинау мүмкін емес. Экрандағы QR тек «бәріне бірдей сома» сценарийіне жарайды (мысалы, кіру ақысы, бір бағалы лот).
Тұрақты нәрсені (донат, чаевые, ашық сомалы төлем) экранда көрсету керек болса, QR емес, төлем сілтемесін қойыңыз: qut.kz/p/<slug>. Оның мерзімі бітпейді, оны био бөліміне де қоя аласыз.
Ағын кезінде реттеу
- Көмекші міндетті. Эфирді жүргізу мен счёт шығаруды бір адам қатар істей алмайды. Кабинетке көмекшіні қызметкер ретінде шақырыңыз: Қызметкерге кабинетке рұқсат беру.
- Нөмірді директтен жинаңыз, комментарийден емес. Комментарийдегі нөмірді бәрі көреді, әрі жылдам жоғалып кетеді.
- Әр лотқа нөмір беріңіз. Сипаттамаға «Эфир 12, лот 5» деп жазсаңыз, кейін тізімді салыстыру оңай.
- Төленбегендерді эфир соңында тазалаңыз. Счёт шығарылып, төленбей қалса,
/cancelарқылы жауып отырыңыз. Ашық счёттар жиналып қалса, тәуліктік қорғанысқа тірелуіңіз мүмкін — олtariff_daily_burstқатесін береді. - Тарифті эфир көлеміне қарай таңдаңыз. Бір эфирде 200-300 счёт шықса, Бастау тарифінің айлық 800 счёты бірден таусылады: Қай тарифті таңдау керек.
- Ірі эфирге дайындалыңыз. Счёттар жаппай құлап жатса, бұл көбіне Kaspi жағындағы жиілік шектеуі — пауза беріп, қайта жіберіңіз.
Төлемді бақылау
Эфирде «төледім» деген сөзге сүйенуге болмайды. Үш тәсіл:
- Telegram бот —
/lastнемесе автоматты хабарлама. Ең жылдамы. - Кабинеттегі счёттар тізімі — көмекшінің экранында ашық тұрады, жаңа төлем түскен сайын көрінеді.
- Webhook — өз жүйеңіз болса,
invoice.paidоқиғасы клиент растағаннан кейін әдетте бес секунд ішінде келеді.
Кешігіп жатса, ол көбіне webhook мәселесі: Webhook келмей жатыр. Төлемнің расталу жылдамдығы туралы: Төлем баяу расталады.
Ерекше ескертулер
- Эфирден бұрын sandbox-та жаттығыңыз.
qp_test_…кілтімен бүкіл ретті өткізіңіз, төлемдіsimulateарқылы жасаңыз. Айырмашылығы: Sandbox пен нақты режимнің айырмашылығы. - Тест режимі қосулы қалып қойса, эфирде ақша түспей қалады. Эфир алдында бір нақты счётпен тексеріңіз: Клиентке төлем келмей жатыр.
- Кассир нөмірімен Kaspi Pay қосымшасына кірмеңіз — байланыс үзіледі де, эфирдің дәл ортасында счёт шықпай қалады.
- Кеш төлем болады. Мерзімі біткен счётқа ақша келсе, оқиға
late: trueбелгісімен келеді. Ондай клиентке тауарды беріңіз немесе ақшасын қайтарыңыз. - Ақша тіке сіздің Kaspi шотыңызға түседі: Ақша қашан және қайда түседі.
Жиі қойылатын сұрақтар
Эфирде QR көрсеткен ыңғайлы емес пе? Жеке тапсырыстар үшін емес. Бір QR — бір счёт, әрі терезесі шамамен үш минут. Нөмір бойынша push әлдеқайда сенімді.
Клиенттің нөмірін қайдан аламын? Директтен сұраңыз. Ол нөмір Kaspi-ге тіркелген нөмір болуы керек, әйтпесе push келмейді.
Клиентте Kaspi қосымшасы жоқ болса? Онда push жарамайды — QR немесе сілтеме беріңіз: Клиентте Kaspi қосымшасы жоқ.
Бір эфирде екі адам счёт шығара ала ма? Иә. Екеуі де кабинетке кіре алады немесе екеуіне бөлек API кілт беруге болады. Керек болса екінші кассир де қосылады: Бірнеше кассир қосуға бола ма.
Қате сома шықса не істеймін? Счётты /cancel немесе кабинеттен болдырыңыз да, жаңасын шығарыңыз. Клиент төлеп қойған болса, қайтару жасайсыз.