База знаний

Ответы на вопросы о приёме платежей Kaspi через QR — простыми словами. Подключение кассира, счета, вебхуки, возвраты, подписки, тарифы.

126 статей

Не знаете, с чего начать? Как подключить →

Начало работы28

Первое подключение: кассир, номера, песочница, тариф, вход в кабинет.

Безопасно ли подключать и как всё устроеноСервис работает через ограниченную роль «Кассир» в Kaspi Pay: выставить счёт, увидеть статус, вернуть по своим счетам. Доступа к деньгам нет. Что мы храним и как отключить в любой момент.Доступ для сотрудника в кабинетВ кабинете три роли: owner, developer, manager. Что каждая видит и может делать, как пригласить сотрудника по номеру и что сделать, когда он увольняется.Заполнить данные организацииНазвание организации, название магазина, юридические данные и контакты заполняются в разделе Настройки. Что из этого видит покупатель, что попадает в чек и как менять название.Как войти в кабинетВход по номеру телефона, пароля нет. Кнопка WhatsApp, Telegram или код. Самая частая ошибка — попытка войти с номера кассира, он предназначен совсем для другого.Как написать в поддержкуСначала поиск по базе знаний, затем раздел Поддержка в кабинете, WhatsApp, Telegram или email. Что приложить к первому сообщению и почему это экономит целый круг переписки.Как оплатить тарифТариф оплачивается в разделе Тариф в кабинете. Что делать, если после оплаты он не стал активным сразу: подождать, обновить статус, посмотреть историю платежей, и что написать в поддержку.Как перейти в боевой режимПорядок перехода из песочницы в боевой режим: предварительный чек-лист, переключение режима, замена ключа qp_test_ на qp_live_ и проверка первой реальной оплаты небольшой суммой.Как платит покупательДо покупателя можно дойти тремя способами: сканирование QR, ссылка на оплату и счёт прямо в приложение Kaspi по номеру телефона. Когда какой удобнее и сколько живёт каждый.Как подключить кассира KaspiПошаговая инструкция из двух частей: сначала заводите роль «Кассир» в приложении Kaspi Pay, затем привязываете номер в кабинете по коду из SMS. Всё вместе занимает 2–3 минуты.Как создать первый счётДва способа: вручную из кабинета за два поля или одним запросом к API. Первый счёт разумно сделать в песочнице и там же симулировать оплату.Какой тариф выбратьТариф выбирается по количеству счетов в месяц, а не по обороту. Таблица трёх тарифов, как посчитать своё число и почему суточное число — это не ограничение бизнеса, а защита.Кассир Kaspi не подключается — почему и что делатьДиагностика по симптому: Kaspi просит пароль или видеоверификацию, спрашивает ИИН, не приходит SMS, не успеваете ввести код. Причина и решение для каждого случая, а также тайминги SMS.Когда и куда приходят деньгиДеньги приходят напрямую на ваш счёт Kaspi Pay в момент оплаты — у нас они не задерживаются. Плата за сервис не зависит от суммы платежа, это месячная подписка. Как вести сверку.Можно ли подключить несколько кассировДа, можно. У каждого кассира свой номер и своя привязка. Что такое основной кассир, как привязать API-ключ к конкретному кассиру и почему лимит остаётся общим.Несколько организаций в одном аккаунтеС одного номера можно вести несколько организаций. У каждой свой кассир, свои ключи, свои вебхуки и свой тариф. Тарифы не складываются — каждая платит за себя.Нет программиста — как начатьПять способов работать без кода: счета вручную из кабинета, постоянные ссылки на оплату, Telegram-бот, модули WooCommerce и OpenCart, форм-хук для Tilda.Номер кассира и ваш личный номерВ системе три разных номера: ваш личный, номер кассира и номер покупателя. Для чего нужен каждый, какие ошибки встречаются чаще всего и почему нельзя делать кассиром свой номер.Перешёл в боевой режим — не работаетЕсли после перехода счета не создаются или оплата не доходит — проверка за пять минут. Ключ, кассир, тариф, адрес вебхука и сам режим, по каждому пункту конкретное действие.Подключить Telegram-ботаБерёте код привязки в разделе Настройки и пишете боту @qutpaybot команду /start КОД. Подключить можно и в личный чат, и в группу. Какие уведомления приходят и какие есть команды.Поручить интеграцию ИИ-агентуClaude, Cursor или другой ИИ-агент может написать интеграцию с Qut Pay сам. Что ему дать, как устроен автономный цикл в песочнице и почему боевой ключ агенту давать нельзя.Пробный период: сколько длится и что входитПробный период — 7 дней и до 50 счетов в сутки. Главное: он стартует не с даты регистрации, а с первого боевого счёта. Значит, готовиться можно спокойно.Словарь терминовЧасть обращений в поддержку — просто непонятый термин. Здесь 25 терминов простыми словами, к каждому одно-два предложения и пример.Три условия для номера кассираУспех подключения почти целиком зависит от выбора номера: настоящая SIM, на ИИН владельца не зарегистрированы ИП или ТОО, и на номере только роль «Кассир». Как подобрать номер заранее.Чем песочница отличается от боевого режимаВ песочнице Kaspi не вызывается вообще, реальных денег нет и кассир не нужен — оплату вы симулируете сами. Полное сравнение двух режимов и что проверить при переходе в боевой.Что видит покупательЧто покупатель видит в приложении Kaspi: сумму, описание и номер кассира. Ограничения описания, чеки после оплаты и почему ваши внутренние данные до него не доходят.Что где находится в кабинетеЗачем нужен каждый из десяти разделов, что означает отметка режима вверху, где переключить организацию, язык и тёмную тему. Прочитать один раз — и больше не искать.Что нужно, чтобы начатьЧетыре вещи: бизнес-аккаунт Kaspi Pay, доступ к его настройкам, отдельный номер с приёмом SMS и человек, который напишет один запрос на сервере. Последнее — необязательно.Что такое Qut Pay и как он устроенQut Pay — независимый сервис поверх Kaspi Pay: API и кабинет для приёма Kaspi QR через роль «Кассир». Деньги приходят напрямую на ваш счёт в Kaspi и никогда не попадают к нам.

