xpayment-те Kaspi Pay төлем тәсілін қалай таңдауға болады: QR немесе deeplink бар төлем сілтемесі, телефонға шот немесе кабинеттің кодсыз дайын құралдары.
xpayment-те Kaspi Pay төлемін қабылдаудың бірнеше практикалық тәсілі бар: төлем сілтемесі (QR немесе deeplink), клиенттің телефонына шот және кабинеттің кодсыз дайын құралдары. Олардың бәрі сіздің кассаңыз арқылы жұмыс істейді және бірдей аяқталады: вебхукпен немесе кабинеттегі жазбамен.
xpayment.kz API қабатын береді: өніміңіз API v2 сұранысымен төлем жасайды, xpayment оны Kaspi Pay-мен байланыстырады, содан кейін күй өзгергенде вебхукпен хабарлайды. Бұл мақала мысалдарды көшіру үшін емес, дұрыс пайдаланушы жолын таңдау үшін.
| Жағдай | Нені таңдау | Не үшін |
|---|---|---|
| Сатып алушы компьютерде немесе ноутбукте | QR | QR-ды телефонмен сканерлеу ыңғайлы |
| Сатып алушы смартфонда | Deeplink немесе төлем түймесі | Сол телефоннан QR сканерлеу ыңғайсыз |
| Клиенттің Kaspi нөмірін білесіз | Телефонға шот | Клиент төлем сұранысын тікелей Kaspi-де алады |
| CRM тұрақты клиентке шот шығарады | Телефонға шот | Менеджер немесе жүйе нөмірді біледі |
| Telegram-бот цифрлық тауар сатады | Deeplink немесе телефонға шот | Бот нөмірді жинағанына байланысты |
| Әзірлеушіңіз жоқ | Кабинеттен төлем сілтемесі | Шеберлікпен, кодсыз жасалады: Бағдарламалаусыз төлем қабылдау |
| n8n шоттарды автоматтандырады | Екі API нұсқасы да | Сілтеме хабарламаларға, телефонға шот CRM клиенттеріне сай |
Kaspi Pay бетінде Kaspi төлем қабылдаудың бірнеше тәсілін сипаттайды: әр сатып алуға QR бар мобильді POS, кассадағы QR, қашықтан төлем және төлем сілтемесі.
xpayment арқылы интеграция үшін олар екі API моделіне және кабинеттің бір құралына айналады:
POST /v2/payments/link: нақты соммаға сілтеме немесе QR жасайсыз.POST /v2/payments: сатып алушының телефон нөміріне төлем сұранысын жібересіз.Екі API сұранысында да кассаны device_name бойынша (мысалы, Kassa1) көрсетіп, xapi_… кілтімен қол қоясыз.
Клиент төлемді өзі ашқанда төлем сілтемесін қолданыңыз. Бұл чекаут, бот, лендинг, хабарлама және кез келген self-service сценарий үшін дұрыс таңдау.
Бір ағын ішінде пайдаланушыға екі кіру жолын беруге болады:
Сілтеме қысқа мерзімді: мерзімі жауаптағы expire_date өрісінде, әдетте бірнеше минут. Сатып алушы үлгермесе, жаңасын жасаңыз.
Толық мысалдар: POST /v2/payments/link арқылы төлем сілтемелері.
QR сатып алушы тапсырысты үлкен экраннан көргенде жарайды:
Сатып алушы QR-ды телефонмен сканерлеп, Kaspi-ді ашады және төлемді растайды.
Сатып алушы телефонда болғанда deeplink ыңғайлырақ:
Пайдаланушыдан сол экрандағы QR-ды сканерлеуді сұрау мағынасыз: оған түйме немесе сілтеме керек.
Өніміңіз клиенттің телефон нөмірін бұрыннан білсе, осы ағынды қолданыңыз. Жүйе немесе менеджер клиенттің чекаутты ашуын күтпей, шотты тікелей Kaspi қосымшасына жібереді.
Kaspi Guide қашықтан төлемнің қолмен сценарийін былай сипаттайды: кассир немесе басшы қашықтан төлемді таңдайды, клиенттің нөмірі мен соманы енгізеді және шотты жібереді. Дереккөз: Шотты қашықтан қалай шығаруға болады? xpayment арқылы бұл логика API-шақыруға айналады: қосымшада қолмен енгізудің орнына backend немесе n8n сценарийі сұранысты автоматты жібереді.
Толық іске асыру: POST /v2/payments арқылы қашықтан төлемдерді қабылдау.
Төлемді қабылдау керек, ал әзірлеушіңіз жоқ болса, кабинетте дайын құралдар бар: пішіні бар төлем сілтемелері, алдын ала төлемі бар онлайн жазылу және кесте бойынша тұрақты төлемдер. Олар сол кассаларды қолданады және төлемдерді Транзакции (Транзакциялар) бөлімінде көрсетеді. Толығырақ: Бағдарламалаусыз төлем қабылдау.
Төлемді тұрақты (статикалық) QR арқылы қабылдап, оларды өз жағыңызда салыстырғыңыз келсе, GET /v2/static-qr-payments/{orderNumber} қолданыңыз: ол төлемді Kaspi тарихындағы тапсырыс нөмірі бойынша табады. Бұл сұраныс sandbox-та қолжетімсіз.
| Өнім | Үздік тәсіл | Не үшін |
|---|---|---|
| Компьютердегі интернет-дүкен чекауты | QR (төлем сілтемесі) | Сатып алушы экранды телефонмен сканерлейді |
| Мобильді чекаут | Deeplink | Сатып алушы телефонда |
| Телефон нөмірі жоқ Telegram-бот | Deeplink | Бот төлем түймесін жібереді |
| Телефон нөмірі бар Telegram-бот | Телефонға шот | Сұранысты бірден Kaspi-ге жіберуге болады |
| Менеджерлерге арналған CRM | Телефонға шот | Клиент нөмірі әдетте бар |
| Түпкілікті сомасы бар жеткізу | Телефонға шот | Сома тапсырыс жиналған соң шығады |
| SaaS жазылымы | Телефонға шот немесе сілтеме; тарифтер мен қолжетімділік — жазылымдар API-і | Клиент нөмірінің белгілі екеніне байланысты |
| Әзірлеушісі жоқ шағын бизнес | Кабинеттен төлем сілтемесі | Шебер, үлгілер және төлемдер тізімі |
| n8n | Кез келгені | HTTP Request түйіні кез келген эндпоинтті шақыра алады |
Төлем жасалған бойда тапсырысты төленді деп белгілеуге болмайды. Төлем жасау тек клиентке төлем тәсілі көрсетілді немесе жіберілді дегенді білдіреді. Төлемді payment.completed вебхугі растайды, содан кейін төлемді сұрайсыз: GET /v2/payments/{payment_id}. Толығырақ: xpayment вебхуктары және Төлем күйлері мен қайтарымдар.
Чекаут смартфонда ашық болса, QR емес, төлем түймесін көрсетіңіз.
Пайдаланушы нөмірді не үшін қалдыратынын және Kaspi-де төлем сұранысын алатынын түсінуі керек.
merchant_order_id сақтамауТапсырыс ID-сі болмаса, төлемді, вебхукты және жүйедегі тапсырысты байланыстыру қиын. Оны әрдайым жіберіңіз.
Backend тайм-аутынан кейін сұранысты қайталаса, дубль жасалуы мүмкін. POST /v2/payments үшін X-Idempotency-Key тақырыбын жіберіңіз.
Скриншот төлемді растамайды. Растау — вебхук пен API арқылы күйді тексеру.
Сценарийлерді тексеру үшін sandbox бар: тест кассасы, тест кілттері және ақша есептеусіз нәтижелерді имитациялау.