Skip to content

How to connect Kaspi Pay payments to your website

Start with a cashier and website resource, configure the API and webhook, then verify a test payment. Use an agent or implement it from the documentation.

Open AI agents

Steps to follow

  1. Register with Bankemes, choose a cashier, and confirm the Kaspi sign-in yourself on the secure page.
  2. Add the website or application as a resource. Select the correct cashier and issue separate limited server credentials for the project.
  3. Add server-side payment creation and signed-webhook handling. An agent with project access can use MCP; a developer can use the Merchant API directly.
  4. Verify a bank-free test flow, then separately approve live credentials and the first real payment. Check the confirmed result in the website.

Choose the flow you need

  • For a one-off order, use a hosted checkout or payment link.
  • For an invoice sent to the buyer’s phone, use a Kaspi remote invoice.
  • For recurring purchases, use a Bankemes schedule or your own subscription logic with a separate invoice per period.

How to know a payment succeeded

An open page, a QR code, or a browser return does not prove payment. Verify the status and amount through the API or a validated webhook; reconcile uncertain outcomes first. API credentials and bank data stay on the server and secure pages.

Your Kaspi password, SMS codes and bank session stay with you. Credentials use protected configuration; access to your project code is granted separately.

For developers and AI agents

The English Markdown reference contains tool schemas, parameters, request examples and access restrictions.

Technical reference in English