QR, deeplink немесе телефон нөмірі бойынша қашықтан төлем

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 Pay бетінде Kaspi төлем қабылдаудың бірнеше тәсілін сипаттайды: әр сатып алуға QR бар мобильді POS, кассадағы QR, қашықтан төлем және төлем сілтемесі.

xpayment арқылы интеграция үшін олар екі API моделіне және кабинеттің бір құралына айналады:

  1. Төлем сілтемесі, QR, deeplink — POST /v2/payments/link: нақты соммаға сілтеме немесе QR жасайсыз.
  2. Телефонға шот (қашықтан төлем) — POST /v2/payments: сатып алушының телефон нөміріне төлем сұранысын жібересіз.
  3. Кабинеттегі төлем сілтемелері — сол сияқты, бағдарламалаусыз.

Екі API сұранысында да кассаны device_name бойынша (мысалы, Kassa1) көрсетіп, xapi_… кілтімен қол қоясыз.

1-нұсқа. Төлем сілтемесі арқылы QR және deeplink

Клиент төлемді өзі ашқанда төлем сілтемесін қолданыңыз. Бұл чекаут, бот, лендинг, хабарлама және кез келген self-service сценарий үшін дұрыс таңдау.

Бір ағын ішінде пайдаланушыға екі кіру жолын беруге болады:

Сілтеме қысқа мерзімді: мерзімі жауаптағы expire_date өрісінде, әдетте бірнеше минут. Сатып алушы үлгермесе, жаңасын жасаңыз.

Толық мысалдар: POST /v2/payments/link арқылы төлем сілтемелері.

QR қайда жақсы жұмыс істейді

QR сатып алушы тапсырысты үлкен экраннан көргенде жарайды:

Сатып алушы QR-ды телефонмен сканерлеп, Kaspi-ді ашады және төлемді растайды.

Deeplink қайда жақсы жұмыс істейді

Сатып алушы телефонда болғанда deeplink ыңғайлырақ:

Пайдаланушыдан сол экрандағы QR-ды сканерлеуді сұрау мағынасыз: оған түйме немесе сілтеме керек.

2-нұсқа. Телефонға шот

Өніміңіз клиенттің телефон нөмірін бұрыннан білсе, осы ағынды қолданыңыз. Жүйе немесе менеджер клиенттің чекаутты ашуын күтпей, шотты тікелей Kaspi қосымшасына жібереді.

Kaspi Guide қашықтан төлемнің қолмен сценарийін былай сипаттайды: кассир немесе басшы қашықтан төлемді таңдайды, клиенттің нөмірі мен соманы енгізеді және шотты жібереді. Дереккөз: Шотты қашықтан қалай шығаруға болады? xpayment арқылы бұл логика API-шақыруға айналады: қосымшада қолмен енгізудің орнына backend немесе n8n сценарийі сұранысты автоматты жібереді.

Толық іске асыру: POST /v2/payments арқылы қашықтан төлемдерді қабылдау.

Телефонға шот қайда жақсы жұмыс істейді

3-нұсқа. Бағдарламалаусыз

Төлемді қабылдау керек, ал әзірлеушіңіз жоқ болса, кабинетте дайын құралдар бар: пішіні бар төлем сілтемелері, алдын ала төлемі бар онлайн жазылу және кесте бойынша тұрақты төлемдер. Олар сол кассаларды қолданады және төлемдерді Транзакции (Транзакциялар) бөлімінде көрсетеді. Толығырақ: Бағдарламалаусыз төлем қабылдау.

Статикалық QR

Төлемді тұрақты (статикалық) 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 көрсету

Чекаут смартфонда ашық болса, QR емес, төлем түймесін көрсетіңіз.

Келісімсіз телефон нөміріне шот шығару

Пайдаланушы нөмірді не үшін қалдыратынын және Kaspi-де төлем сұранысын алатынын түсінуі керек.

merchant_order_id сақтамау

Тапсырыс ID-сі болмаса, төлемді, вебхукты және жүйедегі тапсырысты байланыстыру қиын. Оны әрдайым жіберіңіз.

Идемпотенттілікті қолданбау

Backend тайм-аутынан кейін сұранысты қайталаса, дубль жасалуы мүмкін. POST /v2/payments үшін X-Idempotency-Key тақырыбын жіберіңіз.

Төлем скриншоттарына сену

Скриншот төлемді растамайды. Растау — вебхук пен API арқылы күйді тексеру.

Нақты ақшамен тестілеу

Сценарийлерді тексеру үшін sandbox бар: тест кассасы, тест кілттері және ақша есептеусіз нәтижелерді имитациялау.

Пайдалы сілтемелер

Әрі қарай қайда