Qut Pay Сайт Кабинет Білім базасы Нұсқаулықтар API құжаттамасы ҚАЗРУС

Білім базасы

Kaspi QR арқылы төлем қабылдау туралы сұрақтарға қарапайым тілмен жауап. Кассирді қосу, счёт, webhook, қайтару, жазылым, тариф.

126 мақала

Неден бастау керегін білмейсіз бе? Қалай қосу керек →

Бастау28

Бірінші қосылу: кассир, нөмірлер, sandbox, тариф, кабинетке кіру.

Ақша қашан және қайда түседіКлиент төлеген сәтте ақша тіке сіздің Kaspi Pay шотыңызға түседі — бізде ұсталмайды. Қызмет ақысы төлем сомасынан емес, айлық жазылым. Есеп айырысу мен сверка қалай жүреді.Әзірлеуші жоқ — қалай бастау керекКод жазбай-ақ жұмыс істеудің бес жолы: кабинеттен қолмен счёт, тұрақты төлем сілтемелері, Telegram бот, WooCommerce/OpenCart модульдері және Tilda форма-хугы.Бастау үшін не керекТөрт нәрсе: Kaspi Pay бизнес-аккаунты, оның баптауына кіру құқығы, SMS қабылдайтын бөлек нөмір және сервер жағын жаза алатын адам. Соңғысы міндетті емес.Бір аккаунтта бірнеше ұйымБір нөмірмен кіріп, бірнеше ұйымды бөлек жүргізуге болады. Әр ұйымның өз кассирі, кілттері, webhook-і және тарифі. Тарифтер қосылмайды — әрқайсысы бөлек төленеді.Бір ұйымға бірнеше кассир қосуға бола маИә, болады. Әр кассир — бөлек нөмір және бөлек байланыс. Негізгі кассир деген не, API кілтті нақты кассирге қалай байлау керек және айлық лимит қалай есептеледі.Бірінші счётты қалай жасау керекЕкі жолы бар: кабинеттен қолмен екі өрісті толтырып немесе API арқылы бір сұраумен. Алдымен sandbox-та жасап, төлемді симуляциялап көру ұтымды.ЖИ-агентке интеграцияны тапсыруClaude, Cursor немесе басқа ЖИ-агент Qut Pay интеграциясын өзі жаза алады. Оған не беру керек, sandbox-та автономды цикл қалай құрылады және кілтті беру қауіпсіздігі.Кабинетке қалай кіру керекКіру телефон нөмірі арқылы, пароль жоқ. WhatsApp батырмасы, Telegram немесе код. Ең жиі қате — кассир нөмірімен кіруге тырысу, ол нөмір мүлде басқа нәрсеге арналған.Кабинетте не қайда тұрОн бөлімнің әрқайсысы не үшін керегі, жоғарғы жолдағы режим белгісі, ұйым ауыстырғышы, тіл мен қараңғы режим. Бір рет оқысаңыз, іздеп жүрмейсіз.Кассир қосылмай жатыр — себебі және шешіміСимптом бойынша диагностика: Kaspi пароль немесе видеоверификация сұраса, ЖСН сұраса, SMS келмесе немесе код өтіп кетсе — әрқайсысының себебі мен шешімі. SMS уақыттары да осында.Кассир нөмірі мен өз нөміріңіз — айырмашылығыЖүйеде үш түрлі нөмір бар: жеке нөміріңіз, кассир нөмірі және клиенттің нөмірі. Әрқайсысы не үшін, қандай қате жиі кездеседі және өз нөміріңізді неге кассир қылуға болмайды.Кассир нөміріне қойылатын үш шартҚосылудың сәтті өтуі түгелдей осы үш шартқа байланысты: нақты SIM, иесінің ЖСН-іне ЖК/ЖШС тіркелмеген болуы және нөмірде тек «Кассир» рөлі. Нөмірді алдын ала қалай таңдау керек.Клиент қалай төлейдіКлиентке жетудің үш жолы бар: QR сканерлеу, төлем сілтемесін ашу және телефон нөмірі арқылы Kaspi қосымшасына счёт жіберу. Әрқайсысы қашан ыңғайлы және мерзімдері қандай.Клиент не көредіКлиент Kaspi қосымшасында нені көреді: сома, сипаттама және кассир нөмірі. Сипаттама шектеулері, төлемнен кейінгі чектер және сіздің ішкі деректеріңіздің көрінбейтіні.Қай тарифті таңдау керекТариф айына шығаратын счёт санына қарай таңдалады, төлем сомасына емес. Үш тарифтің кестесі, өз санын қалай есептеу керек және тәуліктік сан неге бизнес лимиті емес.Қолдауға қалай жазу керекАлдымен білім базасынан іздеңіз, содан кейін кабинеттегі Қолдау бөлімі, WhatsApp, Telegram немесе email. Бірінші хатқа нені қосу керек және ол неге жауапты бір айналымға жылдамдатады.Қосу қауіпсіз бе және сервис қалай құрылғанСервис Kaspi Pay-дегі шектеулі «Кассир» рөлі арқылы жұмыс істейді: счёт шығарады, күйін көреді, өз счёттары бойынша қайтару жасайды. Ақшаға қол жеткізе алмайды. Нені сақтаймыз және қалай ажыратасыз.Қызметкерге кабинетке рұқсат беруКабинетте үш рөл бар: owner, developer, manager. Әрқайсысы нені көреді және не істей алады, қызметкерді қалай шақыру керек және ол жұмыстан кетсе не істеу керек.Нақты режимге көштім, бірақ істемей жатырLive-қа көшкеннен кейін счёт жасалмаса немесе төлем келмесе — бес минуттық тексеру реті. Кілт, кассир, тариф, webhook адресі және режимнің өзі, әрқайсысына нақты қадам.Нақты режимге қалай көшу керекSandbox-тан live-қа көшу реті: алдын ала чек-парақ, режимді ауыстыру, кілтті qp_test_ -тен qp_live_ -ке ауыстыру және бірінші нақты төлемді кіші сомамен тексеру.Сынақ мерзімі: қанша және не кіредіСынақ — 7 күн, тәулігіне 50 счёт. Ең бастысы: ол тіркелген күннен емес, бірінші нақты счёттан басталады. Сондықтан асықпай дайындалып, сосын бастауға болады.Тарифті қалай төлеу керекТариф кабинеттегі Тариф бөлімінен төленеді. Төлегеннен кейін бірден белсенді болмаса не істеу керек: күту, күйді жаңарту, төлем тарихын қарау және қолдауға не жазу керек.Терминдер сөздігіҚолдауға келетін сұрақтардың бір бөлігі — терминді түсінбегеннен. Мұнда 25 термин қарапайым тілмен, әрқайсысына бір-екі сөйлем және мысал.Ұйым деректерін толтыруҰйым атауы, дүкен атауы, заңды деректер мен байланыс кабинеттегі Баптау бөлімінде толтырылады. Клиент қайсысын көреді, чекте не жазылады және атауды қалай өзгертуге болады.Kaspi кассирін қалай қосу керекЕкі бөліктен тұратын қадамдық нұсқаулық: алдымен Kaspi Pay қосымшасында «Кассир» рөлін ашасыз, содан кейін кабинетте нөмірді SMS коды арқылы байланыстырасыз. Бәрі 2-3 минут алады.Qut Pay деген не және қалай жұмыс істейдіQut Pay — Kaspi Pay үстінде жұмыс істейтін тәуелсіз сервис: «Кассир» рөлі арқылы Kaspi QR төлемдерін қабылдауға арналған API мен кабинет. Ақша тіке сіздің Kaspi шотыңызға түседі, бізде ешқашан болмайды.Sandbox пен нақты режимнің айырмашылығыSandbox-та Kaspi мүлде шақырылмайды, ақша жүрмейді, кассир де керек емес — төлемді өзіңіз симуляциялайсыз. Екі режимнің толық салыстыруы және нақты режимге көшкенде нені тексеру керек.Telegram ботын қосуКабинеттегі Баптау бөлімінен байланыстыру кодын аласыз да, @qutpaybot ботына /start КОД деп жазасыз. Жеке чатқа да, топқа да қосуға болады. Қандай хабарламалар келеді және қандай командалар бар.

