← qut.kz

Qut Pay · Для разработчиков AI-сервисов

Монетизация AI-сервиса через Kaspi: пакеты пополнения баланса

Каждый запрос к модели стоит вам денег, поэтому выгоднее, когда пользователь платит заранее: покупает пакет вопросов, генераций или минут и тратит его. Пользователь выбирает пакет, платит в приложении Kaspi.kz, ваш сервер получает webhook с ID пользователя и начисляет баланс.

Открыть кабинет Инструкция для разработчика

2–6 пакетов

на одной ссылке оплаты

  • Деньги сразу на ваш счёт Kaspi Pay
  • Каждый оплаченный пакет — одна оплата из лимита тарифа
  • Kaspi удерживает свою комиссию отдельно
  • Сначала всё проверяется в тестовом режиме

Кому подходит

Для всего этого нужен бизнес-аккаунт Kaspi Pay (ИП или ТОО) и сервер, который принимает webhook.

Важно про Telegram-ботов

Как это работает

Создаёте ссылку с пакетами

В кабинете 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);
});

Что здесь важно:

Как назначить цены на пакеты

От 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 (ИП или ТОО). Подробнее: инструкция, тарифы, центр доверия.

Обновлено: 2026-11-18