Pick your agent: Claude Code, Codex, Claude or ChatGPT. It takes you from the sandbox to your first real payment: it prepares the account and keys, writes the integration code and checks payments, webhooks and refunds.
The plugin's skills work in Claude (claude.ai, the app, Cowork), Claude Code and Codex. ChatGPT in a browser gets only the xPayment tools, no skills.
Pick your agent and say whether you have a Kaspi Pay cashier. The page shows your path and a ready message for your assistant.
Connect payments through xPayment. I don't have a Kaspi Pay cashier yet, so start in the sandbox: a test key, the test cashbox, a test webhook. Write the integration in my project and run payments, every outcome, webhooks and refunds. Keep keys in .env and never print them in your reply.Help me accept Kaspi Pay payments through xPayment. Use the xPayment tools and start with whoami. I don't have a Kaspi Pay cashier yet, so work only in the sandbox (environment: sandbox): issue a test key xapi_test_…, create a test webhook subscription, create a test payment, set the outcomes paid, declined, expired and failed with simulate_test_payment, and check refunds. Show the result as a table. Do nothing on live. Ask one question at a time.Connect Kaspi Pay through the xPayment API v2 in my project. The documentation in one file: https://xpayment.kz/llms-full.txt, the API description: https://xpayment.kz/openapi/xpayment-api-v2.json. I don't have a Kaspi Pay cashier yet, so we work in the sandbox: I will take the test key xapi_test_… and the cashbox test in the cabinet (Sandbox → Keys) and put the key into .env myself, so don't ask me to paste it into the chat. Write the client and the webhook handler (signature check, idempotency) and check payments, every outcome and refunds with POST /v2/sandbox/payments/PAYMENT_ID/simulate.xapi_test_…, the cashbox test and a test webhook subscription: no plan, no Kaspi.paid, declined, expired, failed, and refunds.Connect payments through xPayment. I already have a Kaspi Pay cashier. First run the full cycle in the sandbox, then take me to live: the cashbox, the webhook and the key. Live keys and secrets only through one-time links, live actions only after my yes.Help me accept Kaspi Pay payments through xPayment. Use the xPayment tools and start with whoami. I already have a Kaspi Pay cashier. First run the full cycle in the sandbox (environment: sandbox), then help me connect the cashbox and set up the live webhook and key. Hand over live keys and secrets only through a one-time link and never show them in the chat. Deleting, revoking and refunding a real payment only after my explicit yes. Never create live payments. Ask one question at a time.Connect Kaspi Pay through the xPayment API v2 in my project. The documentation in one file: https://xpayment.kz/llms-full.txt, the API description: https://xpayment.kz/openapi/xpayment-api-v2.json. My Kaspi Pay cashbox is already connected in the xPayment cabinet. First check everything in the sandbox with a test key xapi_test_…, then prepare the switch to live: the key, device_name and the webhook secret. I will put the keys into .env myself, so don't ask me to paste them into the chat. Write the client and the webhook handler (signature check, idempotency).test becomes your cashbox.Without a Kaspi cashier you start right away, in the sandbox. With one you run the same sandbox and then go live. The badges show who does what.
Free and open right after sign-up. No Kaspi cashier, plan or money needed; the addresses, requests and answers are the same as on live.
xapi_test_… and a test webhook subscription. In your project it writes the values to .env without printing them.X-Idempotency-Key, a signature check on the raw body, a repeated delivery_id is not processed twice, the payment is fetched after each event.paid, declined, expired, failed.13.13 is always declined; the phones …7000000001 and …7000000002 give Kaspi errors.Without a public address, webhooks cannot reach a server on your computer: the assistant suggests a tunnel (recommended) or locally signed checks.
The sandbox has no static QR, online booking, recurring payments or subscriptions. The limit is 60 test writes a minute and 1000 a day. Test payments are kept for 30 days.
First the same cycle in the sandbox, then the live cashbox, webhook and key. What only you can do is marked.
xapi_test_… → xapi_…), device_name (test → your cashbox's name) and the webhook secret. The rest of the code stays.No website or developer? Instead of code the assistant creates a payment page in the cabinet. Publishing only after your yes.
This is the cycle your assistant runs: a payment, an outcome, a webhook, a refund.
paid → COMPLETED, payment.completeddeclined → CANCELLED, payment.cancelledexpired → EXPIRED, payment.expiredfailed → FAILED, payment.failedThe webhook body has no amount and no status: after the event your code fetches GET /v2/payments/PAYMENT_ID and relies on the payment's status.
Four columns: what the assistant does by itself, what only after your yes, what only you can do and what it never does.
Without extra questions, within the rights you granted.
The assistant names the action exactly and waits for a yes to that action.
The assistant cannot do these.
The plugin's rules forbid these.
.envOn the consent page you see what the assistant asks for and allow or deny it. A tool without the right it needs answers SCOPE_REQUIRED: connect again and allow that right.
account:read: See the account: cashboxes, keys (without values), webhooks, payments and refundsdevices:write: Add, rename and remove cashboxeskeys:write: Issue and revoke API keyswebhooks:write: Create, change and delete webhook subscriptionslinks:write: Create, publish and archive payment pagessandbox:write: Create and «pay» test paymentsrefunds:write: Refund real paymentsThe journal of the assistant's actions and revoking access: «Настройки» → «Подключённые AI» (Settings → Connected AI).
Everything runs in the sandbox first, with test keys: no money, no Kaspi. The AI cannot create a real payment.
.env. If you paste a key into the chat anyway, the AI tells you to replace it.Your data goes to the AI service you chose. What the AI reads from your account, including payers' phone numbers and email addresses, is sent to that service (Claude, ChatGPT or Codex).
Choose where you work with AI. A quick version for your agent is above, in «Get started».
The plugin is installed from a marketplace. These steps were checked on claude.ai in a browser; the desktop app and Cowork follow the same path, but we did not run them separately.
Open Customize → Plugins → + Add, choose «Добавить маркетплейс» (Add a marketplace), then «Добавить из репозитория» (Add from a repository).
In the search box type the repository address and press «Синхронизация» (Sync).
xpayment-kz/xpayment-aiA card «xPayment» (author xpayment-ai) appears. Press «Добавить» (Add). If a warning dialog appears, read it and press «Продолжить» (Continue).
On the plugin page the list «Коннекторы · 2» (Connectors, 2) holds two connectors; connect both. For each: «Подключить» (Connect) → «Добавить пользовательский коннектор» (Add a custom connector) → «Продолжить», then «Добавить» and «Подключить» again. xpayment-docs is the documentation and needs no sign-in.
For xpayment your browser opens xpayment.kz/login: sign in with «Войти через xPayment» and press «Разрешить» (Allow) on the consent page. The connector then shows as connected.
The first time, Claude asks for permission for each tool: «Разрешить один раз» (Allow once). The plugin holds no scripts and no hooks; the note «Может отправлять данные в другие сервисы» (It can send data to other services) is about the two MCP servers.
How to call it. Press «Попробовать в чате» (Try in chat) on the plugin page: a chat opens with /integrate already typed. A skill also starts by itself when your request matches it.
How to update. Customize → Plugins → + Add → Manage marketplaces → xpayment-ai → ⋯ → Check for updates.
Needs Claude Code 2.1.319 or later.
Install the plugin in a terminal (it is installed for your user):
claude plugin marketplace add xpayment-kz/xpayment-aiclaude plugin install xpayment@xpaymentThe same inside a session: /plugin marketplace add xpayment-kz/xpayment-ai, then /plugin install xpayment@xpayment. Start a new session afterwards.
Check that everything is there: the plugin xpayment with four skills (xpayment:ask, xpayment:check, xpayment:integrate, xpayment:migrate-v2). The server xpayment-docs is connected, the server xpayment waits for the sign-in.
Sign in to your account: in a session run /mcp, pick plugin:xpayment:xpayment and choose Authenticate. It needs an interactive terminal. Your browser opens «Войти через xPayment».
This step comes from the plugin's own instructions; our check did not run the account sign-in from Claude Code.
The same with one command in a terminal:
claude mcp login plugin:xpayment:xpaymentHow to call it. Type /xpayment:ask, /xpayment:integrate, /xpayment:migrate-v2 or /xpayment:check, or just describe the task.
How to update. Run the two commands, then /reload-plugins or start a new session.
claude plugin marketplace update xpaymentclaude plugin update xpayment@xpayment
ChatGPT in a browser gets the xPayment tools but no skills: there is no ask or integrate to call, so describe the task in plain words.
On chatgpt.com open Plugins → «Добавить» (Add) → «Добавить пользовательский сервер MCP» (Add custom MCP server).
«Название» (Name): xPayment. «Описание» (Description): your own words.
«Подключение» (Connection) → «URL-адрес сервера» (Server URL): enter the address.
https://api.xpayment.kz/mcp«Аутентификация» (Authentication): OAuth. Under «Расширенные настройки OAuth» (Advanced OAuth settings) ChatGPT finds the client details itself, so there is nothing to type.
Tick «Я понимаю и хочу продолжить» (I understand and want to continue) and press «Создать в виде плагина» (Create as a plugin). This is your own decision.
Sign in with «Войти через xPayment» and press «Разрешить» (Allow).
How to call it. In a chat type @xPayment and your request, or press «Попробовать в чате» (Try in chat).
How to update. Nothing to do: the server is remote, so changes reach you without a new install.
For the ChatGPT desktop app, see the README of the plugin repository. The plugin on GitHub
Checked with Codex CLI 0.167.0.
Install the plugin:
codex plugin marketplace add xpayment-kz/xpayment-aicodex plugin add xpayment@xpaymentSign in to your account:
codex mcp login xpaymentCodex identifies itself to xPayment, so there is nothing to fill in. Your browser opens «Войти через xPayment»: approve, and Codex reports that you are logged in.
If your default browser is signed in to xPayment with another account, open the link Codex prints in the browser where you use the right account.
Check: codex mcp list shows xpayment and xpayment-docs (until you sign in, xpayment says «Not logged in»), and the skills are listed as xpayment:ask, xpayment:check, xpayment:integrate, xpayment:migrate-v2.
How to call it. Name a skill or describe the task.
How to update. Run the command, then start a new session.
codex plugin marketplace upgrade xpayment
We checked only Claude, Claude Code, Codex and ChatGPT. These options were not checked: the button names in your client may differ.
The «documentation» MCP server needs no sign-in if your client supports MCP over HTTP. The address:
https://api.xpayment.kz/mcp/docsThe «account» MCP server signs in to your account by OAuth («Войти через xPayment») if your client supports OAuth for MCP. The address:
https://api.xpayment.kz/mcpWithout MCP: take a test key xapi_test_… in the cabinet (Sandbox → Keys) and save it to .env yourself. Live keys are also issued in the cabinet.
Give the agent the documentation in one file: it holds every endpoint of API v1 and v2.
https://xpayment.kz/llms-full.txtHow to call it. Describe the task in your own words, or use the ready message from «Get started».
How to update. Nothing to update: the servers are remote.
Steps checked on 10 November 2026: Claude Code 2.1.319, Codex CLI 0.167.0, claude.ai and chatgpt.com in a browser (Russian interface). Where a button has no English name here, it is quoted in Russian as it appears, with the English meaning after it. Claude and ChatGPT change their screens from time to time, so a label may differ from what you see.
You can connect only the xPayment MCP servers, without the plugin. You get the tools and the documentation, but not the skills: the step-by-step instructions of ask, integrate, migrate-v2 and check are not loaded.
In Claude: Customize → Connectors → + Add → «Добавить пользовательский коннектор» (Add a custom connector). Add two connectors.
Documentation. No sign-in.
https://api.xpayment.kz/mcp/docs
Account. OAuth: sign in with «Войти через xPayment» and press «Разрешить» (Allow).
https://api.xpayment.kz/mcp
We checked only the menu path of this variant.
MCP gives an assistant tools. The plugin connects both xPayment servers and adds skills: ready-made instructions.
Five tools: the API passport, the list of sections, a section, search and the description of an endpoint. The assistant answers from the current documentation. https://api.xpayment.kz/mcp/docs
The tools of your account: cashboxes, keys, webhooks, payment pages, test payments and refunds. Only within your rights and the rights granted to the assistant. https://api.xpayment.kz/mcp
Skills are ready-made instructions for your AI. The plugin has no scripts and no hooks.
ask: Answers questions about xPayment from the live documentation and, if you are signed in, from your account. Changes nothing.integrate: From sign-in to the first live payment: the scenario, the account and the cashbox, a full cycle in the sandbox, the code or a payment page, the webhook and the switch to live.migrate-v2: Moves an integration from API v1 to API v2 (beta) behind a flag, without downtime, and revokes the v1 keys last.check: Reviews an integration (code and account) against the current documentation and reports problems by severity, with fixes.Yes. The sandbox is free and open right after sign-up: the test cashbox test, test keys xapi_test_…, no plan, no Kaspi and no money. The whole path, from a payment to a webhook and a refund, runs in it. Real payments start once you connect a cashbox.
The assistant issues a test key itself and writes it to your project's .env without printing it. It does not see live keys or webhook secrets: it gives you a one-time link valid for an hour, and you save the value yourself. If a key still ends up in the chat, the assistant tells you to replace it.
No. The assistant neither creates nor cancels live payments: you make the first real payment. It refunds a real payment only after your yes to that action.
ChatGPT in a browser connects the xPayment MCP server: there are tools but no skills, so describe the task in words or send the ready message from «Get started». chatgpt.com accepted the plugin archive, but we did not test it in the ChatGPT desktop app.
In the cabinet: «Настройки» → «Подключённые AI» (Settings → Connected AI). It holds the journal of actions and the button that revokes access.
For a new integration we recommend API v2: it is in beta now and may change. API v1 is stable and fully supported.
Yes, but we did not check these options. Give the agent the llms-full.txt documentation file and the API v2 description, and take a test key in the cabinet (Sandbox → Keys). If your client supports MCP, you can connect both servers.
The sandbox is free and open right after sign-up. Choose your agent above and send it the ready message.