Мәселені шешу32

Бірдеңе істемей қалса, нені тексеру керек: төлем, кассир, webhook, қайтару.

«Счёт табылмады» деген қате — себебі және шешіміinvoice_not_found қатесінің төрт себебі бар: идентификатор қате, счёт басқа режимде жасалған, кілт басқа кассирге байланған немесе счёт басқа ұйымдікі. Тексеру реті.«Ұйым архивте» деген қате — не істеу керекAPI organization_inactive (410) қайтарса, кілт емес, ұйым белсенді емес. Жаңа кілт жасау көмектеспейді. Себептері, дұрыс кілтті таңдау және қолдауға жазғанда нені көрсету керек.Екі рет қайтарып жіберуден қалай сақтану керекrefund_unknown және refund_pending_unknown келгенде қайталау — ақшаны екі рет қайтарудың ең қысқа жолы. Оның орнына счёттың күйін оқу керек. Идемпоттылық, ішінара қайтару есебі және журнал жүргізу.Жазылым бойынша счёт шықпай жатырЖазылым кестеге сай счёт шығармаса, тексеретін алты нәрсе бар: күйі, келесі кезек уақыты, қайталау сатысы, өткізіп алу саясаты, кассир және тариф лимиті. lastRunStatus пен lastError қайдан оқылады.Кабинетке кіре алмай жатырмынКабинетке пароль жоқ, кіру нөмір арқылы. Ең жиі қате — кассир нөмірімен кіруге тырысу. Код келмесе не істеу керек және кабинет неге бос болып көрінеді.Кассир ауысты немесе нөмірі өзгерді — не істеу керекКассир жұмыстан кетті, нөмірі ауысты, SIM жоғалды немесе бизнес иесі ауысты. Әр жағдайда кабинетте нені басу керек және бұрынғы счёттарға не болады.Кассир байланысы үзілді — қалай қалпына келтіруСчёттар кенет жасалмай қалса, Kaspi сессиясы үзілген. Қалпына келтіру бір минут алады. Себебі, қадамдары және қайталанбауы үшін не істеу керек.Кассир басқа Kaspi ұйымына тиесіліKaspi ұйымы бірінші байланыста бекітіледі және кейін өзгермейді. Сондықтан қосылатын кассир сол ұйымның қызметкері болуы керек. Бірнеше ЖК/ЖШС болса қалай жоспарлау керегі.Кеш келген төлем — счёт жабылған, ал ақша келдіБолдырылған немесе мерзімі өткен счётқа ақша кешігіп келуі мүмкін. Ондайда invoice.paid оқиғасы late: true белгісімен келеді. Не істеу керек және кодта бұған қалай дайын болу керек.Клиентке төлем келмей жатырСчёт жасалды, бірақ клиенттің телефонына ештеңе келмеді немесе QR ашылмайды. Ең жиі себебі — тест режимі қосулы қалып қойған. Алты қадамдық тексеру реті.Клиентте Kaspi қосымшасы жоқ — қалай төлетуге боладыТелефонға счёт (kind phone) клиенттің Kaspi қосымшасына келеді, қосымша болмаса ол жетпейді. Орнына QR немесе төлем сілтемесін беру керек. Алдын ала қалай тексеруге болады.Қайтару өтпей жатырҚайтару қатесін код бойынша ажырату: счёт қайтаруға жарамайды, сома дұрыс емес, Kaspi орындамады немесе нәтижесі белгісіз. Қайсысында қайталауға болады, қайсысында мүлде болмайды.Лимитке жеттім — не істеу керекtariff_limit_reached пен tariff_daily_burst — екі басқа нәрсе. Біріншісі айлық бизнес лимиті, екіншісі кодтағы циклден қорғаныс. Қалай ажырату және әрқайсысына не істеу керек.Мәселе менде ме, Kaspi-де ме — екі минуттық диагностикаҮш сұраққа жауап беріп, ақаудың қай жақта екенін анықтайсыз: интеграцияда, Kaspi байланысында әлде қызметте. Әр жауапқа нақты әрекет және қолдауға не жинау керегі.Сома дұрыс емес немесе тиын жоғалып жатырТелефонға шығарылған счёт бүтін теңге қабылдайды, QR счёт ең көбі екі ондық. amount_must_be_whole_tenge қатесінің себебі, дөңгелектеуді өз жағыңызда қалай дұрыс істеу керек.Счёт төленді, ал ақша түспедіҮш себебі бар: тест режимі қосулы, ақшаны дұрыс емес жерден іздеп жүрсіз, немесе кассир басқа Kaspi ұйымына тиесілі. Әрқайсысын қалай тексеру керек және не істеу керек.Счёт pending күйінде тұрып қалдыPending — қате емес, қалыпты күй: счёт шығарылған, клиент әлі төлемеген. Қанша тұрады, қашан expired болады, біз оны қалай тексереміз және шынымен қашан алаңдау керек.Счёттар жаппай құлап жатыр — не істеу керекБір мезетте көп счёт жіберсеңіз, Kaspi кассирдің сұрау жиілігін шектеуі мүмкін. Автоматты қайталау жоқ. Пауза беру, кезекпен жіберу және қате кодтарын ажырату тактикасы.Счёттар қосарланып жатырБір тапсырысқа бірнеше счёт шығып жатса, алдымен ағынды тоқтату керек: API кілтті жойсаңыз, интеграция сол сәтте тоқтайды. Сосын себебін тауып, идемпоттылық қосасыз.Тест режимі қосулы қалып қойғанСчёттар жасалып жатыр, бірақ клиентке келмейді және ақша түспейді — бұл sandbox режимінің ең танымал белгісі. Қалай тексеру, қалай көшу керек және тест счёттарына не болады.Төлем баяу расталады — неге және не істеу керекКлиент төледі, бірақ счёт бірден paid болмайды. Мұнда тексеру жиілігі жасына қарай қалай өзгеретіні, іс жүзіндегі уақыт және кідіріске сезімтал сценарийде не істеу керегі жазылған.Экспорт ашылмайды немесе дұрыс емес болып көрінедіЖүктелген CSV файлда әріптердің орнына иероглиф, бәрі бір бағанға сыйып кеткен немесе счёттар жетіспейді. Кодтау, бөлгіш, сүзгілер және бухгалтерияға дұрыс беру жолы.API 401 қайтарады — кілт қабылданбай жатыр401 unauthorized дегені — сұрауыңызда жарамды API кілт жоқ. Себептері, тексеру реті және жұмыс істейтін curl мысалы. Көбіне тақырып атауы немесе Bearer префиксі кінәлі.API 403 қайтарады — құқық жетпей тұр403 дегені кілтіңіз танылды, бірақ бұл әрекетке рұқсат жоқ. Бес түрлі себебі бар: scope жетпеуі, тариф, бөтен ұйым, кілт байланған кассир, sandbox әрекеті. Әрқайсысын қалай ажырату керек.API кілт сыртқа шығып кетті — шұғыл не істеу керекКілт репозиторийге, чатқа немесе бөтен қолға түссе, бірінші минутта не істеу керек: жою, жаңасын жасау, соңғы счёттарды тексеру. Кілтпен не істеуге болатыны және алдын алу ережелері.API кілтті жойып алдым — не болады және не істеу керекЖойылған кілт сол сәтте істемей қалады және оны қайтару мүмкін емес. Счёттар мен ақшаға әсері жоқ. Жаңа кілт жасап, интеграцияда ауыстыру реті және кассирге байлауды ұмытпау.Kaspi SMS коды келмейдіКассирді байланыстырғанда SMS келмесе, себебі әдетте төртеудің бірі: SIM өшік, нөмір Kaspi Pay-де қызметкер ретінде қосылмаған, код өтіп кеткен немесе Kaspi код беруді уақытша шектеген.QR «кейінірек көріңіз» деп тұрКлиент QR-ды скандағанда қате хабар шықса, көбіне сканерлеу терезесі өтіп кеткен. Терезені Kaspi белгілейді, оны expiresAt өрісінен алыңыз. Басылған QR мен экрандағы QR айырмашылығы.Telegram бот үндемейді — тексеру ретіБот жауап бермесе немесе хабарлама жібермесе, себебі төртеудің бірі: чат ұйымға байланыспаған, бот бөгелген, топта құпиялық режимі қосулы немесе хабарлама түрі өшірілген. Ретімен тексеру.Webhook келмей жатыр — себебін қалай табу керекСчёт төленді, бірақ сіздің серверіңізге хабарлама жетпеді. Диагностиканы қай жерден бастау керек, ең жиі кездесетін себеп қайсы және оны бір сынаумен қалай анықтауға болады.Webhook қолтаңбасы сәйкес келмейдіҚолтаңба HMAC-SHA256(secret, timestamp + "." + rawBody) арқылы есептеледі. Ең жиі қате — денені JSON-ға айналдырып, қайта жолға түрлендіру. Raw body алудың Express, Laravel, Django мысалдары.WooCommerce немесе OpenCart плагині істемей жатырПлагин счёт жасамаса немесе тапсырыс күйі өзгермесе, тексеретін төрт нәрсе бар: кілт, режим сәйкестігі, webhook адресінің жариялығы және дүкен журналы. Қай симптом нені білдіреді.

