Qut Pay · AI-сервис әзірлеушілеріне
Kaspi арқылы AI-сервисті монетизациялау: баланс толтыру пакеттері
Модельге әр сұраныс сізге ақша тұрады, сондықтан пайдаланушы алдын ала төлегені тиімді: сұрақ, генерация не минут пакетін сатып алып, соны жұмсайды. Пайдаланушы пакет таңдап, Kaspi.kz қосымшасында төлейді, сіздің серверіңіз пайдаланушы ID-і бар webhook алып, балансты толтырады.
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 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);
});
Мұнда маңыздысы:
- Қолтаңба.
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 бизнес-аккаунты (ЖК не ЖШС) керек. Толығырақ: нұсқаулық, тарифтер, сенім орталығы.