How to Add a Kaspi Pay Cashier for Online Payments

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.

The short answer

In Kaspi Pay, a cashier is added like this:

  1. Open the Kaspi Pay app.
  2. Go to Services -> Company profile -> Employees (in the Russian app: Сервисы -> Профиль компании -> Сотрудники).
  3. Tap Add.
  4. Choose the Cashier role.
  5. Choose a point of sale.
  6. Enter the cashier’s phone number and name.
  7. Confirm.

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.

Why xpayment needs a separate cashier

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.

What to prepare in advance

Before adding a cashier, check three things.

An active Kaspi Pay account

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.

A point of sale

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.

A separate phone number

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:

Step by step

Step 1. Open employees

In the Kaspi Pay app, open:

Services -> Company profile -> Employees

This path matches Kaspi’s official instructions for adding a cashier.

Step 2. Tap Add

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

Step 3. Choose a point of sale

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.

Step 4. Enter the phone number and name

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?

Step 5. Check the limits

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?

What to do after adding the cashier

When the cashier is created and can sign in to Kaspi Pay, move to xpayment:

  1. Open xpayment.kz and sign in to the dashboard.
  2. Open Кассы и счета (Cash registers and accounts) and select Подключить кассу (Connect a cash register).
  3. Tick the three items on the first wizard step and select “Продолжить” (Continue).
  4. Enter the register name, the “Имя для API” (API name, for example Kassa1), and the cashier’s number.
  5. Enter the code from the SMS.
  6. In API-ключи (API keys), create an API v2 key 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.

Common mistakes

Connecting the owner’s main number

Do not do this: the main account has too many rights. Besides, the xpayment wizard will not accept the owner’s Kaspi Pay number.

Using a number you cannot always reach

The cashier’s number may be needed to reconnect the register. Use a number your business controls.

Creating the cashier at the wrong point of sale

If payments must go through a specific point, check the attachment before connecting to xpayment.

Next step

When the cashier is ready, connect them as a cash register in xpayment and get an API key for your application.

Useful links: