← qut.kz

Qut Pay · AI-сервис әзірлеушілеріне

Kaspi арқылы AI-сервисті монетизациялау: баланс толтыру пакеттері

Модельге әр сұраныс сізге ақша тұрады, сондықтан пайдаланушы алдын ала төлегені тиімді: сұрақ, генерация не минут пакетін сатып алып, соны жұмсайды. Пайдаланушы пакет таңдап, Kaspi.kz қосымшасында төлейді, сіздің серверіңіз пайдаланушы ID-і бар webhook алып, балансты толтырады.

Кабинетті ашу Әзірлеушіге нұсқаулық

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 metadata.ref пен metadata.pack бар қолтаңбалы invoice.paid webhook жібереді. Сіздің серверіңіз пайдаланушыға кредит қосады.

Сілтеме мынадай болады: https://qut.kz/p/<сіздің-slug>?ref=<userId>.

Qut Pay пайдаланушыларыңыздың ақшасын ұстамайды және балансын жүргізбейді: баланс сіздің жүйеңізде тұрады, біз счёт жасаймыз, төлемді бақылаймыз және сізге хабарлаймыз.

Кодсыз және SDK арқылы

Сілтеме. Пакеттер барлығына бірдей болса, кабинеттегі сілтеме жеткілікті: соңына пайдаланушы ID-і бар ?ref= қосасыз, болды. ref ішіне телефон не e-mail емес, ішкі ID жазыңыз.

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 бар төлем беті, оны пайдаланушыға бересіз

Дәл осындай әдіс Python мен PHP SDK-де, n8n-ге арналған дайын workflow-та («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