Бизнесіңізге25

Kaspi қабылдау сіздің сценарийіңізде қалай жұмыс істейді.

1С-тен Kaspi счёттарын шығару1С-тегі құжаттан Kaspi QR счётын шығару: HTTP-сервис арқылы қосылу, топтап жіберу, күйді сұрау немесе webhook қабылдау, externalOrderId арқылы құжатпен сәйкестендіру және қайтару.Автомектеп пен курстарғаОқу ақысын Kaspi арқылы жинау: кабинеттен қолмен счёт, бөліп төлеуге жазылым, топтап счёт шығару және төлем сілтемесі. Топ бойынша есеп қалай жүреді.Вендинг автоматына терминалсыз төлемАвтомат экранында динамикалық QR, клиент сканерлейді, webhook келеді, контроллер тауарды береді. Су, кофе және снек автоматтары үшін схема, жабдық жағы және QR терезесі.Жазылымдық бизнескеЖазылым — счётты кестеге сай автоматты шығару, ақша клиенттің шотынан өздігінен шешілмейді. Қайталау сатысы, өткізіп алу саясаты, pause/resume, ескерту және есеп.Жалға беру бизнесінеПауэрбанк станциясы, велосипед, самокат, құрал-жабдық, киім. Депозитті алу мен қайтару, мерзімдік төлем, QR арқылы автоматты беру және ішінара қайтару.Жеткізу қызметінеКурьер жеткізу сәтінде счёт шығарады, клиент өз телефонынан төлейді. Telegram бот немесе курьер қосымшасы арқылы, тапсырыс нөмірі мен метадеректер, қайтару және жеткізілмеген тапсырыс.Интернет-дүкенге Kaspi төлемін қосуСебеттен «төленді» күйіне дейінгі толық схема: счёт, төлем беті, webhook. Tilda, WooCommerce, OpenCart және өзі жазылған сайт үшін кодсыз жол мен API жолы.Көтерме саудағаІрі сомалы счёт, тапсырыс нөмірі бойынша есеп айырысу, бір сұрауда 100-ге дейін счёт, тұрақты клиенттерге жазылым, 1С-пен байланыстыру, ішінара төлем мен қайтару.Маркетплейс пен агрегаторғаӘр сатушының ақшасы өз Kaspi шотына түсуі керек болса: әрқайсысына өз ұйымы мен кассирі, кілттерді бөлу, бөлек webhook. Комиссияны қалай ұстау мәселесі.Медициналық орталыққаҚабылдау ақысы, алдын ала төлеммен брондау, талдау нәтижесіне төлем, чек және қайтару. Ең бастысы — пациент деректерін счёт сипаттамасына жазбау ережесі.Мейрамхана мен кафегеҮстелдегі QR, кассадағы экран, есеп-шот сомасы бойынша счёт, бөліп төлеу, даяшы бойынша есеп және жеткізу тапсырысы — залда Qut Pay қалай жұмыс істейтінінің толық сценарийі.Мобильді қосымшаға қосуДұрыс реті: қосымша → өз серверіңіз → Qut Pay → Kaspi. API кілт APK немесе IPA ішінде болмауы керек. payUrl ашылғанда не болады және App Store мен Play Market ережесі.Онлайн мектеп пен курс платформасынаКурсқа кіруді сатудан бастап, webhook арқылы қолжетімділікті ашуға, кезеңдік төлемге, топтық тариф пен жеңілдікке дейін. Мобильді қосымшаңыз болса App Store мен Play ережесін де қараңыз.Офлайн нүктеде QR арқылы қабылдауКассир экранда динамикалық QR көрсетеді, клиент сканерлейді. Сканерлеу терезесі шектеулі — уақытын expiresAt өрісінен алыңыз. Қашан QR, қашан телефонға счёт ыңғайлы және бірнеше нүктені қалай бөлу керек.Спортзал мен фитнескеАбонемент сату, мерзімді ұзарту, ай сайынғы счётты жазылыммен автоматтандыру, мұздату мен қайтару және турникетті webhook арқылы ашу — фитнес клубқа арналған толық сценарий.Сұлулық салоны мен барбергеЖазылу жүйесімен байланыстыру, алдын ала депозит, келмей қалған клиент, қайтару. Кодсыз жол мен API жолы, шебер бойынша бөлек есеп.Таксопаркке жүргізушілерден төлем жинауЖүргізушілер тізімі бойынша топтап счёт шығару, идемпоттылық арқылы дубльден сақтану, әр элементтің қатесін бөлек өңдеу және күнделікті жинауды автоматтандыру.Тұрақ пен шлагбаумғаШығу тұсындағы экранда QR немесе билет нөмірі бойынша счёт, төлем расталғанда webhook IP-реле арқылы шлагбаумды ашады. Динамикалық және басылған QR, көлік нөмірі, кідіріс.Фрилансер мен жеке маманғаЕң қарапайым сценарий: кабинетке кіресіз, счёт шығарасыз, сілтемені клиентке жібересіз. Тұрақты сілтеме, ашық сомалы сілтеме, Telegram боттан счёт. Код керек емес.Іс-шара мен билет сатуғаАлдын ала сату төлем сілтемесі немесе сайттағы форма арқылы, есік алдында QR немесе телефонға счёт, топтап счёт, орын нөмірін metadata-ға жазу және жаппай қайтару.CRM жүйесіне қосуBitrix24, amoCRM, Kommo, Altegio, МойСклад — дайын модуль жоқ, бірақ CRM сыртқа HTTP сұрау жібере алса жеткілікті. Мәміле төлем сатысына өткенде счёт шығады, төленгенде карточка өзі жылжиды.Instagram арқылы сатуғаДиректтегі жұмыс реті: төлем сілтемесі, кабинеттен қолмен счёт, Telegram боттан счёт шығару. Бәрі кодсыз істейді. Тапсырысты шатастырмай есеп жүргізу жолы.SaaS платформасына: клиенттер атынан төлем қабылдауПлатформаңыздың клиенттері Kaspi төлемін өз шоттарына жинай алады. Кілттерді сақтау, клиент атынан счёт шығару, Partner API арқылы толық автоматтандыру және әр клиентке бөлек webhook.Telegram ботында тауар сатуБот → сіздің сервер → счёт → клиентке push немесе сілтеме → webhook → тауарды беру. Төленбеген счёттардың жиналуынан қорғану, бірнеше бренд, Python пен Node мысалы.TikTok тікелей эфирінде сатуғаЭфир кезінде счётты секундпен шығару: телефон нөмірі бойынша push ең ыңғайлысы. Telegram боттан /invoice, экранда QR көрсету, көмекшімен жұмыс және төлемді бақылау.

Анықтамалық41

Әзірлеушіге арналған техникалық егжей-тегжей.

Ашық сомалы төлем сілтемелері — соманы клиент енгізедіСома алдын ала белгіленбейтін тұрақты төлем сілтемесі: қайырымдылық, шәкіртақы, кеңес беру, әртүрлі бағадағы қызмет үшін. Ең аз және ең көп соманы шектеу, клиенттен қандай өріс сұрау, есепті қалай жүргізу.Деректер және құпиялық — не сақталады, кім көредіQut Pay счёт, клиент және кассир деректерінің қайсысын сақтайды және қайсысын мүлдем сақтамайды, оларды кім көреді, қанша уақыт тұрады. Счёт сипаттамасы мен metadata-ға нені жазбау керек.Жазылым API — кестеге сай счёт шығаруЖазылым счётты кестеге сай автоматты шығарады, ал әр төлемді клиент өзі растайды. Барлық өрістер, аралықтар, қайталау сатысы, өткізіп алу саясаты, pause/resume/run әдістері және күй өрістері.Идемпоттылық: қайталаудан қорғануIdempotency-Key тақырыбы қалай жұмыс істейді, кілтті қалай құру керек, externalOrderId-дің рөлі неде, webhook өңдеуде және қайтаруда қайталанудан қалай сақтану керек.Интеграция қауіпсіздігі: 12 тармақQut Pay интеграциясын қауіпсіз құрудың 12 нақты тармағы: кілтті қайда сақтау, scope-ты қалай шектеу, webhook қолтаңбасын қалай тексеру, журналға нені жазуға болмайды, кілт сыртқа шықса не істеу керек.Интеграцияны қалай сынау керекSandbox-та өтуге тиіс сценарийлер тізімі: сәтті төлем, болдырмау, мерзімі өту, толық және ішінара қайтару, кеш төлем. Webhook-ты қалай сынау, қандай шекті жағдайларды тексеру керек және автоматты тестті қалай жазу керек.Қайтару API — толық және ішінара қайтаруPOST /invoices/{id}/refund әдісінің толық анықтамасы: сұрау өрістері, толық және ішінара қайтару, сома шектеуі, барлық қате коды, refund_unknown келгенде не істеу керек және қандай оқиғалар жіберіледі.Қателер каталогы — API не қайтарады және не істеу керекQut Pay API-інің барлық негізгі қате кодтары топтап берілген: авторизация, Kaspi байланысы, счёт, қайтару, тариф лимиті, webhook, жазылым. Әрқайсысының себебі және шешімі.Құқықтар (scopes) — кілт нені істей аладыАлты scope-тың толық кестесі: invoices:read, invoices:write, refunds:write, subscriptions:manage, webhooks:manage, partner:manage. Әрқайсысы қай әдістерді ашады, ең аз құқық принципі және insufficient_scope қатесі.Қызмет күйін тексеруGET /api/v1/status эндпоинті не қайтарады, оны мониторингке қалай қосу керек және мәселе бізде ме, Kaspi-де ме, әлде өз жағыңызда ма дегенді қалай ажырату керек. Өз жағыңызда бақылайтын үш көрсеткіш.Нүктелер бойынша бөлек есеп — әр дүкенге өз кілтіБірнеше дүкен, филиал немесе нүкте болғанда счёттарды қалай бөлу керек: әр нүктеге бөлек API кілт пен webhook, кілтті кассирге байлау, нені бөлуге болады және нені болмайды, қашан бөлек ұйым ашу керек.Продакшенге шығу чек-парағыНақты режимге көшер алдында өтетін он екі тармақ: кассир, live кілт, webhook, қолтаңба, идемпоттылық, кеш төлем, қате өңдеу, журнал, тариф пен лимит, Telegram ескертуі, қайтару реті, бірінші нақты төлем.Реферал бағдарламаӘр мерчанттың кабинетінде жеке реферал коды мен сілтемесі бар. Сол сілтемемен келген клиент тариф төлеген сайын сомадан 20 пайыз есептеледі. Қалай жұмыс істейді, есеп қайда көрінеді және төлем қалай жасалады.Рөлдер мен құқықтар — кім нені істей аладыКабинеттегі үш рөл — иесі, әзірлеуші, менеджер. Әр рөл қай бөлімді көреді және қандай әрекет жасай алады: счёт, қайтару, кассир, API кілт, webhook, тариф, қызметкер. Соңғы иені қорғау және қызметкер кеткенде не істеу керек.Сұрау жиілігінің шектеулеріБір API кілт минутына қанша сұрау жібере алады, 429 жауабының үш түрін қалай ажырату керек, Retry-After тақырыбын қалай оқу керек және бэкофф стратегиясын кодта қалай жазу керек.Счёт жасау: барлық өрістерPOST /api/v1/invoices эндпоинтінің толық анықтамасы — әр өрістің типі мен шектеуі, жауаптағы барлық өріс, curl мен Node мысалдары, qr мен phone айырмашылығы және жиі кездесетін қателер.Счёттың жарамдылық мерзімі — қанша тұрады және не істеу керекQR счёттың сканерлеу терезесі мен телефонға счёттың мерзімі неден анықталады, expiresAt өрісін қалай дұрыс оқу керек, expired күйінен кейін не істеу керек және неге жабылған счётқа ақша кешігіп келуі мүмкін.Счёттың өмірлік цикліСчёттың барлық күйлері мен ауысулары, қай күйде қандай webhook оқиғасы келеді, қайсысы ашық және қайсысы төленген деп есептеледі, кеш келген төлемді қалай өңдеу керек.Тарифтер және лимиттер — толық анықтамаҮш тарифтің бағасы мен айлық счёт лимиті, тәуліктік қорғаныс саны, tariff_limit_reached пен tariff_daily_burst айырмашылығы, сынақ мерзімі және сұрау жиілігінің шектеулері — бір бетте.Топтап счёт жасау — бір сұрауда 100 счётқа дейінPOST /api/v1/invoices/bulk әдісі: бір сұрауда 1-100 счёт, әр элемент бөлек тексеріледі, жауап құрылымы, қателерді элемент бойынша өңдеу, идемпоттылық және тариф лимитіне әсері.Төлем сілтемелері — тұрақты мекенжай арқылы қабылдауqut.kz/p/<slug> түріндегі тұрақты төлем сілтемесі: өз атауыңызды қою, белгіленген және ашық сома, тоқтату мен қайта қосу, счёт сілтемесінен айырмашылығы, есеп және қате кодтары.Фискалды чек: кім жауапты және қашан автоматты шығадыKaspi QR арқылы төлемде чекті көбіне Kaspi өзі шығарады. Қолма-қол ақша мен басқа банктің POS-ы автоматты чек жасамайды. Кім жауапты, ОФД қайда, біздің чек бетінен айырмашылығы.Чектер және оларды клиентке жеткізуQut Pay-дің чек беті, оның нөмірленуі және не көрсететіні. Email арқылы жіберу, API мен webhook-тағы өрістер, Kaspi чегінің сілтемесі неге клиентке ашылмайды.API кілттер — жасау, сақтау, ауыстыруqp_live_ және qp_test_ кілттерінің айырмашылығы, кілтті кабинетте жасау, қайда сақтау керек және қайда мүлдем сақтамау керек, әр интеграцияға бөлек кілт, үзіліссіз ауыстыру реті және жою салдары.API кілтті кассирге байлауБір ұйымда бірнеше жоба немесе нүкте болғанда әр кілтті өз кассиріне байлауға болады. Байланған кілт нені көреді, нені көрмейді, кассирді неге жою мүмкін емес және кабинетте бұны қалай баптау керек.CSV экспорт және есеп: счёттарды тізім етіп алуСчёттарды кабинеттен және API арқылы шығару, сүзгілер мен бағандардың мағынасы, UTF-8 кодтауы, Excel-дегі иероглиф және Kaspi Pay есебімен салыстыру — сандар неге дәл сәйкес келмеуі мүмкін.Metadata және тапсырыс нөміріexternalOrderId мен metadata өрістерінің айырмашылығы, олардың webhook-та қалай қайта келетіні, metadata ішіне нені жазуға болады және нені ешқашан жазбау керек — нақты мысалдармен.n8n автоматтандыру: Qut Pay-ді дайын workflow-тармен қосуn8n үшін екі дайын workflow: счёт жасау және webhook қабылдау. Импорттау, credential, webhook құпиясы, қолтаңбаны тексеру және «форма → счёт → төлем → хабарлама» сценарийі.Node.js SDKQut Pay-дің Node.js клиентін орнату, счёт жасау, күйін сұрау, қайтару және webhook қолтаңбасын тексеру. Толық жұмыс істейтін Express мысалы raw body-мен және қате өңдеу.OpenCart 4 кеңейтуіQut Pay кеңейтуін OpenCart 4 дүкеніне орнату, кілт пен webhook баптау, тапсырыс күйлерін таңдау, қайтару жасау және жиі кездесетін мәселелердің шешімі.Partner APIИнтеграторларға, веб-студияларға және франшизаларға арналған API: клиентке ұйым ашу, оның Kaspi кассирін қосу, кілт беру, live режимге өткізу және статистика алу. Клиент кабинетке кірмей-ақ қосыла алады.PHP SDKQut Pay-дің PHP клиентін жобаға қосу, счёт жасау, қайтару және webhook қолтаңбасын тексеру. Таза PHP пен Laravel мысалдары, raw body-ны дұрыс алу және ApiException арқылы қате өңдеу.Python SDKQut Pay-дің Python клиентін орнату, счёт жасау, күйін сұрау, қайтару және webhook қолтаңбасын тексеру. Django мен Flask мысалдары, raw body-ны дұрыс алу және QutPayError арқылы қате өңдеу.QR счёт пен телефонға счёт — қайсысын таңдау керекЕкі счёт түрінің толық салыстыруы: kind мәні, клиент не істейді, нөмір керек пе, сипаттама мен сома шектеулері, мерзімі және қай сценарийге қайсысы келеді.Sandbox-та төлемді симуляциялауsimulate эндпоинті арқылы sandbox счётының күйін өзгерту: paid, failed, expired. Kaspi шақырылмайды, webhook нағыз төлемдегідей келеді. Сынау циклі және автоматты тест жазу.Telegram бот командалары: толық тізім@QutPayBot-тың барлық командасы — счёт жасау, бүгінгі түсім, соңғы счёттар, күйі, болдырмау, қолдау. Қазақша-орысша баламалары, топта жұмыс істеуі және қандай хабарламалар келеді.Tilda және кез келген форма: кодсыз төлем қабылдауФорма-хук — формаңызды Qut Pay адресіне бағыттасаңыз, жіберілген сәтте счёт жасалады. Өрістерді сәйкестендіру, redirect режимі, кабинетте баптау және хукты тоқтату.Webhook баптауКабинетте webhook адресін қосу, оқиғаларды таңдау, құпияны сақтау, тақырыптар мен дене пішімі, 11 рет қайталау кестесі, журналды оқу, адресті сынау және қайта бағыттау ережесі.Webhook қауіпсіздігі және қолтаңбаны тексеруҚолтаңба қалай құралады, неге raw body міндетті, timestamp-ты қалай тексеру керек, Express, Laravel, Django және таза Node үшін код мысалдары, идемпотентті өңдеу және жиі кездесетін қателер.Webhook пен күйді сұрау: қайсысы қашанWebhook — негізгі әдіс, бірақ жеткізу кепілдігі абсолютті емес. Кідіріске сезімтал сценарийлерде екеуін қатар жүргізу керек: қалай, қандай жиілікпен және неге бұл артық жұмыс емес.WooCommerce плагиніQut Pay плагинін WordPress дүкеніне орнату, API кілт пен webhook баптау, тапсырыс күйінің қалай ауысатыны, қайтару, чек және жиі кездесетін мәселелердің шешімі.

Сұрағыңыз қалды ма? WhatsApp +77788813333 · kazprose@gmail.com
Кабинеттен де жазуға болады: Қолдау.

Qut Pay — тәуелсіз сервис, «Kaspi Bank» АҚ-мен аффилирленбеген. Kaspi және Kaspi Pay — құқық иесінің тауар белгілері.