Решение проблем32

Что проверить, когда что-то не работает: оплата, кассир, вебхуки, возвраты.

Вебхук не приходит — как найти причинуСчёт оплачен, а на ваш сервер уведомление не пришло. С чего начать диагностику, какая причина встречается чаще всего и как проверить её одним запросом.Возврат не проходитРазбор ошибок возврата по коду: счёт не подлежит возврату, неверная сумма, Kaspi не выполнил операцию или результат неизвестен. Где можно повторять запрос, а где категорически нельзя.Достигнут лимит — что делатьtariff_limit_reached и tariff_daily_burst — это разные вещи. Первое про месячный лимит тарифа, второе про защиту от зацикленной интеграции. Как различить и что делать с каждым.Забыли выключить тестовый режимСчета создаются, ошибок нет, но покупателю ничего не приходит и деньги не поступают — это самый узнаваемый признак песочницы. Как проверить, как перейти и что будет с тестовыми счетами.Как не вернуть деньги дваждыПри ответах refund_unknown и refund_pending_unknown повтор запроса — кратчайший путь к двойному возврату. Вместо этого нужно прочитать статус счёта. Идемпотентность, учёт частичных возвратов и журнал.Кассир принадлежит другой организации KaspiОрганизация Kaspi фиксируется при первой привязке и потом не меняется. Значит, подключать нужно кассира именно этой организации. Что делать, если у вас несколько ИП или ТОО, и как это спланировать заранее.Кассир сменился или сменился номер — что делатьКассир уволился, сменился номер, потерялась SIM или сменился владелец бизнеса. Что нажать в кабинете в каждом случае и что будет со старыми счетами.Код из SMS от Kaspi не приходитЕсли при подключении кассира не приходит SMS, причина обычно одна из четырёх: SIM неактивна, номер не добавлен сотрудником в Kaspi Pay, код просрочен или Kaspi временно ограничил выдачу кодов.Не могу войти в кабинетПароля в кабинете нет, вход по номеру телефона. Самая частая ошибка — пытаться войти с номера кассира. Что делать, если код не приходит, и почему кабинет выглядит пустым.Оплата не приходит покупателюСчёт создан, но на телефон покупателя ничего не пришло или QR не открывается. Чаще всего причина в том, что остался включённым тестовый режим. Шесть шагов проверки.Оплата подтверждается медленно — почему и что делатьПокупатель заплатил, а счёт не сразу становится paid. Как частота проверки зависит от возраста счёта, сколько это занимает на практике и что делать в сценариях, чувствительных к задержке.Ошибка «организация в архиве» — что делатьЕсли API отвечает organization_inactive (410), дело не в ключе, а в том, что организация неактивна. Новый ключ не поможет. Причины, как выбрать правильный ключ и что указать в обращении в поддержку.Ошибка «счёт не найден» — почему и что проверитьУ invoice_not_found четыре причины: неверный идентификатор, счёт создан в другом режиме, ключ привязан к другому кассиру или счёт принадлежит другой организации. Порядок проверки.Плагин WooCommerce или OpenCart не работаетЕсли плагин не создаёт счета или статус заказа не меняется, проверять нужно четыре вещи: ключ, совпадение режимов, публичную доступность адреса вебхука и журнал магазина.Подписка не выставляет счетаЕсли подписка не создаёт счета по расписанию, проверить нужно шесть вещей: статус, время следующего запуска, лестницу ретраев, политику пропуска, кассира и лимит тарифа. Где смотреть lastRunStatus и lastError.Подпись вебхука не сходитсяПодпись считается как HMAC-SHA256(secret, timestamp + "." + rawBody). Самая частая ошибка — разобрать тело в JSON и собрать обратно в строку. Примеры получения raw body для Express, Laravel, Django.Поздняя оплата — счёт закрыт, а деньги пришлиНа отменённый или просроченный счёт деньги могут прийти с опозданием. В этом случае событие invoice.paid приходит с меткой late: true. Что делать и как заранее подготовить к этому код.Привязка кассира оборвалась — как переподключитьСчета внезапно перестали создаваться — значит, сессия Kaspi оборвалась. Переподключение занимает минуту. Причина, шаги и что сделать, чтобы не повторялось.Проблема у вас или у Kaspi — диагностика за две минутыТри вопроса показывают, на чьей стороне сбой: в вашей интеграции, в привязке Kaspi или в самом сервисе. К каждому ответу — конкретное действие и список того, что собрать для поддержки.Сумма неверная или теряются тиыныСчёт по телефону принимает только целые тенге, QR-счёт — не более двух знаков после запятой. Откуда берётся ошибка amount_must_be_whole_tenge и как правильно округлять на своей стороне.Счета дублируютсяЕсли на один заказ выставляется несколько счетов, сначала надо остановить поток: удалите API-ключ — интеграция встанет в ту же секунду. Потом ищите причину и включайте идемпотентность.Счета массово падают — что делатьЕсли отправить много счетов разом, Kaspi может ограничить частоту запросов кассира. Автоматических повторов нет. Пауза, отправка по очереди и разбор кодов ошибок.Счёт завис в статусе pendingPending — не ошибка, а нормальное состояние: счёт выставлен, покупатель ещё не подтвердил. Сколько он живёт, когда станет expired, как мы его проверяем и когда действительно стоит волноваться.Счёт оплачен, а денег нетПричин три: включён тестовый режим, деньги ищут не там, или кассир принадлежит другой организации Kaspi. Как проверить каждую и что делать дальше.У покупателя нет приложения Kaspi — как принять оплатуСчёт по телефону (kind phone) приходит в приложение Kaspi покупателя, и без приложения он просто не дойдёт. Вместо него нужен QR или ссылка на оплату. Как проверить заранее.Удалил API-ключ — что теперь будет и что делатьУдалённый ключ перестаёт работать мгновенно, восстановить его нельзя. На счета и деньги это не влияет. Как создать новый, заменить его в интеграции и не забыть про привязку к кассиру.Экспорт не открывается или выглядит невернымВ выгруженном CSV вместо букв иероглифы, всё слиплось в одну колонку или не хватает счетов. Разбираем кодировку, разделитель, фильтры и как правильно передать выгрузку бухгалтеру.API отвечает 401 — ключ не принимается401 unauthorized означает, что в запросе нет действующего API-ключа. Причины, порядок проверки и рабочий пример curl. Чаще всего виноват заголовок или префикс Bearer.API отвечает 403 — не хватает прав403 значит, что ключ распознан, но на это действие прав нет. Причин пять: не хватает scope, неактивный тариф, чужая организация, привязка ключа к кассиру, действие только для песочницы.API-ключ утёк — что делать срочноКлюч попал в репозиторий, чат или чужие руки. Что сделать в первую минуту: удалить, создать новый, проверить последние счета. Что вообще можно сделать ключом и как не допустить повторения.QR показывает «попробуйте позже»Если покупатель сканирует QR и видит ошибку, чаще всего истекло окно сканирования. Окно задаёт Kaspi, берите его из поля expiresAt. Чем печатный QR отличается от QR на экране.Telegram-бот молчит — что проверитьЕсли бот не отвечает или не шлёт уведомления, причина обычно одна из четырёх: чат не привязан к организации, бот заблокирован, в группе включён режим приватности или отключён нужный тип уведомлений.

Для вашего бизнеса25

Как приём Kaspi устроен под ваш сценарий.

Автошколы и курсыКак собирать оплату за обучение через Kaspi: счёт вручную из кабинета, подписка для периодических платежей, массовое выставление на группу и ссылка на оплату. Как устроена отчётность по группам.Аренда и прокатСтанции пауэрбанков, велосипеды, самокаты, инструмент, одежда. Как брать и возвращать залог, периодическая оплата, выдача автоматом по QR и частичный возврат.Бизнес по подпискеПодписка — это выставление счёта по расписанию, деньги со счёта клиента сами не уходят. Лестница повторов, политика пропусков, pause/resume, напоминания и отчётность.Выставление счетов Kaspi из 1СКак выставлять Kaspi QR-счета прямо из документа 1С: подключение через HTTP-сервис, массовая отправка, опрос статуса или приём вебхука, сопоставление по externalOrderId и возвраты.Маркетплейс и агрегаторЕсли деньги должны приходить на счёт Kaspi каждого продавца: своя организация и свой кассир для каждого, разделение ключей, отдельные вебхуки. Как удерживать комиссию.Медицинский центрОплата приёма, предоплата и бронирование времени, оплата анализов, чеки и возвраты. И главное правило: никаких данных о пациенте в описании счёта — только название услуги.Мероприятия и продажа билетовПредпродажа через ссылку на оплату или форму на сайте, оплата на входе по QR или счётом на телефон, массовое выставление, номер места в metadata и возвраты при отмене.Онлайн-школа и платформа курсовПродажа доступа к курсу, открытие доступа по webhook, периодические платежи, групповые тарифы и скидки. Плюс правило App Store и Google Play, если у школы есть мобильное приложение.Оплата в вендинговом автомате без терминалаДинамический QR на экране автомата, покупатель сканирует, приходит вебхук, контроллер выдаёт товар. Схема для автоматов воды, кофе и снеков, требования к железу и окно QR.Оптовая торговляСчета на крупные суммы, привязка к номеру заказа, до 100 счетов одним запросом, подписки для постоянных клиентов, связка с 1С, частичная оплата траншами и возвраты.Парковки и шлагбаумыQR на экране у выезда или счёт по номеру билета, вебхук открывает шлагбаум через IP-реле. Динамический и печатный QR, номер машины в metadata, борьба с задержкой.Подключить свою CRMBitrix24, amoCRM, Kommo, Altegio, МойСклад — готового модуля нет, подключение идёт через API. Достаточно, чтобы CRM умела отправлять HTTP-запрос наружу. Сделка переходит на стадию оплаты — выставляется счёт.Приём оплаты в мобильном приложенииПравильный порядок: приложение → ваш сервер → Qut Pay → Kaspi. Почему API-ключ не должен попадать в APK и IPA, что происходит при открытии payUrl и правила App Store и Play Market.Приём по QR на офлайн-точкеКассир показывает динамический QR на экране, клиент сканирует. Окно сканирования ограничено — время берите из поля expiresAt. Когда удобнее QR, когда счёт на телефон и как разделить несколько точек.Приём Kaspi для интернет-магазинаПолная схема от корзины до статуса «оплачен»: счёт, страница оплаты, вебхук. Способы без кода для Tilda, WooCommerce и OpenCart, и путь через API для самописного сайта.Продажи в прямом эфире TikTokКак выставлять счёт за секунды прямо во время эфира: пуш по номеру телефона, команда /invoice в Telegram-боте, QR на экране, работа с помощником и контроль оплат.Продажи через InstagramПорядок работы в директе: ссылка на оплату, ручной счёт из кабинета, счёт командой из Telegram-бота. Всё работает без кода. Как вести учёт и не перепутать заказы.Продажи через Telegram-ботаБот → ваш сервер → счёт → пуш или ссылка покупателю → вебхук → выдача товара. Защита от вала неоплаченных счетов, несколько брендов в одном боте, примеры на Python и Node.Ресторан и кафеQR на столе, экран на кассе, счёт на сумму чека, раздельная оплата, учёт по официантам и заказы на доставку — как Qut Pay работает в зале и что учесть заранее.Салон красоты и барбершопСвязка с системой записи, предоплата, клиент не пришёл, возврат. Путь без кода и путь через API, раздельный учёт по мастерам.Служба доставкиКурьер выставляет счёт в момент доставки, клиент платит со своего телефона. Через Telegram-бота или своё приложение, с номером заказа и метаданными, с возвратами и обработкой недоставленных заказов.Спортзал и фитнесПродажа абонементов, продление, ежемесячные счета через подписку, заморозка и возврат, открытие турникета по webhook — разбор сценариев для фитнес-клуба с примерами запросов.Таксопарк: сбор платежей с водителейМассовое выставление счетов по списку водителей, защита от дублей через идемпотентность, разбор ошибок по каждому элементу отдельно и автоматизация ежедневного сбора.Фрилансеру и частному специалистуСамый простой сценарий: зашли в кабинет, выставили счёт, отправили ссылку клиенту. Постоянная ссылка, ссылка с открытой суммой, счёт из Telegram-бота. Код не нужен.SaaS-платформа: оплата за клиентовКак дать клиентам вашей платформы принимать Kaspi на их собственные счета: хранение ключей, выставление счетов от имени клиента, полная автоматизация через Partner API и отдельный вебхук на каждого.

Справочник41

Технические детали для разработчиков.

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

Остались вопросы? WhatsApp +77788813333 · kazprose@gmail.com
Написать можно и из кабинета: Поддержка.

Qut Pay — независимый сервис, не аффилирован с АО «Kaspi Bank». Kaspi и Kaspi Pay — товарные знаки их правообладателя.