Вопросы и ответы
Настоящие вопросы бизнесов о кассе Kaspi, оплате на сайте, подписках, долгах и API. Самое главное коротко собрано на главной странице, здесь подробнее.
О сервисе
Для чего нужен KazPayment, если коротко?
Чтобы не выставлять счета и не напоминать об оплате вручную. KazPayment от имени вашей кассы Kaspi Pay для бизнеса выставляет клиентам счета — по расписанию подписки, разово или по заказу с сайта. Тем, кто не оплатил, он сам отправляет напоминания и отмечает оплату, как только она появится в выписке кассы.
Деньги идут сразу на ваш счёт. KazPayment их не хранит и не переводит, он только видит поступления, чтобы вести учёт.
Можно ли сначала попробовать без настоящих денег?
Да, в песочнице. Это отдельная копия бизнеса, где оплату нажимаете вы сами: «Оплатить», «Отклонить» или «Оплатить другой суммой». Клиентам из песочницы ничего не уходит, все сообщения получает только владелец. Касса Kaspi там не нужна.
Создаётся в разделе «Подключения» → «Интеграция» → «Песочница для разработчиков», на любом тарифе, включая Free. Выдуманные оплаты в боевые отчёты не попадают. Подробно: Песочница и первые шаги.
Я загрузил клиентов и подключил кассу. Им уже ушли счета?
Нет. У нового бизнеса счета по расписанию стоят на паузе, пока вы не нажмёте «Начать выставлять счета» на плашке вверху кабинета. Так клиенты не получат счета, пока вы ещё только осматриваетесь.
Ручной счёт, ссылка на оплату и заказы через API работают сразу: их вы запускаете сами.
Как выгрузить оплаты в 1С?
В разделе «Деньги» → «Поступления» выберите месяц и нажмите «Выгрузить для 1С». Файл загружается в 1С обычной обработкой «Загрузка выписки из банка». Каждая оплата идёт в нём отдельным документом с расшифровкой: тариф, период, клиент.
Не загружайте в одну базу и эту выгрузку, и банковскую выписку Kaspi за тот же период, иначе поступления удвоятся. Перед первой выгрузкой заполните БИН/ИИН, реквизиты и КНП в разделе «Бизнес» → «О компании». Без КНП файл не скачается. Подробно: Выгрузка в 1С.
Касса Kaspi
Как подключить кассу Kaspi к сервису?
- В Kaspi Pay для бизнеса под своим номером добавьте отдельного кассира с отдельной сим-картой, к которой у вас всегда есть доступ.
- В кабинете KazPayment откройте «Подключения» → «Вход в Kaspi» и введите номер этого кассира.
- Введите код из SMS, которое пришлёт Kaspi.
Отдельный кассир нужен потому, что Kaspi допускает только один активный вход на номер. Под вашим личным номером вы с сервисом выбивали бы друг друга при каждом входе. Подробно: Подключить кассу Kaspi.
Как сменить кассира или отключить его от сервиса?
Чтобы сменить кассира, заведите нового в Kaspi Pay для бизнеса и снова войдите в разделе «Подключения» → «Вход в Kaspi» с его номером («Всё равно войти заново»). Старый вход закроется.
Чтобы сервис совсем перестал входить в вашу кассу, нажмите там же «Отключить кассу». Неоплаченные счета отменятся в Kaspi, новые не будут выставляться, напоминания перестанут уходить, подписки за неоплату не отменятся. Долг клиентов сохранится: снова подключите кассу обычным входом по SMS и нажмите «Начать выставлять счета». Для интеграций то же самое есть в API: POST /api/v1/kaspi/disconnect.
Можно ли изменить текст, который клиент видит в счёте Kaspi?
Зависит от того, откуда пришёл счёт:
- Заказ через API. Без дополнительных полей подпись собирается так: «Заказ <первые 40 символов comment> · <номер заказа>». Если передать
invoice_text(до 200 символов), клиент увидит в приложении Kaspi ровно этот текст, без «Заказ» и без номера. Что именно он увидит, приходит в ответе в полеinvoiceText. У уже созданного заказа текст поменять нельзя: при повторе с тем же номеромcommentиinvoice_textне учитываются. - Подписка. В счёте указаны название тарифа и период, например «Оплата за ноябрь 2026». Поэтому называйте тариф так, как это должен прочитать клиент.
- Ручное начисление. Клиент видит повод, который вы ввели.
Название компании в чеке Kaspi берёт из раздела «О компании» в Kaspi Pay для бизнеса. Менять его нужно там, а не в KazPayment. Подробно: документация API.
Оплата и сайт
Клиент может заплатить картой или из другого банка, не через Kaspi?
Из другого банка — да. На странице оплаты есть QR-код: это Единый QR, его читают приложения других казахстанских банков. Ссылку на эту страницу можно отправить самому, она также уходит в напоминаниях.
Принять оплату картой Visa/Mastercard прямо на сайте, без Kaspi и без банковского приложения, KazPayment не умеет. Для этого нужен интернет-эквайринг банка.
Хочу на сайте оплату как у авиакомпаний: кнопка, открывается Kaspi с суммой, сайт узнаёт об оплате. Как подключить?
Есть два способа, всё зависит от цены:
- Цена фиксированная (товар, услуга, билет на курс). Заведите товар в разделе «Товары» и откройте «Действия» → «Кнопка для сайта». Полученную строку вставьте в код страницы: в Tilda, Wix, Taplink это блок «HTML». С телефона кнопка сразу открывает приложение Kaspi с суммой, а с компьютера — страницу с QR. Программист не нужен. Подробно: QR на товар.
- Сумма каждый раз своя (корзина, бронь). Сайт создаёт заказ через API и получает ссылку на оплату. С телефона эта страница первой предлагает «Оплатить в Kaspi». Если нужно, чтобы покупатель попадал в Kaspi сразу, без промежуточной страницы, ваша кнопка отправляет форму на адрес
/api/public/pay/<токен>/go.
О поступлении денег сайт узнаёт из вебхука payment.received, а на случай сбоя может запросить статус заказа. API и вебхуки есть на любом тарифе, на Free — до 500 заказов через API за 30 дней. Пошагово: Подключить интернет-магазин или телеграм-бот.
Клиент оплатил, а в кабинете оплаты нет. Что делать?
Оплата подтверждается по выписке кассы, обычно за несколько минут. Если прошло больше часа, проверьте раздел «Расхождения»: туда попадают оплаты, которым не нашлось счёта в KazPayment, например лишний второй платёж.
Если в это время закончилась сессия кассы, сверка ждёт, пока вы снова войдёте в Kaspi. Уже выставленные счета клиенты всё равно могут оплатить. Подробно: Оплата по ссылке и QR.
Как вернуть деньги клиенту?
Найдите оплаченное начисление в разделе «Начисления», нажмите «Возврат» и укажите сумму (можно часть) и причину. Сначала возврат проходит через кассу Kaspi, и только после её подтверждения меняется учёт. Деньги вернутся на ту же карту, с которой клиент платил.
Сделать возврат может владелец или админ, у роли «сотрудник» такой кнопки нет. Возвраты лучше делать из кабинета, а не в приложении Kaspi: тогда учёт сходится сам. Подробно: Вернуть деньги клиенту.
Где раздел «Отгрузки» и для чего он нужен?
Раздел для торговли с отсрочкой платежа: вы отгрузили товар сегодня, а счёт должен уйти, например, через 14 дней. «Отгрузки» сами выставят его в нужный день, в Kaspi или счётом на оплату для юрлица, и повторят счёт, если клиент не заплатил.
По умолчанию раздел выключен. Включается в «Бизнес» → «Настройки» → «Разделы меню», галочка «Отгрузки». После этого он появится в меню слева, в группе «Товары». Отгрузки можно вносить вручную или загружать реестром из Excel. Подробно: Отгрузки.
Подписки и долг
Чем тариф «каждые 30 дней от оплаты» отличается от календарного месяца?
У календарного тарифа счёт приходит в одно и то же число каждого месяца, по умолчанию 1-го. Не важно, когда клиент заплатил за прошлый месяц.
У тарифа «от дня оплаты» (каждые 7, 30, 90 или 365 дней) следующий счёт приходит, когда закончится оплаченный период. Если клиент заплатил с опозданием, отсчёт начинается со дня оплаты, и дни просрочки оплаченные дни не съедают. Пока счёт не оплачен, новый период не начинается. Исключение — режим «Добавлять долг в следующий счёт» (см. ниже).
Календарный тариф удобен школам и секциям с занятиями по месяцам, тариф «от оплаты» — залам, клубам и доступу на срок. Подробно: Первые начисления.
Что происходит, если клиент не оплатил подписку?
Напоминания уходят по вашим сценариям: по умолчанию за 3 дня до срока, в день срока и через 3 дня после него. Дальше всё решает правило «Если клиент не оплатил подписку». Оно задаётся внизу раздела «Тарифы», общее для всех тарифов или своё у отдельного тарифа:
- Копить долг отдельными счетами (по умолчанию). Подписка действует, за каждый период выставляется свой счёт.
- Добавлять долг в следующий счёт. Неоплаченная сумма входит в счёт за следующий период, и клиент платит один раз за всё.
- Не считать пропущенное долгом. Через выбранное число дней (от 1 до 90) неоплаченный счёт закрывается, а подписка продолжается.
- Отменять подписку. Через выбранное число дней (от 1 до 90) подписка отменяется с причиной «Не платил / не открывал счета», и неоплаченные счета закрываются.
Если счёт исчез из Kaspi без оплаты, новый по умолчанию уйдёт через 3 дня, а не сразу. Всё это время клиент может заплатить по ссылке из напоминания. Подробно: Напоминания об оплате.
Клиент пропустил несколько месяцев. Долг соберётся в один счёт? Есть ли предел?
В один счёт долг собирается, если выбран режим «Добавлять долг в следующий счёт».
- Календарный тариф копит долг без предела. Клиент увидит, например, «Оплата за ноябрь 2026 и долг за 1 пропущенный период».
- Тариф «от оплаты» тоже копит: периоды идут и без оплаты, и счёт растёт (1 500 → 3 000 → 4 500 ₸). Предел задаётся числом «периодов в счёте»: от 1 до 24, по умолчанию 3. Когда в счёте набралось столько периодов и с его срока прошёл ещё один целый период, подписка отменяется сама с причиной «Не платил / не открывал счета».
Если клиент оплатил выросший счёт, у тарифа «от оплаты» доступ продлевается на один период от дня оплаты, а не на все накопленные.
Клиент отменил подписку и потом подписался снова. Можно выставить ему прежний долг?
Можно, если заранее включить в том же правиле галочку «При новой подписке выставлять долг за пропущенные периоды» и задать предел от 1 до 24 периодов. Тогда первый счёт новой подписки включит пропущенные периоды, не больше предела, плюс первый новый период.
Условия:
- прежнюю подписку отменили из-за неоплаты: сама по правилу «Отменять подписку», по пределу растущего счёта или вручную с причиной «Не платил / не открывал счета» (в API —
cancel_reason: no_response); - это тот же клиент, то есть тот же номер телефона.
Если отменить вручную с другой причиной или без причины, долг за перерыв не выставится: при отмене неоплаченные счета закрываются, и долг пропадает. Дважды за один и тот же перерыв долг тоже не выставляется.
Как перенести подписчиков из другой системы, чтобы они не платили второй раз?
При оформлении подписки укажите, до какого дня клиент уже заплатил: в кабинете это поле «Уже оплачено до», в API — paid_until. Подписка начнётся на следующий день, и первый счёт придёт только за то, что ещё не оплачено. Долг за перерыв при переносе не начисляется.
У календарного тарифа (неделя, месяц, квартал, год) дата должна совпадать с последним днём периода, например 30.11. Иначе подписка не оформится.
Историю прежних оплат перенести нельзя: за то время счетов в KazPayment не было. Саму базу клиентов можно загрузить из Excel, это описано в FAQ на главной.
Интеграция и API
Клиент оставляет имя, телефон и выбирает тариф, а ссылка на оплату сама приходит ему в WhatsApp. Так можно?
Можно, но форму и порядок шагов настраивает ваш сайт через API. Отдельной формы записи в кабинете KazPayment нет. Обычная схема такая:
- Клиент заполняет форму на вашем сайте.
- Для разовой оплаты сайт создаёт заказ (
POST /api/v1/ordersсcustomer_phone) и отправляет клиенту ссылку в WhatsApp (POST /api/v1/orders/{номер}/notify). Для регулярной оплаты сайт заводит клиента и подписку (/api/v1/payers,/api/v1/subscriptions). Дальше KazPayment сам выставляет счета в Kaspi, а напоминания со ссылкой уходят по вашим сценариям. - После оплаты сайт получает вебхук
payment.receivedи делает своё: открывает доступ, отправляет «оплата получена» черезPOST /api/v1/whatsapp/order.
Учтите, что свободный текст в WhatsApp Meta не пропускает, только одобренные шаблоны. Для своего текста KazPayment заводит отдельный шаблон, одобрение занимает около суток. Сообщения платные и списываются с баланса. Подробно: Свой сценарий.
У меня закрытый Telegram-канал (клуб, курс) по подписке. Как выдавать и забирать доступ?
Оформляйте клиентам подписку, а не разовый заказ. Сроки, долг и отмену за неоплату ведёт KazPayment, а ваш бот или сайт только открывает и закрывает доступ:
- После каждой оплаты приходит вебхук
payment.receivedс полемpaid_until. Это последний оплаченный день, считать периоды у себя не нужно. - При отмене подписки приходит
subscription.cancelled, неважно, кто её отменил: вы, владелец в кабинете или правило неоплаты. В нём тоже естьpaid_until: если подписку отменили посреди оплаченного периода, доступ честно остаётся до этой даты.
Пауза подписки события об отмене не присылает. Подробно: документация API.
Вебхук не приходит. Что проверить?
Сначала запросите GET /api/v1/webhook: там видно адрес и результат последней доставки. Затем отправьте тестовое событие POST /api/v1/webhook/test — оно идёт тем же путём и с той же подписью, что и настоящие.
Адрес приёмника должен быть на https с публичным доменным именем. Приёмник должен ответить 2xx за 10 секунд. Подробно: Вебхук не приходит.
Не нашли ответ?
Спросите в чате на главной странице или напишите на почту поддержки. Подробные шаги — в инструкциях, для разработчиков — документация API.
Начать бесплатно