Қадамдық нұсқаулық: Kaspi Pay кассирін жасаңыз, кассаны қосыңыз, API v2 кілтін алыңыз, вебхукты баптаңыз және бәрін sandbox-та тексеріңіз. Сайт, бот, CRM немесе кодсыз.
Бұл — xpayment-ті Kaspi Pay-ге қосудың шолу маршруты: бос аккаунттан бірінші төлемге дейін. Ол қадамдардың реттілігін түсініп, адаспауға көмектеседі. Егжей-тегжейлі нұсқаулықтар жеке мақалаларда, әр қадамда сілтеме берілген.
Қазір Kaspi Pay қолдау табады, басқа төлем жүйелері кейінірек қосылады. Сатып алушылардың ақшасы тікелей сіздің Kaspi шотыңызға түседі: xpayment оны сақтамайды.
Кассаны қосқаннан кейін (төмендегі 1–2 қадам) төлемді қалай қабылдайтыныңызды таңдайсыз:
| Жол | Кімге арналған | Не қажет |
|---|---|---|
| Кодсыз | Әзірлеушісі жоқ дүкен, студия, репетитор, қызмет | Кабинетте төлем сілтемесін немесе онлайн жазылуды жасап, сілтемені клиентке жіберіңіз. Толығырақ: Бағдарламалаусыз төлем қабылдау |
| API v2 арқылы | Сайт, Telegram-бот, CRM, қосымша, SaaS | xapi_… кілті, POST /v2/payments/link немесе POST /v2/payments сұранысы және вебхук |
Кассаны қосу екі жағдайда да қажет, ал кілт пен вебхук тек API арқылы жұмыс істегенде керек.
| Не қажет | Не үшін |
|---|---|
| ЖК (ИП) немесе ЖШС (ТОО) және Kaspi Pay аккаунты | Касса ақшаны жеке картаға емес, бизнес шотына қабылдайды |
| Kaspi Pay қосымшасы бар смартфон | Иесі мен кассир үшін |
| Бөлек телефон нөмірі | Шектеулі кассир рөлі үшін. Ол басқа Kaspi Pay аккаунтының иесі болмауы керек |
| xpayment-ке кіру | Google арқылы немесе құпиясөзбен |
| Вебхуктың ашық HTTPS мекенжайы | Тек API үшін: жүйеңіз төлем күйлерін алуы үшін |
Kassa1.xapi_…. Бір кілт барлық кассаларыңызбен жұмыс істейді және касса қайта қосылса да жұмысын жалғастырады.Алдымен сынақ қолжетімділігінің 3 тегін күні: API, QR, deeplink және телефонға шотты тексеруге жеткілікті. Содан кейін төлем көлемі бойынша тіркелген тарифті таңдайсыз: «Старт» — 10 000 ₸/ай (айына 250 төлемге дейін), «Рост» — 25 000 ₸/ай (2 000 төлемге дейін) немесе «Масштаб» — 60 000 ₸/ай (төлем саны шектеусіз). Тіркелген тариф сәйкес келмесе, 1–4% пайыздық модельді таңдауға болады. Комиссияны калькуляторда есептеуге болады.
Алдымен Kaspi Pay жағын дайындаңыз: бизнес-аккаунттың белсенді екеніне көз жеткізіп, құқықтары шектеулі жеке кассир жасаңыз. Экраннан экранға толық нұсқаулықты мұнда қайталамаймыз, ол жеке мақалада: Kaspi Pay кассирін онлайн төлемдер үшін қалай қосуға болады.
xpayment-ке өтпес бұрын мыналарды тексеріңіз:
xpayment бизнес иесінің негізгі аккаунтымен жұмыс істемейді. Үшінші тарап сервисіне қолжетімділік беру қорқынышты екенін түсінеміз, сондықтан қауіпсіз модель «Кассир» рөлі төңірегінде құрылған: ол шектеулі және тек төлем қабылдауға арналған.
| Кассир жасай алады | Кассир жасай алмайды |
|---|---|
| Төлем қабылдау | Ақша аудару |
| Өз операциялар тарихын көру | Бизнес-аккаунттың бәріне қол жеткізу |
| Басқа кассирлердің операцияларын көру |
Кассирдің деректері бөтен адамның қолына түссе де, бұл рөлмен бизнеске зиян келтіру мүмкін емес. Бұл — төлем қабылдауға жеткілікті ең аз қолжетімділік.
Kaspi-дің ресми материалдары:
Сервисы -> Профиль компании -> Сотрудники -> Добавить, «Кассир» рөлі.Бұл кезеңді толық білгіңіз келсе, кассир туралы жеке мақаланы ашып, толық өтіңіз де, 2-қадамға оралыңыз.
Кассир Kaspi Pay-де дайын болғасын, xpayment-ке өтіңіз. Кабинеттегі «касса» — қосылған Kaspi Pay кассирі: xpayment сол арқылы шот шығарып, төлемді тексереді.
Кассы и счета (Кассалар мен шоттар) бөлімін ашып, Подключить кассу (Кассаны қосу) түймесін басыңыз. Шебер үш қадамнан тұрады:
Kassa1. API v2 сұраныстарында кассаны осы атау бойынша таңдайсыз;Растау кезінде кассирдің телефоны қасыңызда болуы керек.
Кейде Kaspi кассаның сессиясын қабылдауды тоқтатады, кабинет оны жұмыс істемейтін ретінде белгілейді. Кассаны қайта қосып, сол API атауын көрсетіңіз. Кодыңызды да, xapi_… кілтіңізді де өзгертудің қажеті жоқ.
Шебер, қателер және тексеру туралы толығырақ: Кассаны қосу және API v2 кілті. Нені және не үшін жасайтыныңыз: xpayment виртуалды кассирі қалай жұмыс істейді.
Касса қосылды, бірақ кілт автоматты түрде берілмейді: оны өзіңіз жасайсыз. Кілт арқылы сервер сұраныстардың сізден келгенін растайды.
xapi_ деп басталады және кассаны қайта қосқанда да жұмыс істей береді.Кілтпен жұмыс ережелері:
Касса кілттері
xdev_…(«Ключи касс (v1)» блогы) API v1-ге жатады. Ол әлі де қолдау табады, бірақ жаңа интеграциялар үшін API v2-ні пайдаланыңыз.
Kassa1 кассасы арқылы 1 500 ₸ төлем сілтемесін жасаңыз:
curl -X POST https://api.xpayment.kz/v2/payments/link \
-H "Authorization: Bearer xapi_СІЗДІҢ_КІЛТІҢІЗ" \
-H "Content-Type: application/json" \
-d '{"device_name": "Kassa1", "amount": 1500, "merchant_order_id": "order-42"}'
Жауапта payment_id, qr_token (QR немесе deeplink үшін мекенжай), qr_operation_id және expire_date болады. qr_token-ді QR-код немесе сілтеме ретінде көрсетіңіз, сатып алушы Kaspi қосымшасында төлейді.
Алдымен нақты ақшасыз байқағыңыз келе ме? Сол сұраныстар sandbox-та xapi_test_… тест кілтімен жұмыс істейді.
Вебхук — төлем күйін өзгерткенде xpayment сіздің серверіңізге жіберетін сұраныс. Соның арқасында клиенттің төлегенін API-ден үнемі сұрап отырудың қажеті жоқ: тапсырыс автоматты түрде расталады.
https://example.com/webhook.payment.completed, payment.cancelled, payment.expired және payment.failed жеткілікті. Қайтарым жасасаңыз, payment.refunded және payment.refund_failed қосыңыз.openssl rand -hex 32). Әр сұраныс оның көмегімен қол қойылады, сондықтан өрісті бос қалдырмаңыз.GET /v2/payments/{payment_id}.X-xPayment-Signature қолтаңбасын міндетті түрде тексеріңіз: Вебхук қолтаңбасын тексеру.2xx жауап беріңіз. Барлығы үш әрекет: бірден, бір минуттан және 5 минуттан кейін.Оқиғалар, қайталаулар және идемпотентті өңдеу туралы толық талдау: xpayment вебхуктары.
Кілт бар, касса жұмыс істейді. Әрі қарай не істеу төлемді қалай қабылдағыңыз келетініне байланысты.
Әзірлеушіңіз болмаса, сізге кілт те, вебхук та қажет емес. Кабинетте төлем сілтемесін, онлайн жазылуды немесе тұрақты төлемдерді жасап, сілтемені клиентке WhatsApp, Instagram немесе Telegram арқылы жіберіңіз. Клиент Kaspi-де төлейді, ал төлемдер тізімін кабинетте көресіз. Толығырақ: Бағдарламалаусыз төлем қабылдау.
xpayment серіктес платформасында жұмыс істесеңіз (мысалы, tec.delivery), бәрі қарапайым:
Осыдан кейін Kaspi Pay арқылы онлайн төлемдер сіздің мекемеңізде өздігінен жұмыс істейді. Серіктес платформалар тізімі кеңейе береді.
Сіз әзірлеуші болсаңыз немесе сервисіңіз API арқылы тікелей қосылуды қолдаса, xpayment-пен тікелей жұмыс істеңіз.
FAILED түпкілікті күй емес.API құжаттамасы бетін ашыңыз: ол интерактивті, кілтіңізді қойып, сұранысты тікелей браузерден жібере аласыз.
xapi_… кілтін Bearer токен өрісіне қойыңыз.POST /payments/link, «Try it» түймесін басып, device_name мен amount толтырыңыз да, сұранысты жіберіңіз.Касса кілтімен
xdev_…API v1 әлі де қолдау табады, бірақ жаңа интеграциялар үшін v2-ні ұсынамыз.
Нөлден жұмыс істейтін интеграцияға дейін өттіңіз:
Енді эквайринг өтінімдерінсіз және апталап келісусіз Kaspi Pay төлемдерін қабылдай аласыз. Алғашқы 3 күн тегін; кейін тіркелген тарифті немесе пайыздық модельді таңдайсыз: кабинеттегі «Тариф и баланс» (Тариф және теңгерім) бөлімі мен калькулятор.
Бірдеңе дұрыс болмаса, осы бөлімдегі басқа мақалаларды қараңыз немесе қолдау қызметіне жазыңыз.