{"count":138,"categories":[{"key":"start","kk":"Бастау","ru":"Начало работы"},{"key":"problems","kk":"Мәселені шешу","ru":"Решение проблем"},{"key":"business","kk":"Бизнесіңізге","ru":"Для вашего бизнеса"},{"key":"reference","kk":"Анықтамалық","ru":"Справочник"}],"articles":[{"slug":"after-live-not-working","category":"start","updated":"2026-09-14","related":["switch-to-live","sandbox-vs-live","api-401","api-403","is-it-us-or-kaspi"],"langs":{"kk":{"title":"Нақты режимге көштім, бірақ істемей жатыр","description":"Live-қа көшкеннен кейін счёт жасалмаса немесе төлем келмесе — бес минуттық тексеру реті. Кілт, кассир, тариф, webhook адресі және режимнің өзі, әрқайсысына нақты қадам.","url":"https://api.qut.kz/kb/after-live-not-working","md":"https://api.qut.kz/kb/after-live-not-working.md"},"ru":{"title":"Перешёл в боевой режим — не работает","description":"Если после перехода счета не создаются или оплата не доходит — проверка за пять минут. Ключ, кассир, тариф, адрес вебхука и сам режим, по каждому пункту конкретное действие.","url":"https://api.qut.kz/kb/ru/after-live-not-working","md":"https://api.qut.kz/kb/ru/after-live-not-working.md"}}},{"slug":"ai-agent-setup","category":"start","updated":"2026-09-14","related":["sandbox-simulate","testing-integration","api-keys","security-checklist","switch-to-live"],"langs":{"kk":{"title":"ЖИ-агентке интеграцияны тапсыру","description":"Claude, Cursor немесе басқа ЖИ-агент Qut Pay интеграциясын өзі жаза алады. Оған не беру керек, sandbox-та автономды цикл қалай құрылады және кілтті беру қауіпсіздігі.","url":"https://api.qut.kz/kb/ai-agent-setup","md":"https://api.qut.kz/kb/ai-agent-setup.md"},"ru":{"title":"Поручить интеграцию ИИ-агенту","description":"Claude, Cursor или другой ИИ-агент может написать интеграцию с Qut Pay сам. Что ему дать, как устроен автономный цикл в песочнице и почему боевой ключ агенту давать нельзя.","url":"https://api.qut.kz/kb/ru/ai-agent-setup","md":"https://api.qut.kz/kb/ru/ai-agent-setup.md"}}},{"slug":"api-401","category":"problems","updated":"2026-09-14","related":["api-403","is-it-us-or-kaspi","mass-invoice-failures","what-is-qutpay"],"langs":{"kk":{"title":"API 401 қайтарады — кілт қабылданбай жатыр","description":"401 unauthorized дегені — сұрауыңызда жарамды API кілт жоқ. Себептері, тексеру реті және жұмыс істейтін curl мысалы. Көбіне тақырып атауы немесе Bearer префиксі кінәлі.","url":"https://api.qut.kz/kb/api-401","md":"https://api.qut.kz/kb/api-401.md"},"ru":{"title":"API отвечает 401 — ключ не принимается","description":"401 unauthorized означает, что в запросе нет действующего API-ключа. Причины, порядок проверки и рабочий пример curl. Чаще всего виноват заголовок или префикс Bearer.","url":"https://api.qut.kz/kb/ru/api-401","md":"https://api.qut.kz/kb/ru/api-401.md"}}},{"slug":"api-403","category":"problems","updated":"2026-09-14","related":["api-401","is-it-us-or-kaspi","two-cashiers","cashier-number-requirements"],"langs":{"kk":{"title":"API 403 қайтарады — құқық жетпей тұр","description":"403 дегені кілтіңіз танылды, бірақ бұл әрекетке рұқсат жоқ. Бес түрлі себебі бар: scope жетпеуі, тариф, бөтен ұйым, кілт байланған кассир, sandbox әрекеті. Әрқайсысын қалай ажырату керек.","url":"https://api.qut.kz/kb/api-403","md":"https://api.qut.kz/kb/api-403.md"},"ru":{"title":"API отвечает 403 — не хватает прав","description":"403 значит, что ключ распознан, но на это действие прав нет. Причин пять: не хватает scope, неактивный тариф, чужая организация, привязка ключа к кассиру, действие только для песочницы.","url":"https://api.qut.kz/kb/ru/api-403","md":"https://api.qut.kz/kb/ru/api-403.md"}}},{"slug":"api-key-connection","category":"reference","updated":"2026-09-14","related":["api-keys","two-cashiers","api-403","invoice-not-found","multi-point-reporting"],"langs":{"kk":{"title":"API кілтті кассирге байлау","description":"Бір ұйымда бірнеше жоба немесе нүкте болғанда әр кілтті өз кассиріне байлауға болады. Байланған кілт нені көреді, нені көрмейді, кассирді неге жою мүмкін емес және кабинетте бұны қалай баптау керек.","url":"https://api.qut.kz/kb/api-key-connection","md":"https://api.qut.kz/kb/api-key-connection.md"},"ru":{"title":"Привязка API-ключа к кассиру","description":"Когда в организации несколько проектов или точек, каждый ключ можно привязать к своему кассиру. Что видит привязанный ключ, чего не видит, почему нельзя удалить кассира и как настроить привязку в кабинете.","url":"https://api.qut.kz/kb/ru/api-key-connection","md":"https://api.qut.kz/kb/ru/api-key-connection.md"}}},{"slug":"api-keys","category":"reference","updated":"2026-09-14","related":["scopes","deleted-key","api-401","two-cashiers","sandbox-vs-live"],"langs":{"kk":{"title":"API кілттер — жасау, сақтау, ауыстыру","description":"qp_live_ және qp_test_ кілттерінің айырмашылығы, кілтті кабинетте жасау, қайда сақтау керек және қайда мүлдем сақтамау керек, әр интеграцияға бөлек кілт, үзіліссіз ауыстыру реті және жою салдары.","url":"https://api.qut.kz/kb/api-keys","md":"https://api.qut.kz/kb/api-keys.md"},"ru":{"title":"API-ключи — создание, хранение, ротация","description":"Чем отличаются ключи qp_live_ и qp_test_, как создать ключ в кабинете, где его хранить и где хранить категорически нельзя, зачем отдельный ключ на каждую интеграцию, как заменить ключ без простоя и что происходит при удалении.","url":"https://api.qut.kz/kb/ru/api-keys","md":"https://api.qut.kz/kb/ru/api-keys.md"}}},{"slug":"auto-check-payment","category":"reference","updated":"2026-10-25","related":["webhook-setup","polling-vs-webhook","webhook-signature-mismatch","invoice-lifecycle","late-payment"],"langs":{"kk":{"title":"Kaspi QR төленгенін автоматты қалай білуге болады","description":"Kaspi QR төлемін қолмен салыстырмай растаудың екі тәсілі — серверіңізге invoice.paid webhook-і және счёт күйін сұрау. Не келеді, қолтаңбаны қалай тексеру, тапсырысты қателесіп төленді деп белгілемеу, «рахмет» бетінде не істеу.","url":"https://api.qut.kz/kb/auto-check-payment","md":"https://api.qut.kz/kb/auto-check-payment.md"},"ru":{"title":"Как автоматически узнать, что Kaspi QR оплачен","description":"Два способа подтвердить оплату Kaspi QR без ручной сверки — webhook invoice.paid на ваш сервер и запрос статуса счёта. Что приходит, как проверить подпись, как не отметить заказ оплаченным по ошибке, что делать на странице «спасибо».","url":"https://api.qut.kz/kb/ru/auto-check-payment","md":"https://api.qut.kz/kb/ru/auto-check-payment.md"}}},{"slug":"bulk-invoices","category":"reference","updated":"2026-09-14","related":["mass-invoice-failures","error-catalog","api-keys","qr-vs-phone","duplicate-invoices"],"langs":{"kk":{"title":"Топтап счёт жасау — бір сұрауда 100 счётқа дейін","description":"POST /api/v1/invoices/bulk әдісі: бір сұрауда 1-100 счёт, әр элемент бөлек тексеріледі, жауап құрылымы, қателерді элемент бойынша өңдеу, идемпоттылық және тариф лимитіне әсері.","url":"https://api.qut.kz/kb/bulk-invoices","md":"https://api.qut.kz/kb/bulk-invoices.md"},"ru":{"title":"Массовое создание счетов — до 100 счетов в одном запросе","description":"Метод POST /api/v1/invoices/bulk: от 1 до 100 элементов за запрос, каждый проверяется отдельно, структура ответа, обработка ошибок поэлементно, идемпотентность и влияние на лимиты тарифа.","url":"https://api.qut.kz/kb/ru/bulk-invoices","md":"https://api.qut.kz/kb/ru/bulk-invoices.md"}}},{"slug":"cabinet-login","category":"start","updated":"2026-09-14","related":["cabinet-tour","what-you-need","glossary","first-invoice"],"langs":{"kk":{"title":"Кабинетке қалай кіру керек","description":"Кіру телефон нөмірі арқылы, пароль жоқ. WhatsApp батырмасы, Telegram немесе код. Ең жиі қате — кассир нөмірімен кіруге тырысу, ол нөмір мүлде басқа нәрсеге арналған.","url":"https://api.qut.kz/kb/cabinet-login","md":"https://api.qut.kz/kb/cabinet-login.md"},"ru":{"title":"Как войти в кабинет","description":"Вход по номеру телефона, пароля нет. Кнопка WhatsApp, Telegram или код. Самая частая ошибка — попытка войти с номера кассира, он предназначен совсем для другого.","url":"https://api.qut.kz/kb/ru/cabinet-login","md":"https://api.qut.kz/kb/ru/cabinet-login.md"}}},{"slug":"cabinet-tour","category":"start","updated":"2026-09-14","related":["cabinet-login","first-invoice","glossary","trial-period"],"langs":{"kk":{"title":"Кабинетте не қайда тұр","description":"Он бөлімнің әрқайсысы не үшін керегі, жоғарғы жолдағы режим белгісі, ұйым ауыстырғышы, тіл мен қараңғы режим. Бір рет оқысаңыз, іздеп жүрмейсіз.","url":"https://api.qut.kz/kb/cabinet-tour","md":"https://api.qut.kz/kb/cabinet-tour.md"},"ru":{"title":"Что где находится в кабинете","description":"Зачем нужен каждый из десяти разделов, что означает отметка режима вверху, где переключить организацию, язык и тёмную тему. Прочитать один раз — и больше не искать.","url":"https://api.qut.kz/kb/ru/cabinet-tour","md":"https://api.qut.kz/kb/ru/cabinet-tour.md"}}},{"slug":"cant-login","category":"problems","updated":"2026-09-14","related":["sms-not-arriving","cashier-number-requirements","payment-not-arriving","what-is-qutpay"],"langs":{"kk":{"title":"Кабинетке кіре алмай жатырмын","description":"Кабинетке пароль жоқ, кіру нөмір арқылы. Ең жиі қате — кассир нөмірімен кіруге тырысу. Код келмесе не істеу керек және кабинет неге бос болып көрінеді.","url":"https://api.qut.kz/kb/cant-login","md":"https://api.qut.kz/kb/cant-login.md"},"ru":{"title":"Не могу войти в кабинет","description":"Пароля в кабинете нет, вход по номеру телефона. Самая частая ошибка — пытаться войти с номера кассира. Что делать, если код не приходит, и почему кабинет выглядит пустым.","url":"https://api.qut.kz/kb/ru/cant-login","md":"https://api.qut.kz/kb/ru/cant-login.md"}}},{"slug":"cashier-not-connecting","category":"start","updated":"2026-10-16","related":["cashier-number-requirements","connect-cashier","what-is-qutpay","sandbox-vs-live"],"langs":{"kk":{"title":"Кассир қосылмай жатыр — себебі және шешімі","description":"Симптом бойынша диагностика: Kaspi пароль немесе видеоверификация сұраса, ЖСН сұраса, SMS келмесе немесе код өтіп кетсе — әрқайсысының себебі мен шешімі. SMS уақыттары да осында.","url":"https://api.qut.kz/kb/cashier-not-connecting","md":"https://api.qut.kz/kb/cashier-not-connecting.md"},"ru":{"title":"Кассир Kaspi не подключается — почему и что делать","description":"Диагностика по симптому: Kaspi просит пароль или видеоверификацию, спрашивает ИИН, не приходит SMS, не успеваете ввести код. Причина и решение для каждого случая, а также тайминги SMS.","url":"https://api.qut.kz/kb/ru/cashier-not-connecting","md":"https://api.qut.kz/kb/ru/cashier-not-connecting.md"}}},{"slug":"cashier-number-requirements","category":"start","updated":"2026-10-16","related":["connect-cashier","cashier-not-connecting","what-is-qutpay","sandbox-vs-live"],"langs":{"kk":{"title":"Кассир нөміріне қойылатын үш шарт","description":"Қосылудың сәтті өтуі түгелдей осы үш шартқа байланысты: нақты SIM, иесінің ЖСН-іне ЖК/ЖШС тіркелмеген болуы және нөмірде тек «Кассир» рөлі. Нөмірді алдын ала қалай таңдау керек.","url":"https://api.qut.kz/kb/cashier-number-requirements","md":"https://api.qut.kz/kb/cashier-number-requirements.md"},"ru":{"title":"Три условия для номера кассира","description":"Успех подключения почти целиком зависит от выбора номера: настоящая SIM, на ИИН владельца не зарегистрированы ИП или ТОО, и на номере только роль «Кассир». Как подобрать номер заранее.","url":"https://api.qut.kz/kb/ru/cashier-number-requirements","md":"https://api.qut.kz/kb/ru/cashier-number-requirements.md"}}},{"slug":"cashier-vs-owner-number","category":"start","updated":"2026-09-14","related":["is-it-safe","connection-lost","org-settings","telegram-connect"],"langs":{"kk":{"title":"Кассир нөмірі мен өз нөміріңіз — айырмашылығы","description":"Жүйеде үш түрлі нөмір бар: жеке нөміріңіз, кассир нөмірі және клиенттің нөмірі. Әрқайсысы не үшін, қандай қате жиі кездеседі және өз нөміріңізді неге кассир қылуға болмайды.","url":"https://api.qut.kz/kb/cashier-vs-owner-number","md":"https://api.qut.kz/kb/cashier-vs-owner-number.md"},"ru":{"title":"Номер кассира и ваш личный номер","description":"В системе три разных номера: ваш личный, номер кассира и номер покупателя. Для чего нужен каждый, какие ошибки встречаются чаще всего и почему нельзя делать кассиром свой номер.","url":"https://api.qut.kz/kb/ru/cashier-vs-owner-number","md":"https://api.qut.kz/kb/ru/cashier-vs-owner-number.md"}}},{"slug":"change-cashier","category":"problems","updated":"2026-09-14","related":["connection-lost","cashier-number-requirements","api-key-connection","cashier-not-connecting"],"langs":{"kk":{"title":"Кассир ауысты немесе нөмірі өзгерді — не істеу керек","description":"Кассир жұмыстан кетті, нөмірі ауысты, SIM жоғалды немесе бизнес иесі ауысты. Әр жағдайда кабинетте нені басу керек және бұрынғы счёттарға не болады.","url":"https://api.qut.kz/kb/change-cashier","md":"https://api.qut.kz/kb/change-cashier.md"},"ru":{"title":"Кассир сменился или сменился номер — что делать","description":"Кассир уволился, сменился номер, потерялась SIM или сменился владелец бизнеса. Что нажать в кабинете в каждом случае и что будет со старыми счетами.","url":"https://api.qut.kz/kb/ru/change-cashier","md":"https://api.qut.kz/kb/ru/change-cashier.md"}}},{"slug":"compare-services","category":"start","updated":"2026-10-25","related":["kaspi-qr-on-website","kaspi-pay-api","tariff-choose","kaspi-qr-fee","is-it-safe"],"langs":{"kk":{"title":"Сайтқа Kaspi QR қабылдау сервистері — ApiPay, Qut Pay, KazPayment салыстыруы","description":"Сайтта Kaspi QR қабылдауды қандай сервистер автоматтандырады, несімен ерекшеленеді, қанша тұрады. Тек сервистердің өзі жариялаған бағалар, 25.10.2026 тексерілген, лимит бірліктерінің әртүрлілігі және ешқайсысы Kaspi серіктесі емес екені ескертілген.","url":"https://api.qut.kz/kb/compare-services","md":"https://api.qut.kz/kb/compare-services.md"},"ru":{"title":"Сервисы приёма Kaspi QR для сайта — сравнение ApiPay, Qut Pay, KazPayment","description":"Какие сервисы автоматизируют приём Kaspi QR на сайте, чем они отличаются и сколько стоят. Только опубликованные самими сервисами цены, проверено 25.10.2026, с оговоркой о разных единицах лимитов и о том, что ни один из них не является партнёром Kaspi.","url":"https://api.qut.kz/kb/ru/compare-services","md":"https://api.qut.kz/kb/ru/compare-services.md"}}},{"slug":"connect-cashier","category":"start","updated":"2026-09-14","related":["cashier-number-requirements","cashier-not-connecting","sandbox-vs-live","what-is-qutpay"],"langs":{"kk":{"title":"Kaspi кассирін қалай қосу керек","description":"Екі бөліктен тұратын қадамдық нұсқаулық: алдымен Kaspi Pay қосымшасында «Кассир» рөлін ашасыз, содан кейін кабинетте нөмірді SMS коды арқылы байланыстырасыз. Бәрі 2-3 минут алады.","url":"https://api.qut.kz/kb/connect-cashier","md":"https://api.qut.kz/kb/connect-cashier.md"},"ru":{"title":"Как подключить кассира Kaspi","description":"Пошаговая инструкция из двух частей: сначала заводите роль «Кассир» в приложении Kaspi Pay, затем привязываете номер в кабинете по коду из SMS. Всё вместе занимает 2–3 минуты.","url":"https://api.qut.kz/kb/ru/connect-cashier","md":"https://api.qut.kz/kb/ru/connect-cashier.md"}}},{"slug":"connection-lost","category":"problems","updated":"2026-09-14","related":["cashier-number-requirements","change-cashier","error-catalog","cashier-not-connecting"],"langs":{"kk":{"title":"Кассир байланысы үзілді — қалай қалпына келтіру","description":"Счёттар кенет жасалмай қалса, Kaspi сессиясы үзілген. Қалпына келтіру бір минут алады. Себебі, қадамдары және қайталанбауы үшін не істеу керек.","url":"https://api.qut.kz/kb/connection-lost","md":"https://api.qut.kz/kb/connection-lost.md"},"ru":{"title":"Привязка кассира оборвалась — как переподключить","description":"Счета внезапно перестали создаваться — значит, сессия Kaspi оборвалась. Переподключение занимает минуту. Причина, шаги и что сделать, чтобы не повторялось.","url":"https://api.qut.kz/kb/ru/connection-lost","md":"https://api.qut.kz/kb/ru/connection-lost.md"}}},{"slug":"create-invoice-api","category":"reference","updated":"2026-09-14","related":["qr-vs-phone","idempotency","invoice-lifecycle","bulk-invoices","error-catalog"],"langs":{"kk":{"title":"Счёт жасау: барлық өрістер","description":"POST /api/v1/invoices эндпоинтінің толық анықтамасы — әр өрістің типі мен шектеуі, жауаптағы барлық өріс, curl мен Node мысалдары, qr мен phone айырмашылығы және жиі кездесетін қателер.","url":"https://api.qut.kz/kb/create-invoice-api","md":"https://api.qut.kz/kb/create-invoice-api.md"},"ru":{"title":"Создание счёта: все поля","description":"Полный справочник по POST /api/v1/invoices — тип и ограничение каждого поля, все поля ответа, примеры на curl и Node, разница между qr и phone и список частых ошибок с решениями.","url":"https://api.qut.kz/kb/ru/create-invoice-api","md":"https://api.qut.kz/kb/ru/create-invoice-api.md"}}},{"slug":"csv-export-issue","category":"problems","updated":"2026-09-14","related":["slow-payments","money-arrival","multiple-organizations","org-archived"],"langs":{"kk":{"title":"Экспорт ашылмайды немесе дұрыс емес болып көрінеді","description":"Жүктелген CSV файлда әріптердің орнына иероглиф, бәрі бір бағанға сыйып кеткен немесе счёттар жетіспейді. Кодтау, бөлгіш, сүзгілер және бухгалтерияға дұрыс беру жолы.","url":"https://api.qut.kz/kb/csv-export-issue","md":"https://api.qut.kz/kb/csv-export-issue.md"},"ru":{"title":"Экспорт не открывается или выглядит неверным","description":"В выгруженном CSV вместо букв иероглифы, всё слиплось в одну колонку или не хватает счетов. Разбираем кодировку, разделитель, фильтры и как правильно передать выгрузку бухгалтеру.","url":"https://api.qut.kz/kb/ru/csv-export-issue","md":"https://api.qut.kz/kb/ru/csv-export-issue.md"}}},{"slug":"csv-export","category":"reference","updated":"2026-09-14","related":["csv-export-issue","money-arrival","late-payment","multiple-organizations","api-key-connection"],"langs":{"kk":{"title":"CSV экспорт және есеп: счёттарды тізім етіп алу","description":"Счёттарды кабинеттен және API арқылы шығару, сүзгілер мен бағандардың мағынасы, UTF-8 кодтауы, Excel-дегі иероглиф және Kaspi Pay есебімен салыстыру — сандар неге дәл сәйкес келмеуі мүмкін.","url":"https://api.qut.kz/kb/csv-export","md":"https://api.qut.kz/kb/csv-export.md"},"ru":{"title":"Экспорт CSV и отчётность: как выгрузить счета","description":"Выгрузка счетов из кабинета и через API, смысл фильтров и колонок, кодировка UTF-8, иероглифы в Excel и сверка с отчётом в кабинете Kaspi Pay — почему суммы могут не совпасть точно.","url":"https://api.qut.kz/kb/ru/csv-export","md":"https://api.qut.kz/kb/ru/csv-export.md"}}},{"slug":"customer-no-kaspi","category":"problems","updated":"2026-09-14","related":["how-customer-pays","qr-vs-phone","create-invoice-api","payment-links","what-customer-sees"],"langs":{"kk":{"title":"Клиентте Kaspi қосымшасы жоқ — қалай төлетуге болады","description":"Телефонға счёт (kind phone) клиенттің Kaspi қосымшасына келеді, қосымша болмаса ол жетпейді. Орнына QR немесе төлем сілтемесін беру керек. Алдын ала қалай тексеруге болады.","url":"https://api.qut.kz/kb/customer-no-kaspi","md":"https://api.qut.kz/kb/customer-no-kaspi.md"},"ru":{"title":"У покупателя нет приложения Kaspi — как принять оплату","description":"Счёт по телефону (kind phone) приходит в приложение Kaspi покупателя, и без приложения он просто не дойдёт. Вместо него нужен QR или ссылка на оплату. Как проверить заранее.","url":"https://api.qut.kz/kb/ru/customer-no-kaspi","md":"https://api.qut.kz/kb/ru/customer-no-kaspi.md"}}},{"slug":"data-and-privacy","category":"reference","updated":"2026-09-14","related":["is-it-safe","what-customer-sees","metadata-and-orders","security-checklist","receipts"],"langs":{"kk":{"title":"Деректер және құпиялық — не сақталады, кім көреді","description":"Qut Pay счёт, клиент және кассир деректерінің қайсысын сақтайды және қайсысын мүлдем сақтамайды, оларды кім көреді, қанша уақыт тұрады. Счёт сипаттамасы мен metadata-ға нені жазбау керек.","url":"https://api.qut.kz/kb/data-and-privacy","md":"https://api.qut.kz/kb/data-and-privacy.md"},"ru":{"title":"Данные и конфиденциальность — что хранится и кто это видит","description":"Какие данные счетов, покупателей и кассира Qut Pay хранит, а какие не хранит вовсе, кто имеет к ним доступ и как долго они живут. Что нельзя писать в описание счёта и в metadata.","url":"https://api.qut.kz/kb/ru/data-and-privacy","md":"https://api.qut.kz/kb/ru/data-and-privacy.md"}}},{"slug":"deleted-key","category":"problems","updated":"2026-09-14","related":["leaked-key","api-401","two-cashiers","is-it-safe"],"langs":{"kk":{"title":"API кілтті жойып алдым — не болады және не істеу керек","description":"Жойылған кілт сол сәтте істемей қалады және оны қайтару мүмкін емес. Счёттар мен ақшаға әсері жоқ. Жаңа кілт жасап, интеграцияда ауыстыру реті және кассирге байлауды ұмытпау.","url":"https://api.qut.kz/kb/deleted-key","md":"https://api.qut.kz/kb/deleted-key.md"},"ru":{"title":"Удалил API-ключ — что теперь будет и что делать","description":"Удалённый ключ перестаёт работать мгновенно, восстановить его нельзя. На счета и деньги это не влияет. Как создать новый, заменить его в интеграции и не забыть про привязку к кассиру.","url":"https://api.qut.kz/kb/ru/deleted-key","md":"https://api.qut.kz/kb/ru/deleted-key.md"}}},{"slug":"double-refund","category":"problems","updated":"2026-09-14","related":["slow-payments","webhook-not-arriving","money-arrival","leaked-key"],"langs":{"kk":{"title":"Екі рет қайтарып жіберуден қалай сақтану керек","description":"refund_unknown және refund_pending_unknown келгенде қайталау — ақшаны екі рет қайтарудың ең қысқа жолы. Оның орнына счёттың күйін оқу керек. Идемпоттылық, ішінара қайтару есебі және журнал жүргізу.","url":"https://api.qut.kz/kb/double-refund","md":"https://api.qut.kz/kb/double-refund.md"},"ru":{"title":"Как не вернуть деньги дважды","description":"При ответах refund_unknown и refund_pending_unknown повтор запроса — кратчайший путь к двойному возврату. Вместо этого нужно прочитать статус счёта. Идемпотентность, учёт частичных возвратов и журнал.","url":"https://api.qut.kz/kb/ru/double-refund","md":"https://api.qut.kz/kb/ru/double-refund.md"}}},{"slug":"duplicate-invoices","category":"problems","updated":"2026-09-14","related":["refund-not-working","invoice-stuck-pending","webhook-not-arriving","payment-not-arriving"],"langs":{"kk":{"title":"Счёттар қосарланып жатыр","description":"Бір тапсырысқа бірнеше счёт шығып жатса, алдымен ағынды тоқтату керек: API кілтті жойсаңыз, интеграция сол сәтте тоқтайды. Сосын себебін тауып, идемпоттылық қосасыз.","url":"https://api.qut.kz/kb/duplicate-invoices","md":"https://api.qut.kz/kb/duplicate-invoices.md"},"ru":{"title":"Счета дублируются","description":"Если на один заказ выставляется несколько счетов, сначала надо остановить поток: удалите API-ключ — интеграция встанет в ту же секунду. Потом ищите причину и включайте идемпотентность.","url":"https://api.qut.kz/kb/ru/duplicate-invoices","md":"https://api.qut.kz/kb/ru/duplicate-invoices.md"}}},{"slug":"error-catalog","category":"reference","updated":"2026-09-14","related":["connection-lost","cashier-not-connecting","webhook-not-arriving","tariff-limits","api-key-connection"],"langs":{"kk":{"title":"Қателер каталогы — API не қайтарады және не істеу керек","description":"Qut Pay API-інің барлық негізгі қате кодтары топтап берілген: авторизация, Kaspi байланысы, счёт, қайтару, тариф лимиті, webhook, жазылым. Әрқайсысының себебі және шешімі.","url":"https://api.qut.kz/kb/error-catalog","md":"https://api.qut.kz/kb/error-catalog.md"},"ru":{"title":"Каталог ошибок — что возвращает API и что делать","description":"Все основные коды ошибок Qut Pay API по группам: авторизация, привязка Kaspi, счета, возвраты, лимиты тарифа, вебхуки, подписки. Причина и решение для каждой.","url":"https://api.qut.kz/kb/ru/error-catalog","md":"https://api.qut.kz/kb/ru/error-catalog.md"}}},{"slug":"first-invoice","category":"start","updated":"2026-09-14","related":["trial-period","cabinet-tour","no-developer","glossary"],"langs":{"kk":{"title":"Бірінші счётты қалай жасау керек","description":"Екі жолы бар: кабинеттен қолмен екі өрісті толтырып немесе API арқылы бір сұраумен. Алдымен sandbox-та жасап, төлемді симуляциялап көру ұтымды.","url":"https://api.qut.kz/kb/first-invoice","md":"https://api.qut.kz/kb/first-invoice.md"},"ru":{"title":"Как создать первый счёт","description":"Два способа: вручную из кабинета за два поля или одним запросом к API. Первый счёт разумно сделать в песочнице и там же симулировать оплату.","url":"https://api.qut.kz/kb/ru/first-invoice","md":"https://api.qut.kz/kb/ru/first-invoice.md"}}},{"slug":"fiscal-receipt","category":"reference","updated":"2026-09-14","related":["receipts","money-arrival","org-settings","what-customer-sees","support-how"],"langs":{"kk":{"title":"Фискалды чек: кім жауапты және қашан автоматты шығады","description":"Kaspi QR арқылы төлемде чекті көбіне Kaspi өзі шығарады. Қолма-қол ақша мен басқа банктің POS-ы автоматты чек жасамайды. Кім жауапты, ОФД қайда, біздің чек бетінен айырмашылығы.","url":"https://api.qut.kz/kb/fiscal-receipt","md":"https://api.qut.kz/kb/fiscal-receipt.md"},"ru":{"title":"Фискальный чек: кто отвечает и когда он выбивается сам","description":"При оплате через Kaspi QR чек в большинстве случаев выбивает сам Kaspi. Наличные и POS другого банка автоматического чека не дают. Кто отвечает, при чём тут ОФД и чем наша страница чека от него отличается.","url":"https://api.qut.kz/kb/ru/fiscal-receipt","md":"https://api.qut.kz/kb/ru/fiscal-receipt.md"}}},{"slug":"for-1c","category":"business","updated":"2026-09-14","related":["for-crm","bulk-invoices","metadata-and-orders","polling-vs-webhook","refunds-api"],"langs":{"kk":{"title":"1С-тен Kaspi счёттарын шығару","description":"1С-тегі құжаттан Kaspi QR счётын шығару: HTTP-сервис арқылы қосылу, топтап жіберу, күйді сұрау немесе webhook қабылдау, externalOrderId арқылы құжатпен сәйкестендіру және қайтару.","url":"https://api.qut.kz/kb/for-1c","md":"https://api.qut.kz/kb/for-1c.md"},"ru":{"title":"Выставление счетов Kaspi из 1С","description":"Как выставлять Kaspi QR-счета прямо из документа 1С: подключение через HTTP-сервис, массовая отправка, опрос статуса или приём вебхука, сопоставление по externalOrderId и возвраты.","url":"https://api.qut.kz/kb/ru/for-1c","md":"https://api.qut.kz/kb/ru/for-1c.md"}}},{"slug":"for-beauty-salon","category":"business","updated":"2026-09-14","related":["for-crm","for-subscription-business","for-offline-point","refunds-api","no-developer"],"langs":{"kk":{"title":"Сұлулық салоны мен барберге","description":"Жазылу жүйесімен байланыстыру, алдын ала депозит, келмей қалған клиент, қайтару. Кодсыз жол мен API жолы, шебер бойынша бөлек есеп.","url":"https://api.qut.kz/kb/for-beauty-salon","md":"https://api.qut.kz/kb/for-beauty-salon.md"},"ru":{"title":"Салон красоты и барбершоп","description":"Связка с системой записи, предоплата, клиент не пришёл, возврат. Путь без кода и путь через API, раздельный учёт по мастерам.","url":"https://api.qut.kz/kb/ru/for-beauty-salon","md":"https://api.qut.kz/kb/ru/for-beauty-salon.md"}}},{"slug":"for-crm","category":"business","updated":"2026-09-14","related":["for-1c","webhook-setup","idempotency","metadata-and-orders","api-keys"],"langs":{"kk":{"title":"CRM жүйесіне қосу","description":"Bitrix24, amoCRM, Kommo, Altegio, МойСклад — дайын модуль жоқ, бірақ CRM сыртқа HTTP сұрау жібере алса жеткілікті. Мәміле төлем сатысына өткенде счёт шығады, төленгенде карточка өзі жылжиды.","url":"https://api.qut.kz/kb/for-crm","md":"https://api.qut.kz/kb/for-crm.md"},"ru":{"title":"Подключить свою CRM","description":"Bitrix24, amoCRM, Kommo, Altegio, МойСклад — готового модуля нет, подключение идёт через API. Достаточно, чтобы CRM умела отправлять HTTP-запрос наружу. Сделка переходит на стадию оплаты — выставляется счёт.","url":"https://api.qut.kz/kb/ru/for-crm","md":"https://api.qut.kz/kb/ru/for-crm.md"}}},{"slug":"for-delivery","category":"business","updated":"2026-09-14","related":["for-online-store","telegram-bot-commands","metadata-and-orders","refunds-api","qr-vs-phone"],"langs":{"kk":{"title":"Жеткізу қызметіне","description":"Курьер жеткізу сәтінде счёт шығарады, клиент өз телефонынан төлейді. Telegram бот немесе курьер қосымшасы арқылы, тапсырыс нөмірі мен метадеректер, қайтару және жеткізілмеген тапсырыс.","url":"https://api.qut.kz/kb/for-delivery","md":"https://api.qut.kz/kb/for-delivery.md"},"ru":{"title":"Служба доставки","description":"Курьер выставляет счёт в момент доставки, клиент платит со своего телефона. Через Telegram-бота или своё приложение, с номером заказа и метаданными, с возвратами и обработкой недоставленных заказов.","url":"https://api.qut.kz/kb/ru/for-delivery","md":"https://api.qut.kz/kb/ru/for-delivery.md"}}},{"slug":"for-driving-school","category":"business","updated":"2026-09-14","related":["for-education-online","for-subscription-business","payment-links","bulk-invoices","subscriptions-api"],"langs":{"kk":{"title":"Автомектеп пен курстарға","description":"Оқу ақысын Kaspi арқылы жинау: кабинеттен қолмен счёт, бөліп төлеуге жазылым, топтап счёт шығару және төлем сілтемесі. Топ бойынша есеп қалай жүреді.","url":"https://api.qut.kz/kb/for-driving-school","md":"https://api.qut.kz/kb/for-driving-school.md"},"ru":{"title":"Автошколы и курсы","description":"Как собирать оплату за обучение через Kaspi: счёт вручную из кабинета, подписка для периодических платежей, массовое выставление на группу и ссылка на оплату. Как устроена отчётность по группам.","url":"https://api.qut.kz/kb/ru/for-driving-school","md":"https://api.qut.kz/kb/ru/for-driving-school.md"}}},{"slug":"for-education-online","category":"business","updated":"2026-09-14","related":["for-subscription-business","subscriptions-api","webhook-setup","for-mobile-app","for-telegram-bot"],"langs":{"kk":{"title":"Онлайн мектеп пен курс платформасына","description":"Курсқа кіруді сатудан бастап, webhook арқылы қолжетімділікті ашуға, кезеңдік төлемге, топтық тариф пен жеңілдікке дейін. Мобильді қосымшаңыз болса App Store мен Play ережесін де қараңыз.","url":"https://api.qut.kz/kb/for-education-online","md":"https://api.qut.kz/kb/for-education-online.md"},"ru":{"title":"Онлайн-школа и платформа курсов","description":"Продажа доступа к курсу, открытие доступа по webhook, периодические платежи, групповые тарифы и скидки. Плюс правило App Store и Google Play, если у школы есть мобильное приложение.","url":"https://api.qut.kz/kb/ru/for-education-online","md":"https://api.qut.kz/kb/ru/for-education-online.md"}}},{"slug":"for-events","category":"business","updated":"2026-09-14","related":["payment-links","bulk-invoices","open-amount-links","metadata-and-orders","refunds-api"],"langs":{"kk":{"title":"Іс-шара мен билет сатуға","description":"Алдын ала сату төлем сілтемесі немесе сайттағы форма арқылы, есік алдында QR немесе телефонға счёт, топтап счёт, орын нөмірін metadata-ға жазу және жаппай қайтару.","url":"https://api.qut.kz/kb/for-events","md":"https://api.qut.kz/kb/for-events.md"},"ru":{"title":"Мероприятия и продажа билетов","description":"Предпродажа через ссылку на оплату или форму на сайте, оплата на входе по QR или счётом на телефон, массовое выставление, номер места в metadata и возвраты при отмене.","url":"https://api.qut.kz/kb/ru/for-events","md":"https://api.qut.kz/kb/ru/for-events.md"}}},{"slug":"for-freelancer","category":"business","updated":"2026-09-14","related":["payment-links","open-amount-links","no-developer","telegram-bot-commands","first-invoice"],"langs":{"kk":{"title":"Фрилансер мен жеке маманға","description":"Ең қарапайым сценарий: кабинетке кіресіз, счёт шығарасыз, сілтемені клиентке жібересіз. Тұрақты сілтеме, ашық сомалы сілтеме, Telegram боттан счёт. Код керек емес.","url":"https://api.qut.kz/kb/for-freelancer","md":"https://api.qut.kz/kb/for-freelancer.md"},"ru":{"title":"Фрилансеру и частному специалисту","description":"Самый простой сценарий: зашли в кабинет, выставили счёт, отправили ссылку клиенту. Постоянная ссылка, ссылка с открытой суммой, счёт из Telegram-бота. Код не нужен.","url":"https://api.qut.kz/kb/ru/for-freelancer","md":"https://api.qut.kz/kb/ru/for-freelancer.md"}}},{"slug":"for-gym","category":"business","updated":"2026-09-14","related":["for-subscription-business","subscriptions-api","payment-links","refunds-api","for-parking"],"langs":{"kk":{"title":"Спортзал мен фитнеске","description":"Абонемент сату, мерзімді ұзарту, ай сайынғы счётты жазылыммен автоматтандыру, мұздату мен қайтару және турникетті webhook арқылы ашу — фитнес клубқа арналған толық сценарий.","url":"https://api.qut.kz/kb/for-gym","md":"https://api.qut.kz/kb/for-gym.md"},"ru":{"title":"Спортзал и фитнес","description":"Продажа абонементов, продление, ежемесячные счета через подписку, заморозка и возврат, открытие турникета по webhook — разбор сценариев для фитнес-клуба с примерами запросов.","url":"https://api.qut.kz/kb/ru/for-gym","md":"https://api.qut.kz/kb/ru/for-gym.md"}}},{"slug":"for-instagram","category":"business","updated":"2026-09-14","related":["for-online-store","for-telegram-bot","for-tiktok-live","first-invoice","cabinet-login"],"langs":{"kk":{"title":"Instagram арқылы сатуға","description":"Директтегі жұмыс реті: төлем сілтемесі, кабинеттен қолмен счёт, Telegram боттан счёт шығару. Бәрі кодсыз істейді. Тапсырысты шатастырмай есеп жүргізу жолы.","url":"https://api.qut.kz/kb/for-instagram","md":"https://api.qut.kz/kb/for-instagram.md"},"ru":{"title":"Продажи через Instagram","description":"Порядок работы в директе: ссылка на оплату, ручной счёт из кабинета, счёт командой из Telegram-бота. Всё работает без кода. Как вести учёт и не перепутать заказы.","url":"https://api.qut.kz/kb/ru/for-instagram","md":"https://api.qut.kz/kb/ru/for-instagram.md"}}},{"slug":"for-marketplace","category":"business","updated":"2026-09-14","related":["partner-api","for-saas","api-key-connection","webhook-setup","multi-point-reporting"],"langs":{"kk":{"title":"Маркетплейс пен агрегаторға","description":"Әр сатушының ақшасы өз Kaspi шотына түсуі керек болса: әрқайсысына өз ұйымы мен кассирі, кілттерді бөлу, бөлек webhook. Комиссияны қалай ұстау мәселесі.","url":"https://api.qut.kz/kb/for-marketplace","md":"https://api.qut.kz/kb/for-marketplace.md"},"ru":{"title":"Маркетплейс и агрегатор","description":"Если деньги должны приходить на счёт Kaspi каждого продавца: своя организация и свой кассир для каждого, разделение ключей, отдельные вебхуки. Как удерживать комиссию.","url":"https://api.qut.kz/kb/ru/for-marketplace","md":"https://api.qut.kz/kb/ru/for-marketplace.md"}}},{"slug":"for-medical","category":"business","updated":"2026-09-14","related":["data-and-privacy","metadata-and-orders","receipts","refunds-api","for-beauty-salon"],"langs":{"kk":{"title":"Медициналық орталыққа","description":"Қабылдау ақысы, алдын ала төлеммен брондау, талдау нәтижесіне төлем, чек және қайтару. Ең бастысы — пациент деректерін счёт сипаттамасына жазбау ережесі.","url":"https://api.qut.kz/kb/for-medical","md":"https://api.qut.kz/kb/for-medical.md"},"ru":{"title":"Медицинский центр","description":"Оплата приёма, предоплата и бронирование времени, оплата анализов, чеки и возвраты. И главное правило: никаких данных о пациенте в описании счёта — только название услуги.","url":"https://api.qut.kz/kb/ru/for-medical","md":"https://api.qut.kz/kb/ru/for-medical.md"}}},{"slug":"for-mobile-app","category":"business","updated":"2026-09-14","related":["for-online-store","for-telegram-bot","api-401","webhook-not-arriving","is-it-safe"],"langs":{"kk":{"title":"Мобильді қосымшаға қосу","description":"Дұрыс реті: қосымша → өз серверіңіз → Qut Pay → Kaspi. API кілт APK немесе IPA ішінде болмауы керек. payUrl ашылғанда не болады және App Store мен Play Market ережесі.","url":"https://api.qut.kz/kb/for-mobile-app","md":"https://api.qut.kz/kb/for-mobile-app.md"},"ru":{"title":"Приём оплаты в мобильном приложении","description":"Правильный порядок: приложение → ваш сервер → Qut Pay → Kaspi. Почему API-ключ не должен попадать в APK и IPA, что происходит при открытии payUrl и правила App Store и Play Market.","url":"https://api.qut.kz/kb/ru/for-mobile-app","md":"https://api.qut.kz/kb/ru/for-mobile-app.md"}}},{"slug":"for-offline-point","category":"business","updated":"2026-09-14","related":["for-restaurant","qr-vs-phone","invoice-expiry","multi-point-reporting","qr-expired"],"langs":{"kk":{"title":"Офлайн нүктеде QR арқылы қабылдау","description":"Кассир экранда динамикалық QR көрсетеді, клиент сканерлейді. Сканерлеу терезесі шектеулі — уақытын expiresAt өрісінен алыңыз. Қашан QR, қашан телефонға счёт ыңғайлы және бірнеше нүктені қалай бөлу керек.","url":"https://api.qut.kz/kb/for-offline-point","md":"https://api.qut.kz/kb/for-offline-point.md"},"ru":{"title":"Приём по QR на офлайн-точке","description":"Кассир показывает динамический QR на экране, клиент сканирует. Окно сканирования ограничено — время берите из поля expiresAt. Когда удобнее QR, когда счёт на телефон и как разделить несколько точек.","url":"https://api.qut.kz/kb/ru/for-offline-point","md":"https://api.qut.kz/kb/ru/for-offline-point.md"}}},{"slug":"for-online-store","category":"business","updated":"2026-09-14","related":["for-telegram-bot","for-instagram","for-mobile-app","webhook-not-arriving","first-invoice"],"langs":{"kk":{"title":"Интернет-дүкенге Kaspi төлемін қосу","description":"Себеттен «төленді» күйіне дейінгі толық схема: счёт, төлем беті, webhook. Tilda, WooCommerce, OpenCart және өзі жазылған сайт үшін кодсыз жол мен API жолы.","url":"https://api.qut.kz/kb/for-online-store","md":"https://api.qut.kz/kb/for-online-store.md"},"ru":{"title":"Приём Kaspi для интернет-магазина","description":"Полная схема от корзины до статуса «оплачен»: счёт, страница оплаты, вебхук. Способы без кода для Tilda, WooCommerce и OpenCart, и путь через API для самописного сайта.","url":"https://api.qut.kz/kb/ru/for-online-store","md":"https://api.qut.kz/kb/ru/for-online-store.md"}}},{"slug":"for-parking","category":"business","updated":"2026-09-14","related":["for-vending","for-online-store","webhook-not-arriving","slow-payments","for-mobile-app"],"langs":{"kk":{"title":"Тұрақ пен шлагбаумға","description":"Шығу тұсындағы экранда QR немесе билет нөмірі бойынша счёт, төлем расталғанда webhook IP-реле арқылы шлагбаумды ашады. Динамикалық және басылған QR, көлік нөмірі, кідіріс.","url":"https://api.qut.kz/kb/for-parking","md":"https://api.qut.kz/kb/for-parking.md"},"ru":{"title":"Парковки и шлагбаумы","description":"QR на экране у выезда или счёт по номеру билета, вебхук открывает шлагбаум через IP-реле. Динамический и печатный QR, номер машины в metadata, борьба с задержкой.","url":"https://api.qut.kz/kb/ru/for-parking","md":"https://api.qut.kz/kb/ru/for-parking.md"}}},{"slug":"for-rental","category":"business","updated":"2026-09-14","related":["metadata-and-orders","refunds-api","for-vending","for-parking","webhook-setup"],"langs":{"kk":{"title":"Жалға беру бизнесіне","description":"Пауэрбанк станциясы, велосипед, самокат, құрал-жабдық, киім. Депозитті алу мен қайтару, мерзімдік төлем, QR арқылы автоматты беру және ішінара қайтару.","url":"https://api.qut.kz/kb/for-rental","md":"https://api.qut.kz/kb/for-rental.md"},"ru":{"title":"Аренда и прокат","description":"Станции пауэрбанков, велосипеды, самокаты, инструмент, одежда. Как брать и возвращать залог, периодическая оплата, выдача автоматом по QR и частичный возврат.","url":"https://api.qut.kz/kb/ru/for-rental","md":"https://api.qut.kz/kb/ru/for-rental.md"}}},{"slug":"for-restaurant","category":"business","updated":"2026-09-14","related":["for-offline-point","qr-vs-phone","customer-no-kaspi","payment-links","for-delivery"],"langs":{"kk":{"title":"Мейрамхана мен кафеге","description":"Үстелдегі QR, кассадағы экран, есеп-шот сомасы бойынша счёт, бөліп төлеу, даяшы бойынша есеп және жеткізу тапсырысы — залда Qut Pay қалай жұмыс істейтінінің толық сценарийі.","url":"https://api.qut.kz/kb/for-restaurant","md":"https://api.qut.kz/kb/for-restaurant.md"},"ru":{"title":"Ресторан и кафе","description":"QR на столе, экран на кассе, счёт на сумму чека, раздельная оплата, учёт по официантам и заказы на доставку — как Qut Pay работает в зале и что учесть заранее.","url":"https://api.qut.kz/kb/ru/for-restaurant","md":"https://api.qut.kz/kb/ru/for-restaurant.md"}}},{"slug":"for-saas","category":"business","updated":"2026-09-14","related":["for-marketplace","partner-api","api-keys","security-checklist","webhook-setup"],"langs":{"kk":{"title":"SaaS платформасына: клиенттер атынан төлем қабылдау","description":"Платформаңыздың клиенттері Kaspi төлемін өз шоттарына жинай алады. Кілттерді сақтау, клиент атынан счёт шығару, Partner API арқылы толық автоматтандыру және әр клиентке бөлек webhook.","url":"https://api.qut.kz/kb/for-saas","md":"https://api.qut.kz/kb/for-saas.md"},"ru":{"title":"SaaS-платформа: оплата за клиентов","description":"Как дать клиентам вашей платформы принимать Kaspi на их собственные счета: хранение ключей, выставление счетов от имени клиента, полная автоматизация через Partner API и отдельный вебхук на каждого.","url":"https://api.qut.kz/kb/ru/for-saas","md":"https://api.qut.kz/kb/ru/for-saas.md"}}},{"slug":"for-subscription-business","category":"business","updated":"2026-09-14","related":["subscriptions-api","subscription-not-running","for-gym","for-education-online","payment-links"],"langs":{"kk":{"title":"Жазылымдық бизнеске","description":"Жазылым — счётты кестеге сай автоматты шығару, ақша клиенттің шотынан өздігінен шешілмейді. Қайталау сатысы, өткізіп алу саясаты, pause/resume, ескерту және есеп.","url":"https://api.qut.kz/kb/for-subscription-business","md":"https://api.qut.kz/kb/for-subscription-business.md"},"ru":{"title":"Бизнес по подписке","description":"Подписка — это выставление счёта по расписанию, деньги со счёта клиента сами не уходят. Лестница повторов, политика пропусков, pause/resume, напоминания и отчётность.","url":"https://api.qut.kz/kb/ru/for-subscription-business","md":"https://api.qut.kz/kb/ru/for-subscription-business.md"}}},{"slug":"for-taxi-fleet","category":"business","updated":"2026-09-14","related":["for-rental","bulk-invoices","idempotency","csv-export","metadata-and-orders"],"langs":{"kk":{"title":"Таксопаркке жүргізушілерден төлем жинау","description":"Жүргізушілер тізімі бойынша топтап счёт шығару, идемпоттылық арқылы дубльден сақтану, әр элементтің қатесін бөлек өңдеу және күнделікті жинауды автоматтандыру.","url":"https://api.qut.kz/kb/for-taxi-fleet","md":"https://api.qut.kz/kb/for-taxi-fleet.md"},"ru":{"title":"Таксопарк: сбор платежей с водителей","description":"Массовое выставление счетов по списку водителей, защита от дублей через идемпотентность, разбор ошибок по каждому элементу отдельно и автоматизация ежедневного сбора.","url":"https://api.qut.kz/kb/ru/for-taxi-fleet","md":"https://api.qut.kz/kb/ru/for-taxi-fleet.md"}}},{"slug":"for-telegram-bot","category":"business","updated":"2026-09-14","related":["for-online-store","for-instagram","for-tiktok-live","webhook-not-arriving","two-cashiers"],"langs":{"kk":{"title":"Telegram ботында тауар сату","description":"Бот → сіздің сервер → счёт → клиентке push немесе сілтеме → webhook → тауарды беру. Төленбеген счёттардың жиналуынан қорғану, бірнеше бренд, Python пен Node мысалы.","url":"https://api.qut.kz/kb/for-telegram-bot","md":"https://api.qut.kz/kb/for-telegram-bot.md"},"ru":{"title":"Продажи через Telegram-бота","description":"Бот → ваш сервер → счёт → пуш или ссылка покупателю → вебхук → выдача товара. Защита от вала неоплаченных счетов, несколько брендов в одном боте, примеры на Python и Node.","url":"https://api.qut.kz/kb/ru/for-telegram-bot","md":"https://api.qut.kz/kb/ru/for-telegram-bot.md"}}},{"slug":"for-tiktok-live","category":"business","updated":"2026-09-14","related":["for-instagram","for-telegram-bot","for-online-store","first-invoice","two-cashiers"],"langs":{"kk":{"title":"TikTok тікелей эфирінде сатуға","description":"Эфир кезінде счётты секундпен шығару: телефон нөмірі бойынша push ең ыңғайлысы. Telegram боттан /invoice, экранда QR көрсету, көмекшімен жұмыс және төлемді бақылау.","url":"https://api.qut.kz/kb/for-tiktok-live","md":"https://api.qut.kz/kb/for-tiktok-live.md"},"ru":{"title":"Продажи в прямом эфире TikTok","description":"Как выставлять счёт за секунды прямо во время эфира: пуш по номеру телефона, команда /invoice в Telegram-боте, QR на экране, работа с помощником и контроль оплат.","url":"https://api.qut.kz/kb/ru/for-tiktok-live","md":"https://api.qut.kz/kb/ru/for-tiktok-live.md"}}},{"slug":"for-vending","category":"business","updated":"2026-09-14","related":["for-parking","for-online-store","for-mobile-app","webhook-not-arriving","slow-payments"],"langs":{"kk":{"title":"Вендинг автоматына терминалсыз төлем","description":"Автомат экранында динамикалық QR, клиент сканерлейді, webhook келеді, контроллер тауарды береді. Су, кофе және снек автоматтары үшін схема, жабдық жағы және QR терезесі.","url":"https://api.qut.kz/kb/for-vending","md":"https://api.qut.kz/kb/for-vending.md"},"ru":{"title":"Оплата в вендинговом автомате без терминала","description":"Динамический QR на экране автомата, покупатель сканирует, приходит вебхук, контроллер выдаёт товар. Схема для автоматов воды, кофе и снеков, требования к железу и окно QR.","url":"https://api.qut.kz/kb/ru/for-vending","md":"https://api.qut.kz/kb/ru/for-vending.md"}}},{"slug":"for-wholesale","category":"business","updated":"2026-09-14","related":["bulk-invoices","for-1c","idempotency","refunds-api","for-subscription-business"],"langs":{"kk":{"title":"Көтерме саудаға","description":"Ірі сомалы счёт, тапсырыс нөмірі бойынша есеп айырысу, бір сұрауда 100-ге дейін счёт, тұрақты клиенттерге жазылым, 1С-пен байланыстыру, ішінара төлем мен қайтару.","url":"https://api.qut.kz/kb/for-wholesale","md":"https://api.qut.kz/kb/for-wholesale.md"},"ru":{"title":"Оптовая торговля","description":"Счета на крупные суммы, привязка к номеру заказа, до 100 счетов одним запросом, подписки для постоянных клиентов, связка с 1С, частичная оплата траншами и возвраты.","url":"https://api.qut.kz/kb/ru/for-wholesale","md":"https://api.qut.kz/kb/ru/for-wholesale.md"}}},{"slug":"glossary","category":"start","updated":"2026-09-14","related":["what-you-need","first-invoice","cabinet-tour","trial-period"],"langs":{"kk":{"title":"Терминдер сөздігі","description":"Қолдауға келетін сұрақтардың бір бөлігі — терминді түсінбегеннен. Мұнда 25 термин қарапайым тілмен, әрқайсысына бір-екі сөйлем және мысал.","url":"https://api.qut.kz/kb/glossary","md":"https://api.qut.kz/kb/glossary.md"},"ru":{"title":"Словарь терминов","description":"Часть обращений в поддержку — просто непонятый термин. Здесь 25 терминов простыми словами, к каждому одно-два предложения и пример.","url":"https://api.qut.kz/kb/ru/glossary","md":"https://api.qut.kz/kb/ru/glossary.md"}}},{"slug":"going-live-checklist","category":"reference","updated":"2026-09-14","related":["switch-to-live","testing-integration","security-checklist","after-live-not-working","tariff-limits"],"langs":{"kk":{"title":"Продакшенге шығу чек-парағы","description":"Нақты режимге көшер алдында өтетін он екі тармақ: кассир, live кілт, webhook, қолтаңба, идемпоттылық, кеш төлем, қате өңдеу, журнал, тариф пен лимит, Telegram ескертуі, қайтару реті, бірінші нақты төлем.","url":"https://api.qut.kz/kb/going-live-checklist","md":"https://api.qut.kz/kb/going-live-checklist.md"},"ru":{"title":"Чек-лист выхода в прод","description":"Двенадцать пунктов, которые нужно закрыть перед переходом в боевой режим: кассир, боевой ключ, вебхук, подпись, идемпотентность, поздняя оплата, обработка ошибок, логи, тариф и лимиты, уведомления, возвраты, первый реальный платёж.","url":"https://api.qut.kz/kb/ru/going-live-checklist","md":"https://api.qut.kz/kb/ru/going-live-checklist.md"}}},{"slug":"how-customer-pays","category":"start","updated":"2026-09-14","related":["what-customer-sees","qr-vs-phone","payment-links","invoice-expiry","customer-no-kaspi"],"langs":{"kk":{"title":"Клиент қалай төлейді","description":"Клиентке жетудің үш жолы бар: QR сканерлеу, төлем сілтемесін ашу және телефон нөмірі арқылы Kaspi қосымшасына счёт жіберу. Әрқайсысы қашан ыңғайлы және мерзімдері қандай.","url":"https://api.qut.kz/kb/how-customer-pays","md":"https://api.qut.kz/kb/how-customer-pays.md"},"ru":{"title":"Как платит покупатель","description":"До покупателя можно дойти тремя способами: сканирование QR, ссылка на оплату и счёт прямо в приложение Kaspi по номеру телефона. Когда какой удобнее и сколько живёт каждый.","url":"https://api.qut.kz/kb/ru/how-customer-pays","md":"https://api.qut.kz/kb/ru/how-customer-pays.md"}}},{"slug":"idempotency","category":"reference","updated":"2026-09-14","related":["create-invoice-api","duplicate-invoices","metadata-and-orders","webhook-security","refunds-api"],"langs":{"kk":{"title":"Идемпоттылық: қайталаудан қорғану","description":"Idempotency-Key тақырыбы қалай жұмыс істейді, кілтті қалай құру керек, externalOrderId-дің рөлі неде, webhook өңдеуде және қайтаруда қайталанудан қалай сақтану керек.","url":"https://api.qut.kz/kb/idempotency","md":"https://api.qut.kz/kb/idempotency.md"},"ru":{"title":"Идемпотентность: защита от дублей","description":"Как работает заголовок Idempotency-Key, как правильно составить ключ, какова роль externalOrderId, и как защититься от повторов при обработке вебхуков и при возвратах.","url":"https://api.qut.kz/kb/ru/idempotency","md":"https://api.qut.kz/kb/ru/idempotency.md"}}},{"slug":"internet-acquiring-kz","category":"business","updated":"2026-10-25","related":["compare-services","kaspi-qr-fee","without-acquiring","kaspi-qr-on-website","customer-no-kaspi","fiscal-receipt","for-online-store"],"langs":{"kk":{"title":"Қазақстандағы интернет-эквайринг: банк, Kaspi QR немесе агрегатор — критерийлер бойынша салыстыру","description":"Қазақстанда сайтта төлем қабылдаудың үш тәсілі — банктің интернет-эквайрингі (карта, банк тарифі бойынша пайыз), Kaspi Pay арқылы Kaspi QR (Kaspi комиссиясы плюс Qut Pay сияқты автоматтандыру сервисінің жазылымы) және төлем агрегаторы. Критерийлер кестесі — сатып алушы немен төлейді, ақша қайда, комиссия моделі, интеграция күрделілігі, чектер — және бір Kaspi QR қашан жеткілікті.","url":"https://api.qut.kz/kb/internet-acquiring-kz","md":"https://api.qut.kz/kb/internet-acquiring-kz.md"},"ru":{"title":"Интернет-эквайринг в Казахстане: банк, Kaspi QR или агрегатор — сравнение по критериям","description":"Три способа принимать оплату на сайте в Казахстане — интернет-эквайринг банка (карты, процент по тарифу банка), Kaspi QR через Kaspi Pay (комиссия Kaspi плюс подписка сервиса-автоматизатора вроде Qut Pay) и платёжный агрегатор. Таблица по критериям — чем платит покупатель, где деньги, модель комиссии, сложность интеграции, чеки — и когда достаточно одного Kaspi QR.","url":"https://api.qut.kz/kb/ru/internet-acquiring-kz","md":"https://api.qut.kz/kb/ru/internet-acquiring-kz.md"}}},{"slug":"invoice-expiry","category":"reference","updated":"2026-09-14","related":["invoice-lifecycle","qr-expired","late-payment","qr-vs-phone","invoice-stuck-pending"],"langs":{"kk":{"title":"Счёттың жарамдылық мерзімі — қанша тұрады және не істеу керек","description":"QR счёттың сканерлеу терезесі мен телефонға счёттың мерзімі неден анықталады, expiresAt өрісін қалай дұрыс оқу керек, expired күйінен кейін не істеу керек және неге жабылған счётқа ақша кешігіп келуі мүмкін.","url":"https://api.qut.kz/kb/invoice-expiry","md":"https://api.qut.kz/kb/invoice-expiry.md"},"ru":{"title":"Срок жизни счёта — сколько он действует и что делать дальше","description":"Чем определяется окно сканирования QR-счёта и срок счёта в приложении, как правильно читать поле expiresAt, что делать после статуса expired и почему на уже закрытый счёт деньги могут прийти позже.","url":"https://api.qut.kz/kb/ru/invoice-expiry","md":"https://api.qut.kz/kb/ru/invoice-expiry.md"}}},{"slug":"invoice-lifecycle","category":"reference","updated":"2026-09-14","related":["invoice-expiry","late-payment","webhook-setup","polling-vs-webhook","refunds-api"],"langs":{"kk":{"title":"Счёттың өмірлік циклі","description":"Счёттың барлық күйлері мен ауысулары, қай күйде қандай webhook оқиғасы келеді, қайсысы ашық және қайсысы төленген деп есептеледі, кеш келген төлемді қалай өңдеу керек.","url":"https://api.qut.kz/kb/invoice-lifecycle","md":"https://api.qut.kz/kb/invoice-lifecycle.md"},"ru":{"title":"Жизненный цикл счёта","description":"Все статусы счёта и переходы между ними, какое событие вебхука приходит в какой момент, какие статусы считаются открытыми и оплаченными, и как обработать поздно пришедшую оплату.","url":"https://api.qut.kz/kb/ru/invoice-lifecycle","md":"https://api.qut.kz/kb/ru/invoice-lifecycle.md"}}},{"slug":"invoice-not-found","category":"problems","updated":"2026-09-14","related":["api-key-connection","sandbox-vs-live","api-403","api-401","metadata-and-orders"],"langs":{"kk":{"title":"«Счёт табылмады» деген қате — себебі және шешімі","description":"invoice_not_found қатесінің төрт себебі бар: идентификатор қате, счёт басқа режимде жасалған, кілт басқа кассирге байланған немесе счёт басқа ұйымдікі. Тексеру реті.","url":"https://api.qut.kz/kb/invoice-not-found","md":"https://api.qut.kz/kb/invoice-not-found.md"},"ru":{"title":"Ошибка «счёт не найден» — почему и что проверить","description":"У invoice_not_found четыре причины: неверный идентификатор, счёт создан в другом режиме, ключ привязан к другому кассиру или счёт принадлежит другой организации. Порядок проверки.","url":"https://api.qut.kz/kb/ru/invoice-not-found","md":"https://api.qut.kz/kb/ru/invoice-not-found.md"}}},{"slug":"invoice-stuck-pending","category":"problems","updated":"2026-09-14","related":["qr-expired","payment-not-arriving","webhook-not-arriving","what-is-qutpay"],"langs":{"kk":{"title":"Счёт pending күйінде тұрып қалды","description":"Pending — қате емес, қалыпты күй: счёт шығарылған, клиент әлі төлемеген. Қанша тұрады, қашан expired болады, біз оны қалай тексереміз және шынымен қашан алаңдау керек.","url":"https://api.qut.kz/kb/invoice-stuck-pending","md":"https://api.qut.kz/kb/invoice-stuck-pending.md"},"ru":{"title":"Счёт завис в статусе pending","description":"Pending — не ошибка, а нормальное состояние: счёт выставлен, покупатель ещё не подтвердил. Сколько он живёт, когда станет expired, как мы его проверяем и когда действительно стоит волноваться.","url":"https://api.qut.kz/kb/ru/invoice-stuck-pending","md":"https://api.qut.kz/kb/ru/invoice-stuck-pending.md"}}},{"slug":"is-it-safe","category":"start","updated":"2026-09-14","related":["what-is-qutpay","money-arrival","cashier-vs-owner-number","connection-lost"],"langs":{"kk":{"title":"Қосу қауіпсіз бе және сервис қалай құрылған","description":"Сервис Kaspi Pay-дегі шектеулі «Кассир» рөлі арқылы жұмыс істейді: счёт шығарады, күйін көреді, өз счёттары бойынша қайтару жасайды. Ақшаға қол жеткізе алмайды. Нені сақтаймыз және қалай ажыратасыз.","url":"https://api.qut.kz/kb/is-it-safe","md":"https://api.qut.kz/kb/is-it-safe.md"},"ru":{"title":"Безопасно ли подключать и как всё устроено","description":"Сервис работает через ограниченную роль «Кассир» в Kaspi Pay: выставить счёт, увидеть статус, вернуть по своим счетам. Доступа к деньгам нет. Что мы храним и как отключить в любой момент.","url":"https://api.qut.kz/kb/ru/is-it-safe","md":"https://api.qut.kz/kb/ru/is-it-safe.md"}}},{"slug":"is-it-us-or-kaspi","category":"problems","updated":"2026-09-14","related":["api-401","api-403","money-not-received","mass-invoice-failures"],"langs":{"kk":{"title":"Мәселе менде ме, Kaspi-де ме — екі минуттық диагностика","description":"Үш сұраққа жауап беріп, ақаудың қай жақта екенін анықтайсыз: интеграцияда, Kaspi байланысында әлде қызметте. Әр жауапқа нақты әрекет және қолдауға не жинау керегі.","url":"https://api.qut.kz/kb/is-it-us-or-kaspi","md":"https://api.qut.kz/kb/is-it-us-or-kaspi.md"},"ru":{"title":"Проблема у вас или у Kaspi — диагностика за две минуты","description":"Три вопроса показывают, на чьей стороне сбой: в вашей интеграции, в привязке Kaspi или в самом сервисе. К каждому ответу — конкретное действие и список того, что собрать для поддержки.","url":"https://api.qut.kz/kb/ru/is-it-us-or-kaspi","md":"https://api.qut.kz/kb/ru/is-it-us-or-kaspi.md"}}},{"slug":"kaspi-org-mismatch","category":"problems","updated":"2026-09-14","related":["multiple-organizations","two-cashiers","cashier-number-requirements","org-archived"],"langs":{"kk":{"title":"Кассир басқа Kaspi ұйымына тиесілі","description":"Kaspi ұйымы бірінші байланыста бекітіледі және кейін өзгермейді. Сондықтан қосылатын кассир сол ұйымның қызметкері болуы керек. Бірнеше ЖК/ЖШС болса қалай жоспарлау керегі.","url":"https://api.qut.kz/kb/kaspi-org-mismatch","md":"https://api.qut.kz/kb/kaspi-org-mismatch.md"},"ru":{"title":"Кассир принадлежит другой организации Kaspi","description":"Организация Kaspi фиксируется при первой привязке и потом не меняется. Значит, подключать нужно кассира именно этой организации. Что делать, если у вас несколько ИП или ТОО, и как это спланировать заранее.","url":"https://api.qut.kz/kb/ru/kaspi-org-mismatch","md":"https://api.qut.kz/kb/ru/kaspi-org-mismatch.md"}}},{"slug":"kaspi-pay-api","category":"start","updated":"2026-10-25","related":["kaspi-qr-on-website","what-is-qutpay","is-it-safe","create-invoice-api","webhook-setup"],"langs":{"kk":{"title":"Kaspi Pay-дің сайтқа арналған API-і бар ма","description":"Тікелей жауап: кез келген бизнеске ашық Kaspi Pay API-і жоқ. Kaspi ресми не береді, ірі серіктестер не алады, Qut Pay сияқты сервистер «Кассир» рөлі арқылы қалай жұмыс істейді және Qut Pay-дің API-і қандай — сұрау мысалымен.","url":"https://api.qut.kz/kb/kaspi-pay-api","md":"https://api.qut.kz/kb/kaspi-pay-api.md"},"ru":{"title":"Есть ли у Kaspi Pay API для сайта","description":"Прямой ответ: публичного API Kaspi Pay для любого бизнеса нет. Что Kaspi даёт официально, что получают крупные партнёры, как работают сервисы вроде Qut Pay через роль «Кассир», и какой API у Qut Pay — с примером запроса.","url":"https://api.qut.kz/kb/ru/kaspi-pay-api","md":"https://api.qut.kz/kb/ru/kaspi-pay-api.md"}}},{"slug":"kaspi-qr-fee","category":"start","updated":"2026-10-25","related":["money-arrival","tariff-choose","what-is-qutpay","kaspi-qr-on-website"],"langs":{"kk":{"title":"Kaspi QR комиссиясы қанша және оны кім ұстайды","description":"Kaspi QR төлемінің комиссиясын Kaspi-мен шартыңыз бойынша Kaspi-дің өзі ұстайды (Kaspi-дің жария шарттарында — 0,95 %). Qut Pay төлемнен пайыз алмайды, оның ақысы — жазылым. Төлем қабылдаудың толық құнын мысалмен есептеу.","url":"https://api.qut.kz/kb/kaspi-qr-fee","md":"https://api.qut.kz/kb/kaspi-qr-fee.md"},"ru":{"title":"Какая комиссия у Kaspi QR и кто её берёт","description":"Комиссию за оплату Kaspi QR удерживает сам Kaspi по вашему договору (по публичным условиям Kaspi — 0,95 %). Qut Pay процент с платежей не берёт, его оплата — подписка. Как посчитать полную стоимость приёма платежей на примере.","url":"https://api.qut.kz/kb/ru/kaspi-qr-fee","md":"https://api.qut.kz/kb/ru/kaspi-qr-fee.md"}}},{"slug":"kaspi-qr-on-website","category":"start","updated":"2026-10-25","related":["what-you-need","connect-cashier","first-invoice","woocommerce","kaspi-pay-api","auto-check-payment"],"langs":{"kk":{"title":"Kaspi QR-ді сайтқа қалай қосу керек — барлық тәсіл","description":"Сайтта Kaspi QR арқылы төлем қабылдаудың үш тәсілі — Kaspi Pay қосымшасындағы сілтеме, Kaspi-мен тікелей интеграция, Qut Pay сияқты автоматтандыру сервисі. Не керек, қанша тұрады, төлем қалай расталады, 15 минутта неден бастау.","url":"https://api.qut.kz/kb/kaspi-qr-on-website","md":"https://api.qut.kz/kb/kaspi-qr-on-website.md"},"ru":{"title":"Как подключить Kaspi QR к сайту — все способы","description":"Три способа принимать оплату Kaspi QR на сайте — ссылка из приложения Kaspi Pay, прямая интеграция с Kaspi, сервис-автоматизатор вроде Qut Pay. Что требуется, сколько стоит, как подтверждается оплата, с чего начать за 15 минут.","url":"https://api.qut.kz/kb/ru/kaspi-qr-on-website","md":"https://api.qut.kz/kb/ru/kaspi-qr-on-website.md"}}},{"slug":"laravel","category":"reference","updated":"2026-10-25","related":["sdk-php","webhook-signature-mismatch","webhook-setup","sandbox-simulate","idempotency","create-invoice-api"],"langs":{"kk":{"title":"Laravel сайтына Kaspi QR қосу","description":"Qut Pay счётын жасап, сатып алушыны payUrl-ге жіберетін контроллер; $request->getContent() шикі денесі бойынша HMAC тексеретін, CSRF-тен шығарылған, тапсырысты идемпотентті жаңартатын webhook маршруты. PHP SDK немесе Http::post арқылы, алдымен sandbox-та.","url":"https://api.qut.kz/kb/laravel","md":"https://api.qut.kz/kb/laravel.md"},"ru":{"title":"Kaspi QR для сайта на Laravel","description":"Контроллер, который создаёт счёт Qut Pay и отправляет покупателя на payUrl; маршрут вебхука с проверкой HMAC по сырому телу $request->getContent(), исключением из CSRF и идемпотентным обновлением заказа. На PHP SDK или на Http::post, сначала в песочнице.","url":"https://api.qut.kz/kb/ru/laravel","md":"https://api.qut.kz/kb/ru/laravel.md"}}},{"slug":"late-payment","category":"problems","updated":"2026-09-14","related":["money-not-received","webhook-signature-mismatch","is-it-us-or-kaspi"],"langs":{"kk":{"title":"Кеш келген төлем — счёт жабылған, ал ақша келді","description":"Болдырылған немесе мерзімі өткен счётқа ақша кешігіп келуі мүмкін. Ондайда invoice.paid оқиғасы late: true белгісімен келеді. Не істеу керек және кодта бұған қалай дайын болу керек.","url":"https://api.qut.kz/kb/late-payment","md":"https://api.qut.kz/kb/late-payment.md"},"ru":{"title":"Поздняя оплата — счёт закрыт, а деньги пришли","description":"На отменённый или просроченный счёт деньги могут прийти с опозданием. В этом случае событие invoice.paid приходит с меткой late: true. Что делать и как заранее подготовить к этому код.","url":"https://api.qut.kz/kb/ru/late-payment","md":"https://api.qut.kz/kb/ru/late-payment.md"}}},{"slug":"leaked-key","category":"problems","updated":"2026-09-14","related":["deleted-key","api-401","is-it-safe","org-archived"],"langs":{"kk":{"title":"API кілт сыртқа шығып кетті — шұғыл не істеу керек","description":"Кілт репозиторийге, чатқа немесе бөтен қолға түссе, бірінші минутта не істеу керек: жою, жаңасын жасау, соңғы счёттарды тексеру. Кілтпен не істеуге болатыны және алдын алу ережелері.","url":"https://api.qut.kz/kb/leaked-key","md":"https://api.qut.kz/kb/leaked-key.md"},"ru":{"title":"API-ключ утёк — что делать срочно","description":"Ключ попал в репозиторий, чат или чужие руки. Что сделать в первую минуту: удалить, создать новый, проверить последние счета. Что вообще можно сделать ключом и как не допустить повторения.","url":"https://api.qut.kz/kb/ru/leaked-key","md":"https://api.qut.kz/kb/ru/leaked-key.md"}}},{"slug":"mass-invoice-failures","category":"problems","updated":"2026-09-14","related":["api-403","is-it-us-or-kaspi","api-401"],"langs":{"kk":{"title":"Счёттар жаппай құлап жатыр — не істеу керек","description":"Бір мезетте көп счёт жіберсеңіз, Kaspi кассирдің сұрау жиілігін шектеуі мүмкін. Автоматты қайталау жоқ. Пауза беру, кезекпен жіберу және қате кодтарын ажырату тактикасы.","url":"https://api.qut.kz/kb/mass-invoice-failures","md":"https://api.qut.kz/kb/mass-invoice-failures.md"},"ru":{"title":"Счета массово падают — что делать","description":"Если отправить много счетов разом, Kaspi может ограничить частоту запросов кассира. Автоматических повторов нет. Пауза, отправка по очереди и разбор кодов ошибок.","url":"https://api.qut.kz/kb/ru/mass-invoice-failures","md":"https://api.qut.kz/kb/ru/mass-invoice-failures.md"}}},{"slug":"metadata-and-orders","category":"reference","updated":"2026-09-14","related":["create-invoice-api","idempotency","webhook-setup","data-and-privacy","csv-export"],"langs":{"kk":{"title":"Metadata және тапсырыс нөмірі","description":"externalOrderId мен metadata өрістерінің айырмашылығы, олардың webhook-та қалай қайта келетіні, metadata ішіне нені жазуға болады және нені ешқашан жазбау керек — нақты мысалдармен.","url":"https://api.qut.kz/kb/metadata-and-orders","md":"https://api.qut.kz/kb/metadata-and-orders.md"},"ru":{"title":"Metadata и номер заказа","description":"Чем externalOrderId отличается от metadata, как оба поля возвращаются в вебхуке, что можно класть в metadata и что туда нельзя класть никогда — с конкретными примерами.","url":"https://api.qut.kz/kb/ru/metadata-and-orders","md":"https://api.qut.kz/kb/ru/metadata-and-orders.md"}}},{"slug":"money-arrival","category":"start","updated":"2026-09-14","related":["what-is-qutpay","is-it-safe","tariff-choose","cashier-vs-owner-number"],"langs":{"kk":{"title":"Ақша қашан және қайда түседі","description":"Клиент төлеген сәтте ақша тіке сіздің Kaspi Pay шотыңызға түседі — бізде ұсталмайды. Қызмет ақысы төлем сомасынан емес, айлық жазылым. Есеп айырысу мен сверка қалай жүреді.","url":"https://api.qut.kz/kb/money-arrival","md":"https://api.qut.kz/kb/money-arrival.md"},"ru":{"title":"Когда и куда приходят деньги","description":"Деньги приходят напрямую на ваш счёт Kaspi Pay в момент оплаты — у нас они не задерживаются. Плата за сервис не зависит от суммы платежа, это месячная подписка. Как вести сверку.","url":"https://api.qut.kz/kb/ru/money-arrival","md":"https://api.qut.kz/kb/ru/money-arrival.md"}}},{"slug":"money-not-received","category":"problems","updated":"2026-09-14","related":["late-payment","is-it-us-or-kaspi","two-cashiers","what-is-qutpay"],"langs":{"kk":{"title":"Счёт төленді, ал ақша түспеді","description":"Үш себебі бар: тест режимі қосулы, ақшаны дұрыс емес жерден іздеп жүрсіз, немесе кассир басқа Kaspi ұйымына тиесілі. Әрқайсысын қалай тексеру керек және не істеу керек.","url":"https://api.qut.kz/kb/money-not-received","md":"https://api.qut.kz/kb/money-not-received.md"},"ru":{"title":"Счёт оплачен, а денег нет","description":"Причин три: включён тестовый режим, деньги ищут не там, или кассир принадлежит другой организации Kaspi. Как проверить каждую и что делать дальше.","url":"https://api.qut.kz/kb/ru/money-not-received","md":"https://api.qut.kz/kb/ru/money-not-received.md"}}},{"slug":"multi-point-reporting","category":"reference","updated":"2026-09-14","related":["api-key-connection","two-cashiers","api-keys","csv-export","multiple-organizations"],"langs":{"kk":{"title":"Нүктелер бойынша бөлек есеп — әр дүкенге өз кілті","description":"Бірнеше дүкен, филиал немесе нүкте болғанда счёттарды қалай бөлу керек: әр нүктеге бөлек API кілт пен webhook, кілтті кассирге байлау, нені бөлуге болады және нені болмайды, қашан бөлек ұйым ашу керек.","url":"https://api.qut.kz/kb/multi-point-reporting","md":"https://api.qut.kz/kb/multi-point-reporting.md"},"ru":{"title":"Раздельная отчётность по точкам — свой ключ каждой точке","description":"Как разделить счета, когда точек, филиалов или магазинов несколько: отдельный API-ключ и вебхук на точку, привязка ключа к кассиру, что разделяется, а что остаётся общим, и когда пора заводить отдельную организацию.","url":"https://api.qut.kz/kb/ru/multi-point-reporting","md":"https://api.qut.kz/kb/ru/multi-point-reporting.md"}}},{"slug":"multiple-organizations","category":"start","updated":"2026-09-14","related":["two-cashiers","team-access","tariff-choose","api-keys","multi-point-reporting"],"langs":{"kk":{"title":"Бір аккаунтта бірнеше ұйым","description":"Бір нөмірмен кіріп, бірнеше ұйымды бөлек жүргізуге болады. Әр ұйымның өз кассирі, кілттері, webhook-і және тарифі. Тарифтер қосылмайды — әрқайсысы бөлек төленеді.","url":"https://api.qut.kz/kb/multiple-organizations","md":"https://api.qut.kz/kb/multiple-organizations.md"},"ru":{"title":"Несколько организаций в одном аккаунте","description":"С одного номера можно вести несколько организаций. У каждой свой кассир, свои ключи, свои вебхуки и свой тариф. Тарифы не складываются — каждая платит за себя.","url":"https://api.qut.kz/kb/ru/multiple-organizations","md":"https://api.qut.kz/kb/ru/multiple-organizations.md"}}},{"slug":"n8n","category":"reference","updated":"2026-09-14","related":["webhook-not-arriving","webhook-signature-mismatch","sandbox-simulate","tilda-forms","error-catalog"],"langs":{"kk":{"title":"n8n автоматтандыру: Qut Pay-ді дайын workflow-тармен қосу","description":"n8n үшін екі дайын workflow: счёт жасау және webhook қабылдау. Импорттау, credential, webhook құпиясы, қолтаңбаны тексеру және «форма → счёт → төлем → хабарлама» сценарийі.","url":"https://api.qut.kz/kb/n8n","md":"https://api.qut.kz/kb/n8n.md"},"ru":{"title":"Автоматизация в n8n: готовые workflow для Qut Pay","description":"Два готовых workflow для n8n — создание счёта и приём вебхуков с проверкой подписи. Импорт, credential, секрет, Raw Body и сценарий «форма → счёт → оплата → уведомление».","url":"https://api.qut.kz/kb/ru/n8n","md":"https://api.qut.kz/kb/ru/n8n.md"}}},{"slug":"nextjs","category":"reference","updated":"2026-10-25","related":["sdk-node","webhook-security","auto-check-payment","sandbox-simulate","idempotency","webhook-signature-mismatch"],"langs":{"kk":{"title":"Kaspi Pay-ді Next.js-ке қосу","description":"POST /api/pay Route Handler-і Qut Pay счётын серверде жасайды (кілт браузерге түспейді) және payUrl қайтарады; POST /api/qutpay/webhook шикі денені req.text() арқылы оқып, HMAC-ты timingSafeEqual-мен тексереді; «рахмет» беті күйді серверде қайта тексереді. QUTPAY_API_KEY және QUTPAY_WEBHOOK_SECRET айнымалылары.","url":"https://api.qut.kz/kb/nextjs","md":"https://api.qut.kz/kb/nextjs.md"},"ru":{"title":"Kaspi Pay интеграция с Next.js","description":"Route Handler POST /api/pay создаёт счёт Qut Pay на сервере (ключ не попадает в браузер) и отдаёт payUrl; POST /api/qutpay/webhook читает сырое тело через req.text() и проверяет HMAC через timingSafeEqual; страница «спасибо» перепроверяет статус на сервере. Переменные QUTPAY_API_KEY и QUTPAY_WEBHOOK_SECRET.","url":"https://api.qut.kz/kb/ru/nextjs","md":"https://api.qut.kz/kb/ru/nextjs.md"}}},{"slug":"no-developer","category":"start","updated":"2026-09-14","related":["first-invoice","cabinet-tour","what-you-need","glossary"],"langs":{"kk":{"title":"Әзірлеуші жоқ — қалай бастау керек","description":"Код жазбай-ақ жұмыс істеудің бес жолы: кабинеттен қолмен счёт, тұрақты төлем сілтемелері, Telegram бот, WooCommerce/OpenCart модульдері және Tilda форма-хугы.","url":"https://api.qut.kz/kb/no-developer","md":"https://api.qut.kz/kb/no-developer.md"},"ru":{"title":"Нет программиста — как начать","description":"Пять способов работать без кода: счета вручную из кабинета, постоянные ссылки на оплату, Telegram-бот, модули WooCommerce и OpenCart, форм-хук для Tilda.","url":"https://api.qut.kz/kb/ru/no-developer","md":"https://api.qut.kz/kb/ru/no-developer.md"}}},{"slug":"open-amount-links","category":"reference","updated":"2026-09-14","related":["payment-links","for-freelancer","for-instagram","no-developer","first-invoice"],"langs":{"kk":{"title":"Ашық сомалы төлем сілтемелері — соманы клиент енгізеді","description":"Сома алдын ала белгіленбейтін тұрақты төлем сілтемесі: қайырымдылық, шәкіртақы, кеңес беру, әртүрлі бағадағы қызмет үшін. Ең аз және ең көп соманы шектеу, клиенттен қандай өріс сұрау, есепті қалай жүргізу.","url":"https://api.qut.kz/kb/open-amount-links","md":"https://api.qut.kz/kb/open-amount-links.md"},"ru":{"title":"Ссылки с открытой суммой — сумму вводит покупатель","description":"Постоянная ссылка на оплату без заранее заданной суммы: для сборов, взносов, консультаций и услуг с плавающей ценой. Как ограничить минимум и максимум, какие поля спрашивать у клиента и как вести учёт.","url":"https://api.qut.kz/kb/ru/open-amount-links","md":"https://api.qut.kz/kb/ru/open-amount-links.md"}}},{"slug":"opencart","category":"reference","updated":"2026-09-14","related":["plugin-not-working","webhook-setup","api-keys","refunds-api","for-online-store"],"langs":{"kk":{"title":"OpenCart 4 кеңейтуі","description":"Qut Pay кеңейтуін OpenCart 4 дүкеніне орнату, кілт пен webhook баптау, тапсырыс күйлерін таңдау, қайтару жасау және жиі кездесетін мәселелердің шешімі.","url":"https://api.qut.kz/kb/opencart","md":"https://api.qut.kz/kb/opencart.md"},"ru":{"title":"Расширение OpenCart 4","description":"Как установить расширение Qut Pay в магазин на OpenCart 4, настроить ключ и вебхук, выбрать статусы заказа, сделать возврат и что проверять при типовых сбоях.","url":"https://api.qut.kz/kb/ru/opencart","md":"https://api.qut.kz/kb/ru/opencart.md"}}},{"slug":"org-archived","category":"problems","updated":"2026-09-14","related":["multiple-organizations","deleted-key","api-401","kaspi-org-mismatch"],"langs":{"kk":{"title":"«Ұйым архивте» деген қате — не істеу керек","description":"API organization_inactive (410) қайтарса, кілт емес, ұйым белсенді емес. Жаңа кілт жасау көмектеспейді. Себептері, дұрыс кілтті таңдау және қолдауға жазғанда нені көрсету керек.","url":"https://api.qut.kz/kb/org-archived","md":"https://api.qut.kz/kb/org-archived.md"},"ru":{"title":"Ошибка «организация в архиве» — что делать","description":"Если API отвечает organization_inactive (410), дело не в ключе, а в том, что организация неактивна. Новый ключ не поможет. Причины, как выбрать правильный ключ и что указать в обращении в поддержку.","url":"https://api.qut.kz/kb/ru/org-archived","md":"https://api.qut.kz/kb/ru/org-archived.md"}}},{"slug":"org-settings","category":"start","updated":"2026-09-14","related":["is-it-safe","cashier-vs-owner-number","tariff-payment","support-how"],"langs":{"kk":{"title":"Ұйым деректерін толтыру","description":"Ұйым атауы, дүкен атауы, заңды деректер мен байланыс кабинеттегі Баптау бөлімінде толтырылады. Клиент қайсысын көреді, чекте не жазылады және атауды қалай өзгертуге болады.","url":"https://api.qut.kz/kb/org-settings","md":"https://api.qut.kz/kb/org-settings.md"},"ru":{"title":"Заполнить данные организации","description":"Название организации, название магазина, юридические данные и контакты заполняются в разделе Настройки. Что из этого видит покупатель, что попадает в чек и как менять название.","url":"https://api.qut.kz/kb/ru/org-settings","md":"https://api.qut.kz/kb/ru/org-settings.md"}}},{"slug":"partner-api","category":"reference","updated":"2026-09-14","related":["referral","api-keys","scopes","for-saas","for-marketplace"],"langs":{"kk":{"title":"Partner API","description":"Интеграторларға, веб-студияларға және франшизаларға арналған API: клиентке ұйым ашу, оның Kaspi кассирін қосу, кілт беру, live режимге өткізу және статистика алу. Клиент кабинетке кірмей-ақ қосыла алады.","url":"https://api.qut.kz/kb/partner-api","md":"https://api.qut.kz/kb/partner-api.md"},"ru":{"title":"Partner API","description":"API для интеграторов, веб-студий и франшиз: завести организацию клиенту, подключить его кассира Kaspi, выдать ключ, перевести в боевой режим и получать статистику. Клиенту достаточно продиктовать код из SMS.","url":"https://api.qut.kz/kb/ru/partner-api","md":"https://api.qut.kz/kb/ru/partner-api.md"}}},{"slug":"pay-button","category":"start","updated":"2026-10-25","related":["payment-links","kaspi-qr-on-website","create-invoice-api","auto-check-payment","webhook-setup","what-customer-sees","qr-expired"],"langs":{"kk":{"title":"Сайтқа «Kaspi арқылы төлеу» батырмасын қалай жасау керек — үш тәсіл","description":"Кодсыз Kaspi төлем батырмасы — қарапайым <a> тегіндегі qut.kz/p/<slug> сілтемесі; әр тапсырысқа счёт шығаратын батырма — серверіңізден сұрау және payUrl-ге бағыттау; телефонда — Kaspi қосымшасына deepLink. Дайын HTML, curl және JavaScript үзінділері, сатып алушы не көреді және сайт төлемді қалай біледі.","url":"https://api.qut.kz/kb/pay-button","md":"https://api.qut.kz/kb/pay-button.md"},"ru":{"title":"Как сделать кнопку «Оплатить через Kaspi» на сайте — три способа","description":"Кнопка оплаты Kaspi без кода — ссылка qut.kz/p/<slug> в обычном теге <a>; кнопка со счётом на каждый заказ — запрос с вашего сервера и редирект на payUrl; на телефоне — deepLink в приложение Kaspi. Готовые фрагменты HTML, curl и JavaScript, что видит покупатель и как сайт узнаёт об оплате.","url":"https://api.qut.kz/kb/ru/pay-button","md":"https://api.qut.kz/kb/ru/pay-button.md"}}},{"slug":"payment-links","category":"reference","updated":"2026-09-14","related":["no-developer","qr-vs-phone","csv-export-issue","api-keys","first-invoice"],"langs":{"kk":{"title":"Төлем сілтемелері — тұрақты мекенжай арқылы қабылдау","description":"qut.kz/p/<slug> түріндегі тұрақты төлем сілтемесі: өз атауыңызды қою, белгіленген және ашық сома, тоқтату мен қайта қосу, счёт сілтемесінен айырмашылығы, есеп және қате кодтары.","url":"https://api.qut.kz/kb/payment-links","md":"https://api.qut.kz/kb/payment-links.md"},"ru":{"title":"Ссылки на оплату — постоянный адрес для приёма платежей","description":"Постоянная ссылка вида qut.kz/p/<slug>: свой адрес, фиксированная и открытая сумма, остановка и возобновление, чем отличается от ссылки на счёт, отчётность по ссылкам и коды ошибок.","url":"https://api.qut.kz/kb/ru/payment-links","md":"https://api.qut.kz/kb/ru/payment-links.md"}}},{"slug":"payment-not-arriving","category":"problems","updated":"2026-09-14","related":["qr-expired","invoice-stuck-pending","webhook-not-arriving","what-is-qutpay"],"langs":{"kk":{"title":"Клиентке төлем келмей жатыр","description":"Счёт жасалды, бірақ клиенттің телефонына ештеңе келмеді немесе QR ашылмайды. Ең жиі себебі — тест режимі қосулы қалып қойған. Алты қадамдық тексеру реті.","url":"https://api.qut.kz/kb/payment-not-arriving","md":"https://api.qut.kz/kb/payment-not-arriving.md"},"ru":{"title":"Оплата не приходит покупателю","description":"Счёт создан, но на телефон покупателя ничего не пришло или QR не открывается. Чаще всего причина в том, что остался включённым тестовый режим. Шесть шагов проверки.","url":"https://api.qut.kz/kb/ru/payment-not-arriving","md":"https://api.qut.kz/kb/ru/payment-not-arriving.md"}}},{"slug":"plugin-not-working","category":"problems","updated":"2026-09-14","related":["woocommerce","opencart","webhook-not-arriving","api-401","sandbox-vs-live"],"langs":{"kk":{"title":"WooCommerce немесе OpenCart плагині істемей жатыр","description":"Плагин счёт жасамаса немесе тапсырыс күйі өзгермесе, тексеретін төрт нәрсе бар: кілт, режим сәйкестігі, webhook адресінің жариялығы және дүкен журналы. Қай симптом нені білдіреді.","url":"https://api.qut.kz/kb/plugin-not-working","md":"https://api.qut.kz/kb/plugin-not-working.md"},"ru":{"title":"Плагин WooCommerce или OpenCart не работает","description":"Если плагин не создаёт счета или статус заказа не меняется, проверять нужно четыре вещи: ключ, совпадение режимов, публичную доступность адреса вебхука и журнал магазина.","url":"https://api.qut.kz/kb/ru/plugin-not-working","md":"https://api.qut.kz/kb/ru/plugin-not-working.md"}}},{"slug":"polling-vs-webhook","category":"reference","updated":"2026-09-14","related":["webhook-setup","slow-payments","invoice-lifecycle","status-endpoint","webhook-security"],"langs":{"kk":{"title":"Webhook пен күйді сұрау: қайсысы қашан","description":"Webhook — негізгі әдіс, бірақ жеткізу кепілдігі абсолютті емес. Кідіріске сезімтал сценарийлерде екеуін қатар жүргізу керек: қалай, қандай жиілікпен және неге бұл артық жұмыс емес.","url":"https://api.qut.kz/kb/polling-vs-webhook","md":"https://api.qut.kz/kb/polling-vs-webhook.md"},"ru":{"title":"Вебхук или опрос статуса: что когда","description":"Вебхук — основной способ узнать об оплате, но гарантия доставки не абсолютна. В сценариях, чувствительных к задержке, нужны оба механизма сразу: как их совместить, с какой частотой опрашивать и почему это не лишняя работа.","url":"https://api.qut.kz/kb/ru/polling-vs-webhook","md":"https://api.qut.kz/kb/ru/polling-vs-webhook.md"}}},{"slug":"qr-expired","category":"problems","updated":"2026-09-14","related":["invoice-stuck-pending","payment-not-arriving","webhook-not-arriving","what-is-qutpay"],"langs":{"kk":{"title":"QR «кейінірек көріңіз» деп тұр","description":"Клиент QR-ды скандағанда қате хабар шықса, көбіне сканерлеу терезесі өтіп кеткен. Терезені Kaspi белгілейді, оны expiresAt өрісінен алыңыз. Басылған QR мен экрандағы QR айырмашылығы.","url":"https://api.qut.kz/kb/qr-expired","md":"https://api.qut.kz/kb/qr-expired.md"},"ru":{"title":"QR показывает «попробуйте позже»","description":"Если покупатель сканирует QR и видит ошибку, чаще всего истекло окно сканирования. Окно задаёт Kaspi, берите его из поля expiresAt. Чем печатный QR отличается от QR на экране.","url":"https://api.qut.kz/kb/ru/qr-expired","md":"https://api.qut.kz/kb/ru/qr-expired.md"}}},{"slug":"qr-vs-phone","category":"reference","updated":"2026-09-14","related":["customer-no-kaspi","first-invoice","payment-links","error-catalog","invoice-stuck-pending"],"langs":{"kk":{"title":"QR счёт пен телефонға счёт — қайсысын таңдау керек","description":"Екі счёт түрінің толық салыстыруы: kind мәні, клиент не істейді, нөмір керек пе, сипаттама мен сома шектеулері, мерзімі және қай сценарийге қайсысы келеді.","url":"https://api.qut.kz/kb/qr-vs-phone","md":"https://api.qut.kz/kb/qr-vs-phone.md"},"ru":{"title":"QR-счёт или счёт по телефону — что выбрать","description":"Полное сравнение двух типов счёта: значение kind, что делает покупатель, нужен ли номер, ограничения описания и суммы, срок жизни и таблица сценариев с рекомендацией по каждому.","url":"https://api.qut.kz/kb/ru/qr-vs-phone","md":"https://api.qut.kz/kb/ru/qr-vs-phone.md"}}},{"slug":"rate-limits","category":"reference","updated":"2026-09-14","related":["error-catalog","tariff-limits","idempotency","bulk-invoices","polling-vs-webhook"],"langs":{"kk":{"title":"Сұрау жиілігінің шектеулері","description":"Бір API кілт минутына қанша сұрау жібере алады, 429 жауабының үш түрін қалай ажырату керек, Retry-After тақырыбын қалай оқу керек және бэкофф стратегиясын кодта қалай жазу керек.","url":"https://api.qut.kz/kb/rate-limits","md":"https://api.qut.kz/kb/rate-limits.md"},"ru":{"title":"Ограничения частоты запросов","description":"Сколько запросов в минуту выдерживает один API-ключ, чем три вида ответа 429 отличаются друг от друга, как читать заголовок Retry-After и как правильно написать экспоненциальный бэкофф в коде.","url":"https://api.qut.kz/kb/ru/rate-limits","md":"https://api.qut.kz/kb/ru/rate-limits.md"}}},{"slug":"receipts","category":"reference","updated":"2026-09-14","related":["fiscal-receipt","what-customer-sees","org-settings","refunds-api","money-arrival"],"langs":{"kk":{"title":"Чектер және оларды клиентке жеткізу","description":"Qut Pay-дің чек беті, оның нөмірленуі және не көрсететіні. Email арқылы жіберу, API мен webhook-тағы өрістер, Kaspi чегінің сілтемесі неге клиентке ашылмайды.","url":"https://api.qut.kz/kb/receipts","md":"https://api.qut.kz/kb/receipts.md"},"ru":{"title":"Чеки и доставка их покупателю","description":"Страница чека Qut Pay, её нумерация и содержимое. Отправка письмом, поля в API и вебхуке, и почему ссылка на чек Kaspi не открывается у покупателя.","url":"https://api.qut.kz/kb/ru/receipts","md":"https://api.qut.kz/kb/ru/receipts.md"}}},{"slug":"referral","category":"reference","updated":"2026-09-14","related":["partner-api","tariff-choose","tariff-payment","cabinet-tour","support-how"],"langs":{"kk":{"title":"Реферал бағдарлама","description":"Әр мерчанттың кабинетінде жеке реферал коды мен сілтемесі бар. Сол сілтемемен келген клиент тариф төлеген сайын сомадан 20 пайыз есептеледі. Қалай жұмыс істейді, есеп қайда көрінеді және төлем қалай жасалады.","url":"https://api.qut.kz/kb/referral","md":"https://api.qut.kz/kb/referral.md"},"ru":{"title":"Реферальная программа","description":"У каждой организации в кабинете есть свой реферальный код и ссылка. Когда приведённый по ней мерчант оплачивает тариф, вам начисляется 20 процентов от суммы. Как это работает, где смотреть отчёт и как происходит выплата.","url":"https://api.qut.kz/kb/ru/referral","md":"https://api.qut.kz/kb/ru/referral.md"}}},{"slug":"refund-not-working","category":"problems","updated":"2026-09-14","related":["duplicate-invoices","invoice-stuck-pending","payment-not-arriving","what-is-qutpay"],"langs":{"kk":{"title":"Қайтару өтпей жатыр","description":"Қайтару қатесін код бойынша ажырату: счёт қайтаруға жарамайды, сома дұрыс емес, Kaspi орындамады немесе нәтижесі белгісіз. Қайсысында қайталауға болады, қайсысында мүлде болмайды.","url":"https://api.qut.kz/kb/refund-not-working","md":"https://api.qut.kz/kb/refund-not-working.md"},"ru":{"title":"Возврат не проходит","description":"Разбор ошибок возврата по коду: счёт не подлежит возврату, неверная сумма, Kaspi не выполнил операцию или результат неизвестен. Где можно повторять запрос, а где категорически нельзя.","url":"https://api.qut.kz/kb/ru/refund-not-working","md":"https://api.qut.kz/kb/ru/refund-not-working.md"}}},{"slug":"refunds-api","category":"reference","updated":"2026-09-14","related":["refund-not-working","error-catalog","scopes","api-keys","payment-not-arriving"],"langs":{"kk":{"title":"Қайтару API — толық және ішінара қайтару","description":"POST /invoices/{id}/refund әдісінің толық анықтамасы: сұрау өрістері, толық және ішінара қайтару, сома шектеуі, барлық қате коды, refund_unknown келгенде не істеу керек және қандай оқиғалар жіберіледі.","url":"https://api.qut.kz/kb/refunds-api","md":"https://api.qut.kz/kb/refunds-api.md"},"ru":{"title":"API возвратов — полный и частичный возврат","description":"Справочник по методу POST /invoices/{id}/refund: поля запроса, полный и частичный возврат, ограничение суммы, все коды ошибок, что делать при refund_unknown и какие события приходят после возврата.","url":"https://api.qut.kz/kb/ru/refunds-api","md":"https://api.qut.kz/kb/ru/refunds-api.md"}}},{"slug":"reviews-and-tariffs","category":"start","updated":"2026-10-25","related":["tariff-choose","tariff-limits","trial-period","is-it-safe","compare-services","kaspi-qr-fee","what-is-qutpay"],"langs":{"kk":{"title":"Qut Pay — пікірлер мен тарифтер: 2026 жылғы қазандағы сервис туралы не белгілі","description":"Qut Pay туралы ашық бет: Қазақстаннан шыққан тәуелсіз Kaspi QR қабылдау сервисі, 4 990 ₸-ден басталатын төрт тариф, төлемнен пайыз жоқ, 7 күн тегін. Жарияланған пікірлер неге әзірге жоқ, сервисті 15 минутта өз бетінше қалай тексеруге болады және қосылмас бұрын қандай тәуекелді білу керек.","url":"https://api.qut.kz/kb/reviews-and-tariffs","md":"https://api.qut.kz/kb/reviews-and-tariffs.md"},"ru":{"title":"Qut Pay — отзывы и тарифы: что известно о сервисе на октябрь 2026","description":"Прозрачная страница о Qut Pay: независимый сервис приёма Kaspi QR из Казахстана, четыре тарифа от 4 990 ₸ без процента с платежей, 7 дней бесплатно. Почему опубликованных отзывов пока нет, как проверить сервис самостоятельно за 15 минут и какой риск стоит знать до подключения.","url":"https://api.qut.kz/kb/ru/reviews-and-tariffs","md":"https://api.qut.kz/kb/ru/reviews-and-tariffs.md"}}},{"slug":"roles-and-permissions","category":"reference","updated":"2026-09-14","related":["team-access","api-keys","api-key-connection","scopes","security-checklist"],"langs":{"kk":{"title":"Рөлдер мен құқықтар — кім нені істей алады","description":"Кабинеттегі үш рөл — иесі, әзірлеуші, менеджер. Әр рөл қай бөлімді көреді және қандай әрекет жасай алады: счёт, қайтару, кассир, API кілт, webhook, тариф, қызметкер. Соңғы иені қорғау және қызметкер кеткенде не істеу керек.","url":"https://api.qut.kz/kb/roles-and-permissions","md":"https://api.qut.kz/kb/roles-and-permissions.md"},"ru":{"title":"Роли и права в кабинете — кто что может","description":"Три роли кабинета Qut Pay — владелец, разработчик, менеджер. Что видит и что может делать каждая: счета, возвраты, кассир, API-ключи, вебхуки, тариф, сотрудники. Защита последнего владельца и что делать, когда сотрудник уходит.","url":"https://api.qut.kz/kb/ru/roles-and-permissions","md":"https://api.qut.kz/kb/ru/roles-and-permissions.md"}}},{"slug":"sandbox-simulate","category":"reference","updated":"2026-09-14","related":["sandbox-vs-live","webhook-not-arriving","late-payment","ai-agent-setup","error-catalog"],"langs":{"kk":{"title":"Sandbox-та төлемді симуляциялау","description":"simulate эндпоинті арқылы sandbox счётының күйін өзгерту: paid, failed, expired. Kaspi шақырылмайды, webhook нағыз төлемдегідей келеді. Сынау циклі және автоматты тест жазу.","url":"https://api.qut.kz/kb/sandbox-simulate","md":"https://api.qut.kz/kb/sandbox-simulate.md"},"ru":{"title":"Симуляция оплаты в песочнице","description":"Эндпоинт simulate меняет статус счёта в песочнице: paid, failed, expired. Kaspi не вызывается, вебхук приходит как при настоящей оплате. Цикл проверки и написание автотестов.","url":"https://api.qut.kz/kb/ru/sandbox-simulate","md":"https://api.qut.kz/kb/ru/sandbox-simulate.md"}}},{"slug":"sandbox-vs-live","category":"start","updated":"2026-09-14","related":["what-is-qutpay","connect-cashier","cashier-number-requirements","cashier-not-connecting"],"langs":{"kk":{"title":"Sandbox пен нақты режимнің айырмашылығы","description":"Sandbox-та Kaspi мүлде шақырылмайды, ақша жүрмейді, кассир де керек емес — төлемді өзіңіз симуляциялайсыз. Екі режимнің толық салыстыруы және нақты режимге көшкенде нені тексеру керек.","url":"https://api.qut.kz/kb/sandbox-vs-live","md":"https://api.qut.kz/kb/sandbox-vs-live.md"},"ru":{"title":"Чем песочница отличается от боевого режима","description":"В песочнице Kaspi не вызывается вообще, реальных денег нет и кассир не нужен — оплату вы симулируете сами. Полное сравнение двух режимов и что проверить при переходе в боевой.","url":"https://api.qut.kz/kb/ru/sandbox-vs-live","md":"https://api.qut.kz/kb/ru/sandbox-vs-live.md"}}},{"slug":"scopes","category":"reference","updated":"2026-09-14","related":["api-keys","api-403","error-catalog","refunds-api","subscriptions-api"],"langs":{"kk":{"title":"Құқықтар (scopes) — кілт нені істей алады","description":"Алты scope-тың толық кестесі: invoices:read, invoices:write, refunds:write, subscriptions:manage, webhooks:manage, partner:manage. Әрқайсысы қай әдістерді ашады, ең аз құқық принципі және insufficient_scope қатесі.","url":"https://api.qut.kz/kb/scopes","md":"https://api.qut.kz/kb/scopes.md"},"ru":{"title":"Права доступа (scopes) — что может ключ","description":"Полная таблица шести scope: invoices:read, invoices:write, refunds:write, subscriptions:manage, webhooks:manage, partner:manage. Какие методы открывает каждый, принцип минимальных прав и разбор ошибки insufficient_scope.","url":"https://api.qut.kz/kb/ru/scopes","md":"https://api.qut.kz/kb/ru/scopes.md"}}},{"slug":"sdk-node","category":"reference","updated":"2026-09-14","related":["create-invoice-api","webhook-security","refunds-api","error-catalog","sandbox-simulate"],"langs":{"kk":{"title":"Node.js SDK","description":"Qut Pay-дің Node.js клиентін орнату, счёт жасау, күйін сұрау, қайтару және webhook қолтаңбасын тексеру. Толық жұмыс істейтін Express мысалы raw body-мен және қате өңдеу.","url":"https://api.qut.kz/kb/sdk-node","md":"https://api.qut.kz/kb/sdk-node.md"},"ru":{"title":"Node.js SDK","description":"Установка Node.js-клиента Qut Pay, создание счёта, запрос статуса, возврат и проверка подписи вебхука. Полный рабочий пример на Express с raw body и разбор обработки ошибок.","url":"https://api.qut.kz/kb/ru/sdk-node","md":"https://api.qut.kz/kb/ru/sdk-node.md"}}},{"slug":"sdk-php","category":"reference","updated":"2026-09-14","related":["create-invoice-api","webhook-security","refunds-api","error-catalog","woocommerce"],"langs":{"kk":{"title":"PHP SDK","description":"Qut Pay-дің PHP клиентін жобаға қосу, счёт жасау, қайтару және webhook қолтаңбасын тексеру. Таза PHP пен Laravel мысалдары, raw body-ны дұрыс алу және ApiException арқылы қате өңдеу.","url":"https://api.qut.kz/kb/sdk-php","md":"https://api.qut.kz/kb/sdk-php.md"},"ru":{"title":"PHP SDK","description":"Как подключить PHP-клиент Qut Pay, создать счёт, сделать возврат и проверить подпись вебхука. Примеры на чистом PHP и на Laravel, правильное получение raw body и обработка ApiException.","url":"https://api.qut.kz/kb/ru/sdk-php","md":"https://api.qut.kz/kb/ru/sdk-php.md"}}},{"slug":"sdk-python","category":"reference","updated":"2026-09-14","related":["create-invoice-api","webhook-security","refunds-api","error-catalog","sandbox-simulate"],"langs":{"kk":{"title":"Python SDK","description":"Qut Pay-дің Python клиентін орнату, счёт жасау, күйін сұрау, қайтару және webhook қолтаңбасын тексеру. Django мен Flask мысалдары, raw body-ны дұрыс алу және QutPayError арқылы қате өңдеу.","url":"https://api.qut.kz/kb/sdk-python","md":"https://api.qut.kz/kb/sdk-python.md"},"ru":{"title":"Python SDK","description":"Установка Python-клиента Qut Pay, создание счёта, запрос статуса, возврат и проверка подписи вебхука. Примеры на Django и Flask, правильное получение raw body и обработка QutPayError.","url":"https://api.qut.kz/kb/ru/sdk-python","md":"https://api.qut.kz/kb/ru/sdk-python.md"}}},{"slug":"security-checklist","category":"reference","updated":"2026-09-14","related":["api-keys","scopes","webhook-security","leaked-key","going-live-checklist"],"langs":{"kk":{"title":"Интеграция қауіпсіздігі: 12 тармақ","description":"Qut Pay интеграциясын қауіпсіз құрудың 12 нақты тармағы: кілтті қайда сақтау, scope-ты қалай шектеу, webhook қолтаңбасын қалай тексеру, журналға нені жазуға болмайды, кілт сыртқа шықса не істеу керек.","url":"https://api.qut.kz/kb/security-checklist","md":"https://api.qut.kz/kb/security-checklist.md"},"ru":{"title":"Безопасность интеграции: 12 пунктов","description":"Двенадцать конкретных требований к безопасной интеграции с Qut Pay: где хранить ключ, как ограничить scope, как проверять подпись вебхука по сырому телу, что нельзя писать в логи и что делать, если ключ утёк.","url":"https://api.qut.kz/kb/ru/security-checklist","md":"https://api.qut.kz/kb/ru/security-checklist.md"}}},{"slug":"shopify","category":"reference","updated":"2026-10-25","related":["kaspi-qr-on-website","payment-links","for-online-store","webhook-setup","auto-check-payment","no-developer"],"langs":{"kk":{"title":"Kaspi Pay-ді Shopify-ға қосу","description":"Ашық талдау: Shopify App Store-да Qut Pay қосымшасы жоқ, Shopify дүкенге кез келген төлем шлюзін қосуға рұқсат бермейді. Бүгін не істейді — қолмен төлеу тәсілі мен Qut Pay сілтемесі, webhook және Admin API бар шағын бэкенд, шекаралары қайда.","url":"https://api.qut.kz/kb/shopify","md":"https://api.qut.kz/kb/shopify.md"},"ru":{"title":"Kaspi Pay интеграция с Shopify","description":"Честный разбор: приложения Qut Pay в Shopify App Store нет, и Shopify не даёт магазину добавить произвольный платёжный шлюз. Что работает сегодня — ручной способ оплаты плюс ссылка Qut Pay, свой небольшой бэкенд с webhook и Admin API, и где границы.","url":"https://api.qut.kz/kb/ru/shopify","md":"https://api.qut.kz/kb/ru/shopify.md"}}},{"slug":"slow-payments","category":"problems","updated":"2026-09-14","related":["webhook-not-arriving","money-arrival","what-is-qutpay","double-refund"],"langs":{"kk":{"title":"Төлем баяу расталады — неге және не істеу керек","description":"Клиент төледі, бірақ счёт бірден paid болмайды. Мұнда тексеру жиілігі жасына қарай қалай өзгеретіні, іс жүзіндегі уақыт және кідіріске сезімтал сценарийде не істеу керегі жазылған.","url":"https://api.qut.kz/kb/slow-payments","md":"https://api.qut.kz/kb/slow-payments.md"},"ru":{"title":"Оплата подтверждается медленно — почему и что делать","description":"Покупатель заплатил, а счёт не сразу становится paid. Как частота проверки зависит от возраста счёта, сколько это занимает на практике и что делать в сценариях, чувствительных к задержке.","url":"https://api.qut.kz/kb/ru/slow-payments","md":"https://api.qut.kz/kb/ru/slow-payments.md"}}},{"slug":"sms-not-arriving","category":"problems","updated":"2026-09-14","related":["cashier-number-requirements","cant-login","payment-not-arriving","what-is-qutpay"],"langs":{"kk":{"title":"Kaspi SMS коды келмейді","description":"Кассирді байланыстырғанда SMS келмесе, себебі әдетте төртеудің бірі: SIM өшік, нөмір Kaspi Pay-де қызметкер ретінде қосылмаған, код өтіп кеткен немесе Kaspi код беруді уақытша шектеген.","url":"https://api.qut.kz/kb/sms-not-arriving","md":"https://api.qut.kz/kb/sms-not-arriving.md"},"ru":{"title":"Код из SMS от Kaspi не приходит","description":"Если при подключении кассира не приходит SMS, причина обычно одна из четырёх: SIM неактивна, номер не добавлен сотрудником в Kaspi Pay, код просрочен или Kaspi временно ограничил выдачу кодов.","url":"https://api.qut.kz/kb/ru/sms-not-arriving","md":"https://api.qut.kz/kb/ru/sms-not-arriving.md"}}},{"slug":"status-endpoint","category":"reference","updated":"2026-09-14","related":["is-it-us-or-kaspi","error-catalog","webhook-not-arriving","polling-vs-webhook","connection-lost"],"langs":{"kk":{"title":"Қызмет күйін тексеру","description":"GET /api/v1/status эндпоинті не қайтарады, оны мониторингке қалай қосу керек және мәселе бізде ме, Kaspi-де ме, әлде өз жағыңызда ма дегенді қалай ажырату керек. Өз жағыңызда бақылайтын үш көрсеткіш.","url":"https://api.qut.kz/kb/status-endpoint","md":"https://api.qut.kz/kb/status-endpoint.md"},"ru":{"title":"Проверка состояния сервиса","description":"Что возвращает GET /api/v1/status, как поставить его в мониторинг и как по шагам отличить проблему на нашей стороне от проблемы на стороне Kaspi или в вашей интеграции. Три метрики, которые стоит мерить у себя.","url":"https://api.qut.kz/kb/ru/status-endpoint","md":"https://api.qut.kz/kb/ru/status-endpoint.md"}}},{"slug":"subscription-not-running","category":"problems","updated":"2026-09-14","related":["subscriptions-api","for-subscription-business","cashier-not-connecting","tariff-limit-hit","invoice-lifecycle"],"langs":{"kk":{"title":"Жазылым бойынша счёт шықпай жатыр","description":"Жазылым кестеге сай счёт шығармаса, тексеретін алты нәрсе бар: күйі, келесі кезек уақыты, қайталау сатысы, өткізіп алу саясаты, кассир және тариф лимиті. lastRunStatus пен lastError қайдан оқылады.","url":"https://api.qut.kz/kb/subscription-not-running","md":"https://api.qut.kz/kb/subscription-not-running.md"},"ru":{"title":"Подписка не выставляет счета","description":"Если подписка не создаёт счета по расписанию, проверить нужно шесть вещей: статус, время следующего запуска, лестницу ретраев, политику пропуска, кассира и лимит тарифа. Где смотреть lastRunStatus и lastError.","url":"https://api.qut.kz/kb/ru/subscription-not-running","md":"https://api.qut.kz/kb/ru/subscription-not-running.md"}}},{"slug":"subscriptions-api","category":"reference","updated":"2026-09-14","related":["subscription-not-running","error-catalog","scopes","qr-vs-phone","refunds-api"],"langs":{"kk":{"title":"Жазылым API — кестеге сай счёт шығару","description":"Жазылым счётты кестеге сай автоматты шығарады, ал әр төлемді клиент өзі растайды. Барлық өрістер, аралықтар, қайталау сатысы, өткізіп алу саясаты, pause/resume/run әдістері және күй өрістері.","url":"https://api.qut.kz/kb/subscriptions-api","md":"https://api.qut.kz/kb/subscriptions-api.md"},"ru":{"title":"API подписок — счета по расписанию","description":"Подписка выставляет счета по расписанию, а каждую оплату подтверждает сам покупатель. Все поля создания, интервалы, лестница повторов, политика пропуска, методы pause/resume/run и поля состояния.","url":"https://api.qut.kz/kb/ru/subscriptions-api","md":"https://api.qut.kz/kb/ru/subscriptions-api.md"}}},{"slug":"support-how","category":"start","updated":"2026-09-14","related":["telegram-connect","tariff-payment","org-settings","connection-lost"],"langs":{"kk":{"title":"Қолдауға қалай жазу керек","description":"Алдымен білім базасынан іздеңіз, содан кейін кабинеттегі Қолдау бөлімі, WhatsApp, Telegram немесе email. Бірінші хатқа нені қосу керек және ол неге жауапты бір айналымға жылдамдатады.","url":"https://api.qut.kz/kb/support-how","md":"https://api.qut.kz/kb/support-how.md"},"ru":{"title":"Как написать в поддержку","description":"Сначала поиск по базе знаний, затем раздел Поддержка в кабинете, WhatsApp, Telegram или email. Что приложить к первому сообщению и почему это экономит целый круг переписки.","url":"https://api.qut.kz/kb/ru/support-how","md":"https://api.qut.kz/kb/ru/support-how.md"}}},{"slug":"switch-to-live","category":"start","updated":"2026-09-14","related":["sandbox-vs-live","after-live-not-working","going-live-checklist","trial-period","connect-cashier"],"langs":{"kk":{"title":"Нақты режимге қалай көшу керек","description":"Sandbox-тан live-қа көшу реті: алдын ала чек-парақ, режимді ауыстыру, кілтті qp_test_ -тен qp_live_ -ке ауыстыру және бірінші нақты төлемді кіші сомамен тексеру.","url":"https://api.qut.kz/kb/switch-to-live","md":"https://api.qut.kz/kb/switch-to-live.md"},"ru":{"title":"Как перейти в боевой режим","description":"Порядок перехода из песочницы в боевой режим: предварительный чек-лист, переключение режима, замена ключа qp_test_ на qp_live_ и проверка первой реальной оплаты небольшой суммой.","url":"https://api.qut.kz/kb/ru/switch-to-live","md":"https://api.qut.kz/kb/ru/switch-to-live.md"}}},{"slug":"tariff-choose","category":"start","updated":"2026-09-14","related":["tariff-payment","money-arrival","what-is-qutpay","support-how"],"langs":{"kk":{"title":"Қай тарифті таңдау керек","description":"Тариф айына шығаратын счёт санына қарай таңдалады, төлем сомасына емес. Үш тарифтің кестесі, өз санын қалай есептеу керек және тәуліктік сан неге бизнес лимиті емес.","url":"https://api.qut.kz/kb/tariff-choose","md":"https://api.qut.kz/kb/tariff-choose.md"},"ru":{"title":"Какой тариф выбрать","description":"Тариф выбирается по количеству счетов в месяц, а не по обороту. Таблица трёх тарифов, как посчитать своё число и почему суточное число — это не ограничение бизнеса, а защита.","url":"https://api.qut.kz/kb/ru/tariff-choose","md":"https://api.qut.kz/kb/ru/tariff-choose.md"}}},{"slug":"tariff-limit-hit","category":"problems","updated":"2026-09-14","related":["tariff-limits","tariff-choose","duplicate-invoices","idempotency","rate-limits"],"langs":{"kk":{"title":"Лимитке жеттім — не істеу керек","description":"tariff_limit_reached пен tariff_daily_burst — екі басқа нәрсе. Біріншісі айлық бизнес лимиті, екіншісі кодтағы циклден қорғаныс. Қалай ажырату және әрқайсысына не істеу керек.","url":"https://api.qut.kz/kb/tariff-limit-hit","md":"https://api.qut.kz/kb/tariff-limit-hit.md"},"ru":{"title":"Достигнут лимит — что делать","description":"tariff_limit_reached и tariff_daily_burst — это разные вещи. Первое про месячный лимит тарифа, второе про защиту от зацикленной интеграции. Как различить и что делать с каждым.","url":"https://api.qut.kz/kb/ru/tariff-limit-hit","md":"https://api.qut.kz/kb/ru/tariff-limit-hit.md"}}},{"slug":"tariff-limits","category":"reference","updated":"2026-09-14","related":["tariff-limit-hit","tariff-choose","trial-period","rate-limits","error-catalog"],"langs":{"kk":{"title":"Тарифтер және лимиттер — толық анықтама","description":"Үш тарифтің бағасы мен айлық счёт лимиті, тәуліктік қорғаныс саны, tariff_limit_reached пен tariff_daily_burst айырмашылығы, сынақ мерзімі және сұрау жиілігінің шектеулері — бір бетте.","url":"https://api.qut.kz/kb/tariff-limits","md":"https://api.qut.kz/kb/tariff-limits.md"},"ru":{"title":"Тарифы и лимиты — полный справочник","description":"Цены и месячные лимиты трёх тарифов, суточная защита, разница между tariff_limit_reached и tariff_daily_burst, пробный период и ограничения частоты запросов — всё на одной странице.","url":"https://api.qut.kz/kb/ru/tariff-limits","md":"https://api.qut.kz/kb/ru/tariff-limits.md"}}},{"slug":"tariff-payment","category":"start","updated":"2026-09-14","related":["tariff-choose","support-how","org-settings","money-arrival"],"langs":{"kk":{"title":"Тарифті қалай төлеу керек","description":"Тариф кабинеттегі Тариф бөлімінен төленеді. Төлегеннен кейін бірден белсенді болмаса не істеу керек: күту, күйді жаңарту, төлем тарихын қарау және қолдауға не жазу керек.","url":"https://api.qut.kz/kb/tariff-payment","md":"https://api.qut.kz/kb/tariff-payment.md"},"ru":{"title":"Как оплатить тариф","description":"Тариф оплачивается в разделе Тариф в кабинете. Что делать, если после оплаты он не стал активным сразу: подождать, обновить статус, посмотреть историю платежей, и что написать в поддержку.","url":"https://api.qut.kz/kb/ru/tariff-payment","md":"https://api.qut.kz/kb/ru/tariff-payment.md"}}},{"slug":"team-access","category":"start","updated":"2026-09-14","related":["roles-and-permissions","cabinet-login","api-keys","multiple-organizations","cabinet-tour"],"langs":{"kk":{"title":"Қызметкерге кабинетке рұқсат беру","description":"Кабинетте үш рөл бар: owner, developer, manager. Әрқайсысы нені көреді және не істей алады, қызметкерді қалай шақыру керек және ол жұмыстан кетсе не істеу керек.","url":"https://api.qut.kz/kb/team-access","md":"https://api.qut.kz/kb/team-access.md"},"ru":{"title":"Доступ для сотрудника в кабинет","description":"В кабинете три роли: owner, developer, manager. Что каждая видит и может делать, как пригласить сотрудника по номеру и что сделать, когда он увольняется.","url":"https://api.qut.kz/kb/ru/team-access","md":"https://api.qut.kz/kb/ru/team-access.md"}}},{"slug":"telegram-bot-commands","category":"reference","updated":"2026-09-14","related":["telegram-connect","telegram-bot-silent","for-telegram-bot","support-how","error-catalog"],"langs":{"kk":{"title":"Telegram бот командалары: толық тізім","description":"@QutPayBot-тың барлық командасы — счёт жасау, бүгінгі түсім, соңғы счёттар, күйі, болдырмау, қолдау. Қазақша-орысша баламалары, топта жұмыс істеуі және қандай хабарламалар келеді.","url":"https://api.qut.kz/kb/telegram-bot-commands","md":"https://api.qut.kz/kb/telegram-bot-commands.md"},"ru":{"title":"Команды Telegram-бота: полный справочник","description":"Все команды @QutPayBot — выставить счёт, выручка за день, последние счета, статус, отмена, поддержка. Русские и казахские варианты, работа в группе и какие уведомления приходят.","url":"https://api.qut.kz/kb/ru/telegram-bot-commands","md":"https://api.qut.kz/kb/ru/telegram-bot-commands.md"}}},{"slug":"telegram-bot-silent","category":"problems","updated":"2026-09-14","related":["telegram-connect","telegram-bot-commands","cabinet-tour","webhook-not-arriving","support-how"],"langs":{"kk":{"title":"Telegram бот үндемейді — тексеру реті","description":"Бот жауап бермесе немесе хабарлама жібермесе, себебі төртеудің бірі: чат ұйымға байланыспаған, бот бөгелген, топта құпиялық режимі қосулы немесе хабарлама түрі өшірілген. Ретімен тексеру.","url":"https://api.qut.kz/kb/telegram-bot-silent","md":"https://api.qut.kz/kb/telegram-bot-silent.md"},"ru":{"title":"Telegram-бот молчит — что проверить","description":"Если бот не отвечает или не шлёт уведомления, причина обычно одна из четырёх: чат не привязан к организации, бот заблокирован, в группе включён режим приватности или отключён нужный тип уведомлений.","url":"https://api.qut.kz/kb/ru/telegram-bot-silent","md":"https://api.qut.kz/kb/ru/telegram-bot-silent.md"}}},{"slug":"telegram-connect","category":"start","updated":"2026-09-14","related":["support-how","connection-lost","org-settings","cashier-vs-owner-number"],"langs":{"kk":{"title":"Telegram ботын қосу","description":"Кабинеттегі Баптау бөлімінен байланыстыру кодын аласыз да, @qutpaybot ботына /start КОД деп жазасыз. Жеке чатқа да, топқа да қосуға болады. Қандай хабарламалар келеді және қандай командалар бар.","url":"https://api.qut.kz/kb/telegram-connect","md":"https://api.qut.kz/kb/telegram-connect.md"},"ru":{"title":"Подключить Telegram-бота","description":"Берёте код привязки в разделе Настройки и пишете боту @qutpaybot команду /start КОД. Подключить можно и в личный чат, и в группу. Какие уведомления приходят и какие есть команды.","url":"https://api.qut.kz/kb/ru/telegram-connect","md":"https://api.qut.kz/kb/ru/telegram-connect.md"}}},{"slug":"test-mode-forgotten","category":"problems","updated":"2026-09-14","related":["sandbox-vs-live","switch-to-live","after-live-not-working","payment-not-arriving","api-keys"],"langs":{"kk":{"title":"Тест режимі қосулы қалып қойған","description":"Счёттар жасалып жатыр, бірақ клиентке келмейді және ақша түспейді — бұл sandbox режимінің ең танымал белгісі. Қалай тексеру, қалай көшу керек және тест счёттарына не болады.","url":"https://api.qut.kz/kb/test-mode-forgotten","md":"https://api.qut.kz/kb/test-mode-forgotten.md"},"ru":{"title":"Забыли выключить тестовый режим","description":"Счета создаются, ошибок нет, но покупателю ничего не приходит и деньги не поступают — это самый узнаваемый признак песочницы. Как проверить, как перейти и что будет с тестовыми счетами.","url":"https://api.qut.kz/kb/ru/test-mode-forgotten","md":"https://api.qut.kz/kb/ru/test-mode-forgotten.md"}}},{"slug":"testing-integration","category":"reference","updated":"2026-09-14","related":["sandbox-simulate","sandbox-vs-live","going-live-checklist","idempotency","error-catalog"],"langs":{"kk":{"title":"Интеграцияны қалай сынау керек","description":"Sandbox-та өтуге тиіс сценарийлер тізімі: сәтті төлем, болдырмау, мерзімі өту, толық және ішінара қайтару, кеш төлем. Webhook-ты қалай сынау, қандай шекті жағдайларды тексеру керек және автоматты тестті қалай жазу керек.","url":"https://api.qut.kz/kb/testing-integration","md":"https://api.qut.kz/kb/testing-integration.md"},"ru":{"title":"Как протестировать интеграцию","description":"Сценарии, которые нужно прогнать в песочнице: успешная оплата, отмена, истечение срока, полный и частичный возврат, поздняя оплата. Как тестировать вебхуки, какие граничные случаи проверить и как оформить всё это в автотесты.","url":"https://api.qut.kz/kb/ru/testing-integration","md":"https://api.qut.kz/kb/ru/testing-integration.md"}}},{"slug":"tilda-forms","category":"reference","updated":"2026-09-14","related":["n8n","for-online-store","no-developer","first-invoice","error-catalog"],"langs":{"kk":{"title":"Tilda және кез келген форма: кодсыз төлем қабылдау","description":"Форма-хук — формаңызды Qut Pay адресіне бағыттасаңыз, жіберілген сәтте счёт жасалады. Өрістерді сәйкестендіру, redirect режимі, кабинетте баптау және хукты тоқтату.","url":"https://api.qut.kz/kb/tilda-forms","md":"https://api.qut.kz/kb/tilda-forms.md"},"ru":{"title":"Tilda и любые формы: приём оплаты без кода","description":"Форм-хук — отдельный адрес, на который форма отправляет данные, и счёт создаётся в момент отправки. Сопоставление полей, режим redirect, настройка в кабинете и остановка хука.","url":"https://api.qut.kz/kb/ru/tilda-forms","md":"https://api.qut.kz/kb/ru/tilda-forms.md"}}},{"slug":"trial-period","category":"start","updated":"2026-09-14","related":["first-invoice","what-you-need","no-developer","glossary"],"langs":{"kk":{"title":"Сынақ мерзімі: қанша және не кіреді","description":"Сынақ — 7 күн, тәулігіне 50 счёт. Ең бастысы: ол тіркелген күннен емес, бірінші нақты счёттан басталады. Сондықтан асықпай дайындалып, сосын бастауға болады.","url":"https://api.qut.kz/kb/trial-period","md":"https://api.qut.kz/kb/trial-period.md"},"ru":{"title":"Пробный период: сколько длится и что входит","description":"Пробный период — 7 дней и до 50 счетов в сутки. Главное: он стартует не с даты регистрации, а с первого боевого счёта. Значит, готовиться можно спокойно.","url":"https://api.qut.kz/kb/ru/trial-period","md":"https://api.qut.kz/kb/ru/trial-period.md"}}},{"slug":"two-cashiers","category":"start","updated":"2026-09-14","related":["multiple-organizations","connect-cashier","cashier-number-requirements","api-key-connection","multi-point-reporting"],"langs":{"kk":{"title":"Бір ұйымға бірнеше кассир қосуға бола ма","description":"Иә, болады. Әр кассир — бөлек нөмір және бөлек байланыс. Негізгі кассир деген не, API кілтті нақты кассирге қалай байлау керек және айлық лимит қалай есептеледі.","url":"https://api.qut.kz/kb/two-cashiers","md":"https://api.qut.kz/kb/two-cashiers.md"},"ru":{"title":"Можно ли подключить несколько кассиров","description":"Да, можно. У каждого кассира свой номер и своя привязка. Что такое основной кассир, как привязать API-ключ к конкретному кассиру и почему лимит остаётся общим.","url":"https://api.qut.kz/kb/ru/two-cashiers","md":"https://api.qut.kz/kb/ru/two-cashiers.md"}}},{"slug":"webhook-not-arriving","category":"problems","updated":"2026-09-14","related":["payment-not-arriving","invoice-stuck-pending","duplicate-invoices","qr-expired"],"langs":{"kk":{"title":"Webhook келмей жатыр — себебін қалай табу керек","description":"Счёт төленді, бірақ сіздің серверіңізге хабарлама жетпеді. Диагностиканы қай жерден бастау керек, ең жиі кездесетін себеп қайсы және оны бір сынаумен қалай анықтауға болады.","url":"https://api.qut.kz/kb/webhook-not-arriving","md":"https://api.qut.kz/kb/webhook-not-arriving.md"},"ru":{"title":"Вебхук не приходит — как найти причину","description":"Счёт оплачен, а на ваш сервер уведомление не пришло. С чего начать диагностику, какая причина встречается чаще всего и как проверить её одним запросом.","url":"https://api.qut.kz/kb/ru/webhook-not-arriving","md":"https://api.qut.kz/kb/ru/webhook-not-arriving.md"}}},{"slug":"webhook-security","category":"reference","updated":"2026-09-14","related":["webhook-setup","webhook-signature-mismatch","security-checklist","idempotency"],"langs":{"kk":{"title":"Webhook қауіпсіздігі және қолтаңбаны тексеру","description":"Қолтаңба қалай құралады, неге raw body міндетті, timestamp-ты қалай тексеру керек, Express, Laravel, Django және таза Node үшін код мысалдары, идемпотентті өңдеу және жиі кездесетін қателер.","url":"https://api.qut.kz/kb/webhook-security","md":"https://api.qut.kz/kb/webhook-security.md"},"ru":{"title":"Безопасность вебхуков и проверка подписи","description":"Как устроена подпись, почему обязателен raw body, как проверять timestamp, примеры кода для Express, Laravel, Django и чистого Node, идемпотентная обработка и разбор частых ошибок.","url":"https://api.qut.kz/kb/ru/webhook-security","md":"https://api.qut.kz/kb/ru/webhook-security.md"}}},{"slug":"webhook-setup","category":"reference","updated":"2026-09-14","related":["webhook-security","webhook-not-arriving","invoice-lifecycle","polling-vs-webhook","testing-integration"],"langs":{"kk":{"title":"Webhook баптау","description":"Кабинетте webhook адресін қосу, оқиғаларды таңдау, құпияны сақтау, тақырыптар мен дене пішімі, 11 рет қайталау кестесі, журналды оқу, адресті сынау және қайта бағыттау ережесі.","url":"https://api.qut.kz/kb/webhook-setup","md":"https://api.qut.kz/kb/webhook-setup.md"},"ru":{"title":"Настройка вебхуков","description":"Как добавить адрес вебхука в кабинете, выбрать события и сохранить секрет, какие приходят заголовки и тело, как устроены 11 повторов, как читать журнал, протестировать адрес и что с редиректами.","url":"https://api.qut.kz/kb/ru/webhook-setup","md":"https://api.qut.kz/kb/ru/webhook-setup.md"}}},{"slug":"webhook-signature-mismatch","category":"problems","updated":"2026-09-14","related":["late-payment","is-it-us-or-kaspi","api-401"],"langs":{"kk":{"title":"Webhook қолтаңбасы сәйкес келмейді","description":"Қолтаңба HMAC-SHA256(secret, timestamp + \".\" + rawBody) арқылы есептеледі. Ең жиі қате — денені JSON-ға айналдырып, қайта жолға түрлендіру. Raw body алудың Express, Laravel, Django мысалдары.","url":"https://api.qut.kz/kb/webhook-signature-mismatch","md":"https://api.qut.kz/kb/webhook-signature-mismatch.md"},"ru":{"title":"Подпись вебхука не сходится","description":"Подпись считается как HMAC-SHA256(secret, timestamp + \".\" + rawBody). Самая частая ошибка — разобрать тело в JSON и собрать обратно в строку. Примеры получения raw body для Express, Laravel, Django.","url":"https://api.qut.kz/kb/ru/webhook-signature-mismatch","md":"https://api.qut.kz/kb/ru/webhook-signature-mismatch.md"}}},{"slug":"what-customer-sees","category":"start","updated":"2026-09-14","related":["how-customer-pays","receipts","metadata-and-orders","qr-vs-phone","data-and-privacy"],"langs":{"kk":{"title":"Клиент не көреді","description":"Клиент Kaspi қосымшасында нені көреді: сома, сипаттама және кассир нөмірі. Сипаттама шектеулері, төлемнен кейінгі чектер және сіздің ішкі деректеріңіздің көрінбейтіні.","url":"https://api.qut.kz/kb/what-customer-sees","md":"https://api.qut.kz/kb/what-customer-sees.md"},"ru":{"title":"Что видит покупатель","description":"Что покупатель видит в приложении Kaspi: сумму, описание и номер кассира. Ограничения описания, чеки после оплаты и почему ваши внутренние данные до него не доходят.","url":"https://api.qut.kz/kb/ru/what-customer-sees","md":"https://api.qut.kz/kb/ru/what-customer-sees.md"}}},{"slug":"what-is-qutpay","category":"start","updated":"2026-09-14","related":["cashier-number-requirements","connect-cashier","sandbox-vs-live","cashier-not-connecting"],"langs":{"kk":{"title":"Qut Pay деген не және қалай жұмыс істейді","description":"Qut Pay — Kaspi Pay үстінде жұмыс істейтін тәуелсіз сервис: «Кассир» рөлі арқылы Kaspi QR төлемдерін қабылдауға арналған API мен кабинет. Ақша тіке сіздің Kaspi шотыңызға түседі, бізде ешқашан болмайды.","url":"https://api.qut.kz/kb/what-is-qutpay","md":"https://api.qut.kz/kb/what-is-qutpay.md"},"ru":{"title":"Что такое Qut Pay и как он устроен","description":"Qut Pay — независимый сервис поверх Kaspi Pay: API и кабинет для приёма Kaspi QR через роль «Кассир». Деньги приходят напрямую на ваш счёт в Kaspi и никогда не попадают к нам.","url":"https://api.qut.kz/kb/ru/what-is-qutpay","md":"https://api.qut.kz/kb/ru/what-is-qutpay.md"}}},{"slug":"what-you-need","category":"start","updated":"2026-09-14","related":["cabinet-login","no-developer","trial-period","glossary"],"langs":{"kk":{"title":"Бастау үшін не керек","description":"Төрт нәрсе: Kaspi Pay бизнес-аккаунты, оның баптауына кіру құқығы, SMS қабылдайтын бөлек нөмір және сервер жағын жаза алатын адам. Соңғысы міндетті емес.","url":"https://api.qut.kz/kb/what-you-need","md":"https://api.qut.kz/kb/what-you-need.md"},"ru":{"title":"Что нужно, чтобы начать","description":"Четыре вещи: бизнес-аккаунт Kaspi Pay, доступ к его настройкам, отдельный номер с приёмом SMS и человек, который напишет один запрос на сервере. Последнее — необязательно.","url":"https://api.qut.kz/kb/ru/what-you-need","md":"https://api.qut.kz/kb/ru/what-you-need.md"}}},{"slug":"without-acquiring","category":"start","updated":"2026-10-25","related":["what-you-need","kaspi-qr-fee","kaspi-qr-on-website","connect-cashier","fiscal-receipt","internet-acquiring-kz"],"langs":{"kk":{"title":"Kaspi QR төлемін терминалсыз және банкпен эквайринг шартынсыз қабылдау: шын мәнінде не керек","description":"Kaspi QR — Kaspi-дің өз эквайрингі, сондықтан оған POS-терминал мен басқа банкпен бөлек шарт жасалмайды, бірақ төлем комиссиясын Kaspi ұстайды. ЖК немесе ЖШС-ға сайтта Kaspi QR қабылдау үшін не керек, оны Qut Pay қалай автоматтандырады және қанша тұрады.","url":"https://api.qut.kz/kb/without-acquiring","md":"https://api.qut.kz/kb/without-acquiring.md"},"ru":{"title":"Приём оплаты Kaspi QR без терминала и без договора эквайринга с банком: что на самом деле нужно","description":"Kaspi QR — это эквайринг самого Kaspi, поэтому POS-терминал и отдельный договор с другим банком для него не заключают, а комиссию за платёж удерживает Kaspi. Что нужно ИП или ТОО, чтобы принимать Kaspi QR на сайте, как это автоматизирует Qut Pay и сколько это стоит.","url":"https://api.qut.kz/kb/ru/without-acquiring","md":"https://api.qut.kz/kb/ru/without-acquiring.md"}}},{"slug":"woocommerce","category":"reference","updated":"2026-09-14","related":["plugin-not-working","webhook-setup","api-keys","refunds-api","for-online-store"],"langs":{"kk":{"title":"WooCommerce плагині","description":"Qut Pay плагинін WordPress дүкеніне орнату, API кілт пен webhook баптау, тапсырыс күйінің қалай ауысатыны, қайтару, чек және жиі кездесетін мәселелердің шешімі.","url":"https://api.qut.kz/kb/woocommerce","md":"https://api.qut.kz/kb/woocommerce.md"},"ru":{"title":"Плагин WooCommerce","description":"Как установить плагин Qut Pay в магазин на WordPress, настроить API-ключ и вебхук, как меняются статусы заказа, как делать возвраты, где чек и что делать при типовых сбоях.","url":"https://api.qut.kz/kb/ru/woocommerce","md":"https://api.qut.kz/kb/ru/woocommerce.md"}}},{"slug":"wrong-amount","category":"problems","updated":"2026-09-14","related":["api-401","money-not-received","what-is-qutpay"],"langs":{"kk":{"title":"Сома дұрыс емес немесе тиын жоғалып жатыр","description":"Телефонға шығарылған счёт бүтін теңге қабылдайды, QR счёт ең көбі екі ондық. amount_must_be_whole_tenge қатесінің себебі, дөңгелектеуді өз жағыңызда қалай дұрыс істеу керек.","url":"https://api.qut.kz/kb/wrong-amount","md":"https://api.qut.kz/kb/wrong-amount.md"},"ru":{"title":"Сумма неверная или теряются тиыны","description":"Счёт по телефону принимает только целые тенге, QR-счёт — не более двух знаков после запятой. Откуда берётся ошибка amount_must_be_whole_tenge и как правильно округлять на своей стороне.","url":"https://api.qut.kz/kb/ru/wrong-amount","md":"https://api.qut.kz/kb/ru/wrong-amount.md"}}}]}