Qut Pay · Для разработчиков AI-сервисов
Монетизация AI-сервиса через Kaspi: пакеты пополнения баланса
Каждый запрос к модели стоит вам денег, поэтому выгоднее, когда пользователь платит заранее: покупает пакет вопросов, генераций или минут и тратит его. Пользователь выбирает пакет, платит в приложении Kaspi.kz, ваш сервер получает webhook с ID пользователя и начисляет баланс.
2–6 пакетов
на одной ссылке оплаты
- Деньги сразу на ваш счёт Kaspi Pay
- Каждый оплаченный пакет — одна оплата из лимита тарифа
- Kaspi удерживает свою комиссию отдельно
- Сначала всё проверяется в тестовом режиме
Кому подходит
- Веб-сервисам на GPT, Claude и других моделях: ассистенты, генерация текста, картинок, озвучка, расшифровка.
- AI SaaS с личным кабинетом, где у пользователя есть баланс или кредиты.
- WhatsApp-ботам: бот отправляет пользователю ссылку на оплату, оплата проходит на веб-странице.
- Сайтам курсов и консультаций, где пакет — это количество занятий, проверок или ответов.
Для всего этого нужен бизнес-аккаунт Kaspi Pay (ИП или ТОО) и сервер, который принимает webhook.
Важно про Telegram-ботов
- Если вы продаёте цифровые товары или услуги внутри Telegram-бота или mini app, правила Telegram требуют принимать оплату только в Telegram Stars (core.telegram.org/bots/payments-stars). Бота, который ведёт на стороннюю оплату цифрового товара, Telegram может скрыть в мобильных приложениях.
- Поэтому мы не предлагаем пакеты пополнения для оплаты внутри Telegram-ботов. Сценарий рассчитан на веб-сервисы, сайты, кабинеты SaaS и WhatsApp-ботов.
Как это работает
Создаёте ссылку с пакетами
В кабинете Qut Pay — ссылка оплаты с 2–6 пакетами, например «1 000 ₸ — 100 вопросов», «5 000 ₸ — 600 вопросов», «10 000 ₸ — 1 300 вопросов».
Даёте ссылку пользователю
Кнопка «Пополнить» в вашем сервисе ведёт на эту ссылку с ?ref= — ID пользователя, чей это баланс.
Пользователь платит
Выбирает пакет и платит по Kaspi QR или в приложении Kaspi.kz. Деньги приходят сразу на ваш Kaspi Pay.
Вы начисляете баланс
Qut Pay отправляет подписанный webhook invoice.paid с metadata.ref и metadata.pack. Ваш сервер добавляет кредиты пользователю.
Ссылка выглядит так: https://qut.kz/p/<ваш-slug>?ref=<userId>.
Qut Pay не держит деньги ваших пользователей и не ведёт их баланс: баланс живёт в вашей системе, мы создаём счёт, следим за оплатой и сообщаем вам.
Без кода и через SDK
Ссылка. Если пакеты одинаковые для всех, достаточно ссылки из кабинета: подставьте ?ref= с ID пользователя — и всё. В ref пишите внутренний ID, а не телефон или e-mail.
SDK. Если вы хотите создавать счёт со своего сервера (своя кнопка, своя страница), в SDK есть готовый метод:
import { QutPay } from '@qutpay/sdk';
const qp = new QutPay({ apiKey: process.env.QUTPAY_API_KEY }); // qp_test_… или qp_live_…
const inv = await qp.createTopUp({ userRef: user.id, amount: 5000, pack: '600 вопросов' });
// → inv.payUrl — страница оплаты с QR, отдайте её пользователю
То же есть в SDK для Python и PHP, в готовых workflow для n8n («Create top-up») и в MCP-сервере (инструмент qutpay_create_topup). Готовый пример веб-приложения: topup-web.zip.
Webhook: начислить ровно один раз
Webhook может прийти повторно — например, если ваш сервер не ответил вовремя. Поэтому начисление привязывается к ID счёта: один счёт — одно начисление.
import express from 'express';
import { verifyWebhook } from '@qutpay/sdk';
const CREDITS = { 1000: 100, 5000: 600, 10000: 1300 }; // ваша таблица: сумма → кредиты
app.post('/qutpay/webhook', express.raw({ type: '*/*' }), async (req, res) => {
if (!verifyWebhook({ secret: process.env.QUTPAY_WEBHOOK_SECRET, rawBody: req.body, headers: req.headers })) return res.sendStatus(401);
const { event, invoice } = JSON.parse(req.body);
const userId = invoice.metadata?.ref;
const credits = CREDITS[invoice.amount];
if (event === 'invoice.paid' && userId && credits) {
// уникальный ключ на invoice_id: повторный webhook ничего не начислит
const r = await db.query('INSERT INTO topups (invoice_id, user_id, credits) VALUES ($1, $2, $3) ON CONFLICT (invoice_id) DO NOTHING', [invoice.id, userId, credits]);
if (r.rowCount === 1) await db.query('UPDATE users SET balance = balance + $1 WHERE id = $2', [credits, userId]);
}
if (event === 'invoice.refunded') {
const r = await db.query("UPDATE topups SET refunded = true WHERE invoice_id = $1 AND NOT refunded RETURNING user_id, credits", [invoice.id]);
if (r.rowCount === 1) await db.query('UPDATE users SET balance = balance - $1 WHERE id = $2', [r.rows[0].credits, r.rows[0].user_id]);
}
res.sendStatus(200);
});
Что здесь важно:
- Подпись. Без
verifyWebhookлюбой мог бы прислать «оплачено». Тело читается сырым (express.raw), иначе подпись не сойдётся. - Кредиты считаете вы. Сумма → кредиты берутся из вашей таблицы,
metadata.packудобно показывать в истории. - Пользователь должен существовать.
refпришёл из адресной строки, проверьте, что такой пользователь у вас есть. Если нет — сохраните платёж и разберитесь вручную. - Возврат. При
invoice.refundedкредиты списываются. Баланс может уйти в минус — решите заранее, блокировать ли такого пользователя. Частичный возврат приходит какinvoice.partially_refunded. - Одна транзакция. Обе записи (
topupsи баланс) лучше делать в одной транзакции базы.
Как назначить цены на пакеты
От 1 000 ₸
С каждого платежа Kaspi удерживает свою комиссию (за Kaspi QR — 0,95 %), а каждый оплаченный пакет — одна оплата из лимита тарифа. На тарифе Старт это примерно 6 ₸ за оплату: для пакета в 200 ₸ это 3 %, для 1 000 ₸ — 0,6 %.
Круглые суммы
1 000, 5 000, 10 000 ₸ — проще выбрать и проще сверять выписку Kaspi Pay. Пользователю легче сравнить пакеты.
Бонус на больших пакетах
100 → 600 → 1 300 вопросов: чем больше пакет, тем дешевле вопрос. Пользователь платит реже, у вас меньше оплат в лимите.
Как посчитать: возьмите свою себестоимость одного запроса к модели, добавьте комиссию Kaspi, долю тарифа и свою маржу. Например, если запрос обходится вам в 3 ₸, то 10 ₸ за вопрос оставляют запас на дорогие запросы и рост цен у провайдера модели. Это пример, а не рекомендация: считайте по своим данным.
Заранее напишите в своей оферте, сгорает ли баланс и как возвращаются деньги за неиспользованные кредиты.
Какой тариф нужен
Каждый оплаченный пакет — это одна оплата Qut Pay, она идёт в месячный лимит тарифа; открытый, но не оплаченный пакет не считается. Платформа не берёт процент с платежей, Kaspi удерживает свою комиссию отдельно.
| Тариф | Цена | Оплат в месяц |
|---|---|---|
| Бесплатный | 0 ₸, бессрочно | 20 |
| Старт | 4 990 ₸/мес | 800 |
| Бизнес | 14 900 ₸/мес | 4 000 |
| Сеть | 39 900 ₸/мес | 15 000 |
Ориентир: если пользователи в среднем пополняют баланс раз в месяц, лимит тарифа — это примерно число платящих пользователей в месяц. 7 дней пробного периода, отсчёт начинается с первого настоящего счёта, потом организация продолжает на тарифе «Бесплатный». Подробнее: тарифы.
Частые вопросы
Qut Pay хранит деньги или баланс моих пользователей?
Нет. Деньги идут из Kaspi сразу на ваш счёт Kaspi Pay. Баланс в кредитах ведёте вы в своей системе, Qut Pay только сообщает об оплате через webhook.
Можно ли так принимать оплату в Telegram-боте?
Для цифровых товаров и услуг внутри Telegram-бота или mini app — нет: Telegram требует оплату в Telegram Stars. Пакеты пополнения рассчитаны на веб-сервисы, сайты, кабинеты SaaS и WhatsApp-ботов.
Что если webhook придёт дважды?
Начисляйте по ID счёта с уникальным ключом в базе, как в примере выше. Повторный webhook ничего не изменит.
Как попробовать без реальных денег?
Возьмите тестовый ключ qp_test_…: счета создаются без Kaspi, оплату вы имитируете запросом POST /invoices/{id}/simulate, а webhook приходит настоящий. Так весь путь проверяется до запуска.
Что если пользователь изменит ref в ссылке?
Тогда баланс пополнится другому пользователю — платит при этом он сам. Используйте внутренние ID, которые трудно угадать, и проверяйте, что пользователь существует.
Сколько стоит?
На бесплатном тарифе — 20 оплат в месяц, бессрочно; платная подписка от 4 990 ₸ в месяц за 800 оплат. В лимит идут только оплаченные пакеты; процент с платежей платформа не берёт. Kaspi удерживает свою комиссию отдельно, как и без любого сервиса.
Подключите пакеты пополнения
Зарегистрируйтесь, создайте ссылку с пакетами и проверьте webhook в тестовом режиме.
Qut Pay — независимый сервис, не является партнёром Kaspi Bank. Нужен бизнес-аккаунт Kaspi Pay (ИП или ТОО). Подробнее: инструкция, тарифы, центр доверия.