English Français العربية

Qut Pay (Kaspi QR payments)

Registre officiel Finance et paiements

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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_…>>'
Configuration JSON (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
Configuration JSON (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"
            }
        }
    }
}

Variables d'environnement

  • QUTPAY_API_KEY obligatoire 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

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

Questions fréquentes

Qu'est-ce que Qut Pay (Kaspi QR payments) ?

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

Comment installer Qut Pay (Kaspi QR payments) ?

Il fonctionne comme serveur distant. Dans 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_…>>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Qut Pay (Kaspi QR payments) ?

Oui. Il attend QUTPAY_API_KEY, Authorization, à renseigner dans sa configuration.

Qut Pay (Kaspi QR payments) est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Qut Pay (Kaspi QR payments) ?

Il est publié par kazprose. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.