Қысқаша
Клиент өз Kaspi қосымшасында соманы, сіз жазған сипаттаманы және кассир нөмірін көреді. Кассир нөмірінің көрінуі — Kaspi-дің қалыпты жұмысы, оны жасыру мүмкін емес. Төлегеннен кейін клиентте Kaspi-дің өз чегі қалады, ал сіз оған қосымша біздің чек бетімізді бере аласыз. Көрінбейтіні: metadata, тапсырыс нөміріңіз (externalOrderId) және кез келген басқа ішкі деректеріңіз.
Төлеу алдында не көрінеді
| Не | Көріне ме | Түсініктеме |
|---|---|---|
| Сома | Иә | QR-да ең көбі 2 ондық, телефонға счётта бүтін теңге |
| Сипаттама | Иә | description өрісіне не жазсаңыз, сол |
| Кассир нөмірі | Иә | Kaspi өзі көрсетеді |
| Сіздің дүкен атауыңыз | Иә | Kaspi Pay аккаунтыңызда қалай тұрса, солай |
externalOrderId | Жоқ | Тек сізде және webhook-та |
metadata | Жоқ | Клиентке мүлде жетпейді |
customer.name, .email | Жоқ | Сіздің есебіңіз үшін |
| API кілтіңіз, webhook адресіңіз | Жоқ | Ешқашан сыртқа шықпайды |
Сипаттама — клиент оқитын жалғыз мәтін
description өрісі — клиентпен сөйлесетін жалғыз жеріңіз. Сондықтан оны мұқият жазыңыз.
Шектеулері:
- QR счёт — 100 таңба
- Телефонға счёт (
phone) — 60 таңба
Шектеуден асып кетсе, мәтін қиылады. Сондықтан ең маңыздысын басына жазыңыз.
Жақсы мысалдар:
Тапсырыс №1043, 2 дана— клиент нені төлеп жатқанын бірден түсінедіМамыр айы, абонемент— қайталанатын төлемде айқынҮстел 7, есеп-шот— мейрамханада
Жаман мысалдар:
Төлем— клиент нені төлеп жатқанын білмейді, кейін «бұл не еді?» деп сұрайдыinv_8f3a2b91c...— ішкі идентификатор, клиентке ештеңе айтпайды- Ұзын маркетингтік мәтін — қиылып қалады, орта жерінен үзіледі
Кеңес: сипаттамаға клиент өзі танитын нәрсені жазыңыз — тапсырыс нөмірі, тауар аты немесе кезең. Сонда даулы жағдай азаяды, қайтару сұрауы да сирейді.
Кассир нөмірі көрінеді
Клиент счёт туралы хабарламада кассир нөмірін көреді. Бұл — Kaspi-дің қалыпты жұмысы: төлемді нақты кім қабылдап жатқанын көрсету қауіпсіздік үшін жасалған. Оны өшіру де, басқа нөмірге ауыстырып көрсету де мүмкін емес.
Практикалық қорытындылары:
- Кассир нөмірін бөлек ұстаңыз. Ол сіздің жеке нөміріңіз болмағаны дұрыс — клиенттер сол нөмірге жазып, қоңырау шалуы мүмкін
- Ол нөмірде WhatsApp болмағаны жақсы, әйтпесе сұрақтар соған ағылады
- Қолдау нөміріңізді бөлек жариялаңыз, клиент қайда жазу керегін білсін
- Бірнеше кассир болса, клиент нақты қай кассир счёт шығарғанын көреді
Толығырақ: Кассир нөмірі мен өз нөміріңіз.
Төлегеннен кейін не көреді
Kaspi чегі. Kaspi өз қосымшасында клиентке чек береді. Ол Kaspi-дің ішінде қалады, төлемдер тарихынан ашылады.
Біздің чек беті. Счёт төленген соң оның receiptUrl өрісі толады — бұл клиентке жіберуге болатын бет. Онда счёттың негізгі деректері мен төлем фактісі көрінеді. Оны хабарламаға, email-ге немесе өз сайтыңыздың «рахмет» бетіне қоюға болады. Толығырақ: Чектер және оларды клиентке жеткізу.
Сіздің successUrl бетіңіз. Счёт жасағанда successUrl бергенсіз, клиент төлегеннен кейін сол бетке қайтады. Онда тапсырыс күйін, жеткізу мерзімін немесе қолжетімділікті көрсетуге болады.
Фискалды чек бөлек тақырып — қай жағдайда Kaspi өзі шығарады, қай жағдайда сіз жауаптысыз: Фискалды чек.
Көрінбейтіні
Мыналар клиентке ешқашан жетпейді:
metadata— ішінде не болса да, ол тек сіздің жүйеңіз бен webhook үшін. Тапсырыс құрамы, жеткізу мекенжайы, ішкі белгілер — бәрі жасырынexternalOrderId— сіздің тапсырыс нөміріңіз. Клиент оны көруі керек болса,descriptionішіне өзіңіз жазасыз- Счёттың ішкі идентификаторы —
inv_…түріндегі id - API кілтіңіз, webhook адресіңіз бен құпияңыз
- Басқа клиенттердің деректері — счёттар бір-бірінен толық бөлек
Яғни metadata — қауіпсіз орын, бірақ шексіз емес: онда парольдер мен құпия деректерді сақтамаңыз. Толығырақ: Metadata және тапсырыс нөмірі және Деректер және құпиялық.
Жиі қойылатын сұрақтар
Кассир нөмірін жасыруға бола ма? Жоқ. Оны Kaspi көрсетеді, біз оған әсер ете алмаймыз. Сондықтан кассирге арнайы, жеке емес нөмір алған дұрыс.
Клиент дүкен атауын көре ме? Иә, Kaspi Pay аккаунтыңызда қалай жазылса, солай көрінеді. Оны өзгерту Kaspi Pay жағында жасалады.
Сипаттамада эмодзи жазуға бола ма? Техникалық тұрғыда мәтін, бірақ таңба шектеуін ұмытпаңыз: эмодзи де орын алады, ал ұзын мәтін қиылады.
Қайтару жасасам, клиент оны көре ме? Иә, ақша қайтарылғанын Kaspi қосымшасынан көреді.
Клиентке email-мен чек жіберуге бола ма? Иә, receiptUrl сілтемесін өзіңіз жібересіз. Толығырақ: Чектер.