Kaspi Pay remote invoices
A remote invoice is a Kaspi Pay banking operation addressed to the buyer’s phone number. It is not an SMS or WhatsApp link: the invoice is created through Kaspi, and the bank sends the notification.
Invoice lifecycle
- 01
Created
The website sends the buyer’s phone number and amount.
- 02
Awaiting bank
The bank processes the operation, and the status may await verification.
- 03
Confirmed / expired / needs reconciliation
If the result is unknown, recheck the operation first and do not create a duplicate.
How to issue an invoice
Prepare the cashier
Connect a Kaspi Pay cashier and make sure its access and subscription are active.
Send the phone number and amount
From your server, send a Merchant API request with the buyer’s phone number and the amount in tenge.
Kaspi sends a notification
If Kaspi confirms creation, the buyer receives the bank invoice and pays it in the app.
Reconcile the status
Get the status through the API or a webhook. If the response is unclear, do not create another invoice automatically.
When this flow fits
- The buyer can conveniently receive the invoice in their own Kaspi Pay app.
- The website can create an invoice with a server request, without its own payment form.
- The result is reconciled on the server and available in the dashboard.
Limitations
- An invoice creates a real banking operation; remote invoices have no test mode.
- Check the phone number and amount before sending. Creating it again may issue a second invoice.
- After a timeout, the result may be unknown. Check the operation first and do not send an automatic retry.