Мобильді қосымшаға Kaspi Pay интеграциясы — бұл пайдаланушыларға қосымшадан шықпай-ақ және карта деректерін қолмен енгізбестан, тауарларды немесе қызметтерді тікелей төлеуге мүмкіндік беретін төлем шлюзін қосу. Бұл процесс Kaspi-дан API-ге қол жеткізуді, транзакцияларды өңдеу үшін серверлік бөлікті баптауды және төлемді растау үшін пайдаланушы интерфейсін іске асыруды қамтиды. Қазақстандағы бизнес үшін бұл монетизацияның стандартты әдісі, өйткені аудиторияның ірі бөлігі Kaspi экосистемасын пайдалануды жөн көреді. Қосымшаның архитектурасының күрделілігіне және бизнес құжаттарының дайындығына байланысты интеграция бірнеше күннен бірнеше аптаға дейін созылуы мүмкін.
Kaspi Pay-ті қосу үшін қандай әдістер бар?
Интеграцияның екі негізгі сценарийі бар: Kaspi API арқылы тікелей қосу (Kaspi Integration) және Kaspi-мен интеграциясы бар төлем аралығын (PSP) пайдалану. Бірінші нұсқа процесті толық бақылауды және комиссияларды азайтуды қамтамасыз етеді, бірақ тереңірек техникалық дайындықты талап етеді. Екінші нұсқа әзірлеуді жеңілдетеді, өйткені әзірлеуші тек бір API-мен жұмыс істеуі керек, бірақ аралықтың пайыздық қосуына байланысты транзакцияның жалпы құны артады.
Тікелей қосу кезінде сіздің қосымшаңыз Kaspi серверіне төлем жасау сұрауын жібереді, сілтемесін немесе токенді алады және оны пайдаланушыға береді. Пайдаланушы амалды Kaspi қосымшасында немесе веб-браузерде растайды, содан кейін транзакцияның күйі сіздің жүйеңізге қайтарылады. Бұл әдіс қауіпсіздікті мұқият баптауды талап етеді, өйткені сіз деректерді валидациялау мен кілттерді қорғау үшін жауаптасасыз. Керісінше, PSP пайдалану осы процестерді абстрактілеп көрсетеді: сіз төлем сұрауын аралық сервиске жібересіз, ал ол Kaspi және басқа төлем жүйелерімен хабарласады. Бұл сіз болашақта Kaspi-ден гөрі Visa/Mastercard карталарын, Apple Pay немесе Google Pay-ді де қабылдауды жоспарлап жатсаңыз, ыңғайлы, өйткені бір интерфейс барлық төлем әдістерімен жұмыс істеуге мүмкіндік береді.
| Критерий | Тікелей қосу (Kaspi API) | Төлем аралығы арқылы (PSP) |
|---|---|---|
| Әзірлеу күрделілігі | Жоғары, Kaspi API-нің ерекшеліктерін білуді талап етеді | Орташа, барлық төлем әдістері үшін бірыңғай интерфейс |
| Комиссия | Kaspi-нің базалық сыйақысы | Kaspi сыйақысы + PSP пайыздық қосуы |
| Икемділік | Бизнес логикасына сәйкес максималды баптау | Нақты PSP мүмкіндіктерімен шектелген |
| Қолдау | Kaspi-мен немесе әзірлеушімен тікелей байланыс | PSP жағынан қолдау |
| Іске қосу уақыты | Келісу және тестілеу қажеттілігіне байланысты ұзағырақ | PSP-де дайын модульдер болса, тезірек |
Төлемдерді іске қосу үшін бизнестен не қажет?
Техникалық жұмыстарды бастамас бұрын бизнес заңдылық базасын және құжаттаманы дайындауы керек. Kaspi төлемді тіркелген компаниядан немесе ашылған шоты бар ЖСН-нен қабылдауды талап етеді. Kaspi-мен шарттастыру үшін реквизиттер болуы қажет, сондай-ақ қандай тауарлардың немесе қызметтердің төленетінін анық түсіну керек. Егер сізде Kaspi төлем сервисі ретінде шарт болмаса, оны жасасу Kaspi-нің серіктестермен жұмыс бөлімінің жүктемесіне байланысты бірнеше күннен бір-екі аптаға дейін созылуы мүмкін.
Заңды құжаттардан бөлек, бизнес логикасын нақты сипаттауды талап етеді. Төлем сомасы қалай қалыптасатынын анықтау қажет: бекітілген баға, жеңілдіктерді ескерген динамикалық құн, уақыт бойынша қызмет төлемі немесе бөліктерге бөлу. Сонымен қатар, бас тарту сценарийлерін ойластыру маңызды: пайдаланушы төлемді бұзса, сома сәйкес келмесе немесе банкпен байланыс жоғалса не болады? Осы сценарийлер қосымшаның және серверлік бөліктің архитектурасына әсер етеді. Біздің тәжірибеде біз әрқашан осы ережелерді техникалық тапсырмада бекітуден бастаймыз, бұл тестілеу кезеңіндегі түзетулерден аулақ болуға мүмкіндік береді.
Kaspi Pay интеграциясы қанша уақыт алады?
Мерзімдер таңдалған қосу әдісіне және қосымшаңыздың қазіргі жағдайына байланысты. Егер қосымша әзірленген және дайын серверлік бөлігі болса, Kaspi Pay-ті қосу 3-тен 7 жұмыс күніне дейін алуы мүмкін. Егер сіз қосымшаны басынан бастап әзірлеп жатсаңыз, төлемдер интеграциясы жалпы әзірлеу мерзіміне енгізіледі, ол мобильді қосымшалар үшін 1-ден 3 айдан басталады. Бұл жағдайда төлем модулі басқа функциялармен параллель түрде жасалады, бұл уақытты оңтайландыруға мүмкіндік береді.
Жұмыстардың ұзақтығына бірнеше фактор әсер етеді. Біріншісі — Kaspi тестілеу ортасына қол жеткізуді келісу қажеттілігі. Екіншісі — пайдаланушы интерфейсінің күрделілігі: егер жай ғана «Төлеу» түймесін емес, төлем әдісін таңдау, тапсырысты толықтыру және төлемдер тарихы бар толық экран жасау керек болса, жұмыс көбірек уақыт алады. Үшіншісі — тестілеу кезеңі. Төлем интеграциялары барлық сценарийлерді мұқият тексеруді талап етеді: сәтті төлем, болдырмау, желі қатесі, қайта төлем. Біз қосымшаны дүкендерде жариялау алдында соңғы тестілеуге кемінде 2–3 күн бөлуді ұсынамыз.
- Құжаттарды дайындау және Kaspi-мен шарт жасасу: 3–10 жұмыс күні.
- Серверлік бөлікті баптау және API кілттерін алу: 1–3 күн.
- Клиенттік бөлікті әзірлеу (түймелер, экрандар, логика): 2–5 күн.
- Сандалда және нақты транзакцияларда тестілеу: 2–3 күн.
- Соңғы реттеу және дүкендерде жариялау: 1–2 күн (модерацияны ескере отырып).
Қосымшаға қандай техникалық талаптар қойылады?
Қосымшада сервермен сенімді байланыс болуы керек, өйткені төлем транзакциясын құрылғыда жергілікті түрде жүргізуге болмайды. API кілттері және токендер сияқты сезімтал деректер қосымша кодында емес, серверлік жақта сақталуы тиіс. Бұл қауіпсіздіктің негізгі ережесі: егер кілттер APK немесе IPA файлында болса, олар қосымшаны бөлмеуге қабілетті кез келген адамға қолжетімді болады. Сервер қосымша мен Kaspi арасындағы аралық болып табылады, ол сұраудың аутентикалығын тексеріп, есеп құрастырады.
Mango Development-тың технологиялық стеки Flutter, React, Node.js және TypeScript-ті қамтиды, бұл iOS және Android үшін бір коды базасында төлем модульдерін іске асыруға мүмкіндік береді. Flutter-ды пайдалану қолдауды жеңілдетеді, өйткені әр платформа үшін төлем логикасын қайталау қажет емес. Алайда, төлем шлюздерімен байланысты кейбір жүйелік функциялар нативті плагиндерді талап етуі мүмкін екенін ескеру маңызды. Мысалы, биометриямен дұрыс жұмыс істеу немесе фонда төлем күйі туралы хабарламалар үшін әр ОС-ке арнайы баптаулар қажет болуы мүмкін. Біздің әзірлеушілер бұл нюанстарды архитектураны жобалау кезеңінде ескереді.
Интеграция кезінде қандай қиындықтарға тап болуға болады?
Ең жиі кездесетін мәселелердің бірі — тапсырыс сомасы мен төлем сомасының сәйкес келмеуі. Егер пайдаланушы есеп құрылғаннан кейін, бірақ төлемнен бұрын тапсырыс құрамын өзгертіп жіберсе, сервер мұндай транзакцияны қабылдамауы керек. Егер оны жасамаңыз, сіз бір тауарлар үшін төлем алып, басқаларын жіберу қаупіне тап боласыз. Бұл мәселені шешу үшін «тапсырыс» (order) механизмі қолданылады, ол құрамын және сомасын серверде бекітеді. Төлем расталғанда сервер жіберілген деректерді сақталған тапсырыспен салыстырады. Егер сәйкес келмесе, төлем қабылданады.
Екінші жиі кездесетін қате — ақау сценарийлерін ескермеу. Желі кез келген сәтте үзілуі мүмкін: пайдаланушы қосымшаны жабуы, телефон байланысты жоғалтуы немесе Kaspi сервері уақытша жауап бермеуі мүмкін. Қосымша осы жағдайларды дұрыс өңдеуі керек, пайдаланушыға қайталауды немесе тапсырысты болдырмауды ұсынуы тиіс. Егер қосымша «істемесе» немесе жалғасу мүмкіндігісіз қате көрсетсе, бұл табысты жоғалтуға және дүкендерде теріс пікірлерге әкеледі. Үшінші мәселе — сәтті төлем туралы хабарламаның болмауы. Пайдаланушы төледі, бірақ қосымша «Сатып алуыңыз рахмет» экранына ауыспай тұр. Бұл сенімсіздік тудырады. Шешу үшін вебхуктер қолданылады: Kaspi төлем күйі туралы сіздің серверіңізге хабарлама жібереді, ал сервер деректер базасындағы тапсырыс күйін жаңартады.
Төлем модулінің тестілеуі қалай өтеді?
Тестілеу Kaspi ұсынатын тестілеу ортасында (sandbox) басталады. Бұл режимде транзакциялар нақты ақшаны аудармайды, бірақ төлемнің толық циклін имитациялайды. Әзірлеушілер барлық сценарийлерді тексереді: сәтті төлем, пайдаланушы тарапынан болдырмау, валидация қатесі, қайта сұрау. Тек «идеалды» сценарийлерді емес, шекті жағдайларды да тестілеу маңызды: өте үлкен сомалар, нөлдік сома, әлсіз сигнал кезіндегі төлем. Сандалда тестілерді сәтті тапсырғаннан кейін нақты транзакцияларға көшеді.
Нақты тестілеу кезеңінде минималды сомалармен транзакциялар жүргізіледі (мысалы, 100–500 теңге). Бұл ақшаның шотқа келетінін, есептердің дұрыс құрылатынын және күй туралы хабарламалардың уақытында келетінін тексеруге мүмкіндік береді. Біз әрқашан әртүрлі құрылғылармен және әртүрлі байланыс операторларымен бірнеше нақты тестілеу төлемдерін жүргізуді ұсынамыз, өйткені желінің мінез-құлқы сұрауды өңдеу жылдамдығына әсер етуі мүмкін. Тек модульдің тұрақты жұмысы расталғаннан кейін ғана қосымша App Store және Google Play-де жарияланады.
Қазақстанда Kaspi Pay интеграциясы қанша тұрады?
Интеграция құны жұмыс көлеміне және таңдалған қосу әдісіне байланысты. Егер сіз Mango Development-та қосымшаны басынан бастап әзірлеп жатсаңыз, төлем модулі әдетте мобильді қосымша әзірлеудің жалпы құнына кіреді, ол 1 000 000 ₸-нан басталады. Егер қосымша бұрыннан бар болса және тек Kaspi Pay-ті қосу қажет болса, құн қазіргі архитектураның күрделілігіне және серверлік бөлікті толықтыру қажеттілігіне қарай жеке есептеледі. Жай жағдайлар үшін бұл сыртқы API-мен интеграция құнының кіші бөлігі болуы мүмкін, ол біздің бағаларда 300 000 ₸-нан басталады.
Әзірлеу құнынан бөлек, бизнеске төлем жүйелерінің комиссияларына бюджет бөлуді ескеру маңызды. Kaspi әр транзакциядан пайыз алады, оның көлемі бизнес категориясына және шарт шарттарына байланысты. Егер сіз төлем аралығын пайдалансаңыз, оған оның пайыздық қосуы қосылады. Интеграция құнының нақты бағасын біз қысқа тегін қоңырау соңында айтамыз, онда біз сіздің архитектуралық және бизнес логикаңызды қарастырамыз. Бұл жасырын шығындардан аулақ болуға және төлемдерді іске қосудың қанша тұратынын дәл түсінуге мүмкіндік береді.
Қосымшаны іске қосқаннан кейін не істеу керек?
Қосымшаны дүкендерде жариялау — жұмыстың аяқталуы емес, мониторингтің басталуы. Kaspi төлем жүйелері API-ні кезең-кезеңімен жаңартып отырады немесе қауіпсіздікке қойылатын талаптарды өзгертеді. Егер сіз Kaspi жаңалықтарын бақыламай, қосымшаны жаңартпасаңыз, төлемдер жұмыс істемей қалуы мүмкін. Сондықтан техникалық қолдау шарты болуы маңызды. Mango Development-та кепілдік кезеңі 1-ден 12 айға дейін, осы уақыт ішінде біз интеграциямен байланысты қателерді тегін түзетеміз.
Төлем транзакцияларын мониторингке қоюды ұсынамыз. Егер төлемдер келуді тоқтатса, пайдаланушылар қолдауға жазбастан, соны бірден білуіңіз керек. Мұның үшін сервердегі алерттер қолданылады: Kaspi-ден төлем күйі туралы хабарлама белгілі бір уақыт ішінде келмесе, жүйе әкімшіге хабарлама жібереді. Бұл ақауларға оперативті түрде жауап беруге және шығындарды минимизациялауға мүмкіндік береді. Қолдау және өнімді дамыту — бұл бизнеске төлем интеграциясының техникалық егжей-тегжейлері туралы алаңдамай жұмыс істеуге көмектесетін бөлек қызмет.
Kaspi Pay интеграциясы — Қазақстандағы кез келген коммерциялық қосымшаның стандартты элементі. Қосу әдісін дұрыс таңдау, бизнес логикасын мұқият жетілдіру және сапалы тестілеу төлем модулін ақаусыз іске қосуға мүмкіндік береді. Егер сіз әзірлеушіні қалай таңдау керектігі туралы ойлап жатсаңыз, студияның төлем жүйелерімен жұмыс тәжірибесіне және нақты кейстердің болуына назар аударыңыз. Біз сізге Kaspi Pay-ті қосу ғана емес, сонымен қатар болашақта оңай масштабталатын қосымша архитектурасын құруға көмектесеміз. Стекпен әлі шешім қабылдамағандар үшін «Flutter немесе нативті әзірлеу: бизнеске не таңдау керек» мақаласын қарастыруға болады, бұл сіздің тапсырмаңызға қай тәсілдің сәйкес келетінін түсінуге көмектеседі.