Skip to content

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

  1. 01

    Created

    The website sends the buyer’s phone number and amount.

  2. 02

    Awaiting bank

    The bank processes the operation, and the status may await verification.

  3. 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

  1. Prepare the cashier

    Connect a Kaspi Pay cashier and make sure its access and subscription are active.

  2. 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.

  3. Kaspi sends a notification

    If Kaspi confirms creation, the buyer receives the bank invoice and pays it in the app.

  4. 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.
Open the API methods