Back to Browse

Aitole Examples MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Accept Kaspi Pay in Kazakhstan: QR codes, phone invoices, payment status, refunds. Sandbox first.

About

Accept Kaspi Pay in Kazakhstan: QR codes, phone invoices, payment status, refunds. Sandbox first.

Remote endpoints: streamable-http: https://api.aitole.kz/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 0 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Applies to the server that hosts this plugin, not to your machine.

file_system

Applies to the server that hosts this plugin, not to your machine.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "kz-aitole-aitole": {
      "url": "https://api.aitole.kz/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Примеры интеграции Aitole: приём оплаты Kaspi Pay по API

Готовый код, чтобы выставлять QR и счета Kaspi из своего сайта, CRM или бота и узнавать об оплате вебхуком. Node.js, Python, PHP и curl, без зависимостей: копируйте файл в проект.

Aitole — REST API поверх вашей кассы Kaspi Pay: QR, счёт на номер клиента, постоянные ссылки на оплату, регулярные счета, возвраты и вебхуки с подписью. Деньги идут напрямую на ваш Kaspi Pay. Aitole — независимый сервис, не банк и не партнёр АО «Kaspi Bank».

За минуту в песочнице

  1. Зарегистрируйтесь на aitole.kz (вход через Google) и возьмите в кабинете тестовый ключ sk_test_…. Kaspi подключать не нужно.
  2. Запустите весь путь оплаты: создать QR, «клиент оплатил», дождаться статуса paid.
git clone https://github.com/aitole-kz/aitole-examples && cd aitole-examples
AITOLE_API_KEY=sk_test_… node node/quickstart.mjs
1. Создан QR: 9a36bf1b-05ba-…, статус pending, ссылка для покупателя: mock_qr_b548778f-…
2. Песочница: покупатель оплатил
3. Статус: paid, оплачено 2026-11-14T18:55:45.495Z, заказ demo-1794682545129

Песочница не трогает настоящий Kaspi и деньги, а статус двигает тот же поллер, что и в бою. Тестовым ключом списать настоящие деньги нельзя: sk_test_ работает только с песочницей.

Что внутри

ЗадачаNode.jsPythonPHPcurl
Весь путь в песочницеquickstart.mjsquickstart.pyquickstart.sh
Счёт на номер клиентаcreate-invoice.mjscreate-invoice.php
Приём вебхука с проверкой подписиwebhook-server.mjswebhook_server.pywebhook.php
Только проверка подписиverify.mjsaitole.pyverify.php

Проверка подписи во всех трёх языках сверяется с одним тестовым вектором test/vector.json в CI.

Как узнать об оплате

Ответ на создание счёта — это статус pending, а не оплата. Об оплате сообщает вебхук payment.paid через несколько секунд после того, как клиент заплатил:

POST https://ваш-сайт/webhooks/aitole
X-Webhook-Timestamp: 1794650000
X-Webhook-Signature: sha256=<hex>

{"id":"evt_…","type":"payment.paid","created_at":"…","data":{"id":"<id операции>","status":"paid","amount":4990}}
  • Подпись — HMAC-SHA256 от строки "{timestamp}.{сырое тело}" секретом эндпоинта. Проверяйте по сырому телу до разбора JSON и отвергайте запросы старше 300 секунд.
  • data.id — тот же id, что пришёл в ответе на создание счёта. По нему находите заказ, а номер заказа можно положить в metadata при создании.
  • Если ваш сервер не ответил 2xx, доставка повторится через 1 мин, 5 мин, 30 мин, 2 ч, 6 ч и 24 ч. Обрабатывайте каждое событие один раз по его id.
  • Пропущенные события можно дочитать из журнала GET /v2/events.

Без кода, в Telegram, об оплате тоже приходит «Оплачено»: как узнать, что клиент оплатил Kaspi.

Что важно знать до боя

  • Idempotency-Key обязателен для запросов, создающих платёж. Используйте номер заказа: при повторе запроса счёт не задвоится.
  • Ошибка всегда в одном формате: {"error": {"code", "message", "category", "request_id"}}. category подсказывает, что делать: temporary — повторить позже, permanent и validation — не повторять, а исправить запрос.
  • Kaspi может отказать с HTTP 200: тогда у операции status: "failed" и failure_reason. Проверяйте статус, а не только код ответа.
  • Для боевого ключа нужна касса Kaspi Pay и отдельный номер сотрудника с ролью «Кассир». Роль не умеет выводить деньги. Под этим номером нельзя входить в приложение Kaspi Pay: у Kaspi одна сессия на номер.

Документация

Вопросы: hello@aitole.kz или issue в этом репозитории.


English

Code samples for Aitole, a REST API for accepting Kaspi Pay payments in Kazakhstan: QR codes, invoices to a customer's phone number, payment links, recurring invoices, refunds, and signed webhooks. Node.js, Python, PHP and curl, no dependencies.

AITOLE_API_KEY=sk_test_… node node/quickstart.mjs   # full payment flow in the sandbox

Webhooks are signed with HMAC-SHA256 over "{X-Webhook-Timestamp}.{raw body}", sent as X-Webhook-Signature: sha256=<hex>; reject requests older than 300 seconds. API reference: aitole.kz/docs. Aitole is an independent service, not a bank and not affiliated with Kaspi Bank.

Лицензия

MIT

Reviews

No reviews yet

Be the first to review this server!