Step-by-step guide: create a restricted Kaspi Pay cashier, prepare a separate phone number, and connect it safely to xpayment.
To connect Kaspi Pay online payments to a website, Telegram bot, CRM, mobile app, or n8n workflow through xpayment.kz, first create a separate cashier in Kaspi Pay. This is not a formality but the basic security layer: xpayment works not with the business owner’s main account but with the restricted cashier role.
A cashier can accept payments and see their own operation history. They do not manage company accounts, do not transfer money, and do not see other employees’ operations. That is why a cashier is the role you use to connect a cash register to xpayment and work through the API.
In Kaspi Pay, a cashier is added like this:
Services -> Company profile -> Employees (in the Russian app: Сервисы -> Профиль компании -> Сотрудники).Add.Cashier role.Kaspi’s official instructions describe this path in the article How to add a cashier.
When the cashier is created, connect them in xpayment: Кассы и счета (Cash registers and accounts) → Подключить кассу (Connect a cash register). After that you get an API v2 key and can accept payments.
xpayment connects your product to the payment system through a cash register tied to a Kaspi Pay cashier. Kaspi Pay is the supported provider today; the platform gives developers one clear API for payments, webhooks, and statuses, and gives owners without a developer ready-made tools in the dashboard.
You should not connect the business owner’s main account to any integration. The owner sees accounts, balance, employees, transfers, and company settings, and none of that is needed to accept payments.
We understand that handing over access raises concerns, so the model is built to keep access minimal:
| Level | What it does |
|---|---|
| Kaspi Pay owner | Manages the company and accounts |
| Kaspi Pay cashier | Accepts payments at one point of sale and sees only their own operations |
| xpayment | Connects the cashier as a cash register and provides API access |
| Your product | Creates payments with the xapi_… key and receives a webhook with the result |
The cashier role cannot transfer money, access the whole business account, or see other cashiers’ operations. If you connect an online store, CRM, or bot, it does not need access to the company balance: it needs to create a payment and find out whether the customer paid.
Before adding a cashier, check three things.
If the business (ИП or ТОО) already has Kaspi Pay, you can add an employee right away. If there is no account yet, first register the business in the Kaspi Pay app.
The cashier must be attached to a point of sale. If you do not have one, create it in the company profile in Kaspi Pay.
The cashier needs a number used to sign in to Kaspi Pay. It can be an employee’s number, a separate SIM card, or a number set aside for online payments.
Important:
In the Kaspi Pay app, open:
Services -> Company profile -> Employees
This path matches Kaspi’s official instructions for adding a cashier.
AddKaspi Pay offers a choice of employee role. For xpayment you need the Cashier role. Do not choose an administrator or owner role: a cashier is enough for online payments through the API.
A cashier works within one specific point of sale. This matters for accounting and notifications.
According to Kaspi’s help, one cashier accepts payments at only one point of sale: Can one cashier be added to several points of sale? If you have several points, create a separate cashier for each.
Enter the cashier’s phone number and the employee’s name. An SMS will be sent to that number after you add them.
Kaspi describes starting a cashier separately: the employee receives an SMS with a link to the Kaspi Pay app, installs it, enters the phone number, and confirms the sign-in with an SMS code. Source: How does a cashier start accepting payments?
| Question | Answer |
|---|---|
| Can one cashier be added to several points? | No, one cashier works at one point of sale. |
| Can many cashiers be added to one point? | Yes, Kaspi states that the number of cashiers per point is not limited. |
Source: How many cashiers can be added to one point of sale?
When the cashier is created and can sign in to Kaspi Pay, move to xpayment:
Kassa1), and the cashier’s number.xapi_….After that your backend, website, bot, CRM, or n8n workflow can call API v2 and create payments. A detailed walkthrough: Connecting a cash register and getting an API v2 key.
Do not do this: the main account has too many rights. Besides, the xpayment wizard will not accept the owner’s Kaspi Pay number.
The cashier’s number may be needed to reconnect the register. Use a number your business controls.
If payments must go through a specific point, check the attachment before connecting to xpayment.
When the cashier is ready, connect them as a cash register in xpayment and get an API key for your application.
Useful links: