English Français العربية

Qut Pay (Kaspi QR payments)

Official registry Finance and payments

Kaspi QR payments (Kazakhstan) via Qut Pay: create invoices, check status, refund, sandbox tests.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http qut-pay-kaspi-qr-payments 'https://api.qut.kz/mcp' --header 'Authorization: <Bearer <Qut Pay API key: qp_test_… sandbox or qp_live_…>>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "qut-pay-kaspi-qr-payments": {
            "type": "http",
            "url": "https://api.qut.kz/mcp",
            "headers": {
                "Authorization": "<Bearer <Qut Pay API key: qp_test_… sandbox or qp_live_…>>"
            }
        }
    }
}
NPM package @qutpay/mcp
Claude Code 
claude mcp add qut-pay-kaspi-qr-payments -e 'QUTPAY_API_KEY=<your qutpay_api_key>' -e 'QUTPAY_BASE_URL=https://api.qut.kz' -- npx -y @qutpay/mcp@0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "qut-pay-kaspi-qr-payments": {
            "command": "npx",
            "args": [
                "-y",
                "@qutpay/mcp@0.1.2"
            ],
            "env": {
                "QUTPAY_API_KEY": "<your qutpay_api_key>",
                "QUTPAY_BASE_URL": "https://api.qut.kz"
            }
        }
    }
}

Environment variables

  • QUTPAY_API_KEY required secret Qut Pay API key (qp_test_… sandbox or qp_live_…), from the cabinet → Integrations → API keys
  • QUTPAY_BASE_URL API base URL, default https://api.qut.kz

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Qut Pay — Kaspi Pay payments API for Kazakhstan (docs & examples)
  2. Quick start
  3. For AI agents
  4. Contents
  5. Sandbox
  6. Pricing
  7. Trust & reliability
  8. About
  9. Languages
  10. Contributing

Qut Pay — Kaspi Pay payments API for Kazakhstan (docs & examples)

Qut Pay lets a business in Kazakhstan accept Kaspi payments on a website, in a mobile app, in Telegram or by a plain link — through the standard "Cashier" role of its own Kaspi Pay account. Invoices are created by REST API, the customer pays in the Kaspi.kz app (QR, link, or an invoice pushed to their phone number), and your server gets a signed webhook. Money settles directly in your Kaspi Pay account.

This repository holds the public documentation: the OpenAPI spec, the integration guide, and copy-paste examples. Service and cabinet: https://qut.kz · API: https://api.qut.kz

Quick start

curl -X POST https://api.qut.kz/api/v1/invoices \
  -H "X-API-Key: qp_test_…" -H "Content-Type: application/json" \
  -d '{"amount": 2500, "externalOrderId": "A-1041", "description": "Order A-1041"}'
# → { "id": "inv_…", "status": "pending", "payUrl": "https://qut.kz/pay/…", "qr": "…" }

When the customer pays, POST to your webhook URL with header X-Qutpay-Signature: sha256=<HMAC of raw body>; verify with your webhook secret, then mark the order paid. Full flow, retries and idempotency: docs/integration.md.

For AI agents

  • Agent skill (skills/qutpay/): copy into .claude/skills/qutpay/ (Claude Code) or upload as a zip to Claude.ai — the agent then follows the Qut Pay integration procedure on its own. Also served at https://api.qut.kz/SKILL.md
  • MCP server (examples/mcp, npm @qutpay/mcp): claude mcp add qutpay -e QUTPAY_API_KEY=qp_test_… -- npx -y @qutpay/mcp — tools to create invoices, check status, refund and simulate payments in sandbox. Guide: https://api.qut.kz/docs/guide/en/mcp

Contents

  • openapi.json — the API contract (also served live at https://api.qut.kz/openapi.json)
  • docs/integration.md — step by step, with the webhook signature check in Node.js, PHP and Python
  • docs/connect.ru.md / docs/connect.kk.md — how to prepare a Kaspi Pay cashier number (the one step people get wrong)
  • examples/ — minimal servers in Node.js, PHP, Python; WordPress/WooCommerce and OpenCart modules; n8n workflows
  • llms.txt — the same guide formatted for AI coding agents

Sandbox

Keys starting with qp_test_ create invoices that never reach Kaspi and never move money; everything else (webhooks, refunds, receipts) behaves as in live mode. Switch to qp_live_ when the integration is done.

Pricing

Flat monthly subscription: Старт 4 990 ₸ for 800 invoices a month, Бизнес 14 900 ₸ for 4 000, Про 39 900 ₸ for 15 000, Партнёр 79 900 ₸ for 30 000 plus the Partner API (enabled by the platform on request). 7-day trial that starts with your first live invoice. The platform charges no percentage on payments; Kaspi's own fee for QR acquiring applies as it would without any service. Details: https://qut.kz/tarify/ (kk: https://qut.kz/kk/tarifter/)

Trust & reliability

About

Qut Pay is an independent service and is not affiliated with JSC "Kaspi Bank". Kaspi and Kaspi Pay are trademarks of their owner. Access is limited to what the Cashier role allows (issue an invoice, see its status, refund your own invoice) and can be revoked from the cabinet at any time.

Questions: kazprose@gmail.com · WhatsApp +7 778 881 3333 · Telegram @qutpaybot

Languages

  • English: this README and docs/integration.md (written for people and for AI coding agents alike)
  • Русский: docs/connect.ru.md, docs/integration.ru.md, docs/tariffs.ru.md, docs/partner.ru.md, docs/trust.ru.md; tariffs at https://qut.kz/tarify/
  • English: docs/integration.en.md, docs/connect.en.md, docs/tariffs-guide.en.md, docs/partner.en.md, docs/trust.en.md
  • Қазақша: docs/connect.kk.md, docs/integration.kk.md, тарифтер: https://qut.kz/tarifter/
  • Knowledge base, 126 articles in both languages: https://api.qut.kz/kb · https://api.qut.kz/kb/ru

Contributing

Found a mistake in the docs or an example that does not run? Open an issue or a pull request here. Questions about your own integration are faster through the cabinet's Support section.

Frequently asked questions

What is Qut Pay (Kaspi QR payments)?

Kaspi QR payments (Kazakhstan) via Qut Pay: create invoices, check status, refund, sandbox tests.

How do I install Qut Pay (Kaspi QR payments)?

It runs as a remote server. In Claude Code: claude mcp add --transport http qut-pay-kaspi-qr-payments 'https://api.qut.kz/mcp' --header 'Authorization: <Bearer <Qut Pay API key: qp_test_… sandbox or qp_live_…>>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Qut Pay (Kaspi QR payments) need an API key?

Yes. It expects QUTPAY_API_KEY, Authorization, which you set in its configuration.

Is Qut Pay (Kaspi QR payments) open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Qut Pay (Kaspi QR payments)?

It is published by kazprose. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.