Qut Pay · For Salebot bots
Your Salebot bot sends Kaspi invoices by itself
The customer places an order in the bot and an invoice lands in their Kaspi.kz app. They pay, write "Paid", and the bot checks and carries on with the order. Set up with one "API-запрос" (API request) block, no programmer needed.
0 ₸
on top of your Qut Pay plan
- Only paid invoices count toward the monthly limit
- Kaspi charges its own fee separately
- Try it in sandbox first
How it works
The customer orders
The bot already has the amount and phone number, as usual in your Salebot flow.
The bot sends an invoice
The "API-запрос" block sends one request to Qut Pay. The invoice lands in the customer's Kaspi.kz app, no link.
The customer pays
Then writes "Paid" or taps a "Check" button.
The bot checks
A second request returns the invoice state: on paid the bot says thanks and carries on.
What you get
An invoice without a link
kind: "phone" sends the invoice straight into the customer's Kaspi app. No links on WhatsApp.
No double invoices
idempotencyKey with the order number: a double tap returns the same invoice.
Not in Kaspi
If the number has no Kaspi account, the API says so; add a branch where the bot asks for the Kaspi number and resends.
Notices for you
Every payment pings the Telegram connected in the Qut Pay cabinet. All invoices with order numbers are in the cabinet.
A link for Telegram
On Telegram or VK you can send a link: a page with a QR code and a "Pay in Kaspi" button.
Sandbox
With a sandbox key nobody is charged. Test the whole flow before going live.
The block itself
"API-запрос" section, type POST-json, URL https://api.qut.kz/api/v1/invoices.
Request header:
{"X-API-Key": "qp_live_…", "Content-Type": "application/json"}
JSON parameters:
{
"kind": "phone",
"amount": #{amount},
"description": "Order #{order_id}",
"idempotencyKey": "salebot-#{order_id}",
"customer": { "phone": "#{phone}" }
}
Values saved from the response: id->qp_invoice_id; status->qp_status; error->qp_error. Checking the payment: GET https://api.qut.kz/api/v1/invoices/#{qp_invoice_id} with the same header. Every step, response and error is in the guide.
Good to know
- Qut Pay and Salebot are separate services; we are not partners. The bot reaches Qut Pay through a standard Salebot block.
- Salebot's API functions work only on its «Бизнес» and «Инфобиз» plans.
- You need a Kaspi Pay cashier connected to Qut Pay, i.e. a Kaspi Pay business account (sole proprietor or LLP).
- Salebot does not receive Qut Pay webhooks directly: the bot checks the payment when the customer writes or taps a button.
How to connect
Sign up
At qut.kz/app and connect a Kaspi Pay cashier.
Create a key
Cabinet → Integrations → API keys. A sandbox key first (qp_test_…).
Add the blocks
In Salebot: "API-запрос" in the order-confirmation block, plus a payment-check block.
Test and go live
Test order → "[Sandbox] paid" in the cabinet → the bot writes "✅". Then switch to the qp_live_… key.
Frequently asked questions
How much does it cost?
Nothing extra: the integration is included in every Qut Pay plan. Only paid invoices count toward the plan's monthly limit. Kaspi charges its own fee separately, and the Salebot plan is paid to Salebot. Details: pricing.
Do I need a programmer?
No. If you can build blocks in Salebot, paste the URL, header and JSON from the guide and use your own variables.
How does the bot know the customer paid?
With the check block: a GET on the invoice returns qp_status; paid means paid. Run it when the customer writes "Paid" or taps a button. You get a Telegram notice the moment the payment lands.
The customer's number is stored as "+7 701 123 45 67" — is that fine?
Yes. Qut Pay accepts +7 701 123 45 67, 87011234567 and 77011234567.
Does it work on Telegram and Instagram?
Yes, on any Salebot channel. On WhatsApp an invoice to the phone without a link works best; on Telegram you can send a link to the payment page with the QR.
What if I do not use Salebot?
The same request works in any builder that can send an HTTP request with a JSON body and a header, for example Make, n8n or Albato. API reference: website integration.
Add Kaspi payments to your bot
Sign up, create a sandbox key and test the flow in 15 minutes.
Qut Pay is an independent service, not a partner of Kaspi Bank or Salebot. You need a Kaspi Pay business account (sole proprietor or LLP). More: guide, pricing, trust center.