Подключите Kaspi Pay с помощью AI-ассистента

Выберите своего агента: Claude Code, Codex, Claude или ChatGPT. Он проведёт вас от песочницы до первого настоящего платежа: подготовит аккаунт и ключи, напишет код интеграции и проверит платежи, вебхуки и возвраты.

Навыки плагина работают в Claude (claude.ai, приложение, Cowork), Claude Code и Codex. ChatGPT в браузере получает только инструменты xPayment, без навыков.

С чего начать

Выберите агента и скажите, есть ли у вас кассир Kaspi Pay. Страница покажет путь и готовое сообщение для вашего ассистента.

Без кассы Kaspi

Claude, Claude Code, Codex

Подключи приём оплаты через xPayment. Кассира Kaspi Pay у меня пока нет, поэтому начни с песочницы: тестовый ключ, тестовая касса, тестовый вебхук. Напиши интеграцию в моём проекте и прогони платежи, все исходы, вебхуки и возвраты. Ключи храни в .env и не печатай их в ответе.

ChatGPT

Помоги подключить приём оплаты Kaspi Pay через xPayment. Используй инструменты xPayment, начни с whoami. Кассира Kaspi Pay у меня пока нет, поэтому работай только в песочнице (environment: sandbox): выпусти тестовый ключ xapi_test_…, создай тестовую подписку на вебхуки, создай тестовый платёж, задай исходы paid, declined, expired и failed через simulate_test_payment и проверь возвраты. Покажи результат таблицей. Ничего не делай на боевой среде. Задавай по одному вопросу за раз.

Другой агент

Подключи Kaspi Pay через xPayment API v2 в моём проекте. Документация одним файлом: https://xpayment.kz/llms-full.txt, описание API: https://xpayment.kz/openapi/xpayment-api-v2.json. Кассира Kaspi Pay у меня пока нет, поэтому работаем в песочнице: тестовый ключ xapi_test_… и кассу test я возьму в кабинете («Песочница» → «Ключи») и положу в .env сам, не проси вставлять ключ в чат. Напиши клиент и обработчик вебхука (проверка подписи, идемпотентность) и проверь платежи, все исходы и возвраты через POST /v2/sandbox/payments/PAYMENT_ID/simulate.

С кассой Kaspi

Claude, Claude Code, Codex

Подключи приём оплаты через xPayment. Кассир Kaspi Pay у меня уже есть. Сначала прогони полный цикл в песочнице, потом проведи меня до боя: касса, вебхук и ключ. Боевые ключи и секреты только через одноразовые ссылки, живые действия только после моего «да».

ChatGPT

Помоги подключить приём оплаты Kaspi Pay через xPayment. Используй инструменты xPayment, начни с whoami. Кассир Kaspi Pay у меня уже есть. Сначала прогони полный цикл в песочнице (environment: sandbox), потом помоги подключить кассу и настроить боевой вебхук и ключ. Боевые ключи и секреты выдавай только одноразовой ссылкой, не показывай их в чате. Удаление, отзыв и возврат по настоящему платежу делай только после моего явного «да». Боевые платежи не создавай. Задавай по одному вопросу за раз.

Другой агент

Подключи Kaspi Pay через xPayment API v2 в моём проекте. Документация одним файлом: https://xpayment.kz/llms-full.txt, описание API: https://xpayment.kz/openapi/xpayment-api-v2.json. Касса Kaspi Pay у меня уже подключена в кабинете xPayment. Сначала всё проверь в песочнице с тестовым ключом xapi_test_…, потом подготовь переключение на бой: ключ, device_name и секрет вебхука. Ключи я положу в .env сам, не проси вставлять их в чат. Напиши клиент и обработчик вебхука (проверка подписи, идемпотентность).

Два пути к рабочей интеграции

Без кассы Kaspi вы начинаете сразу, в песочнице. С кассой проходите ту же песочницу и затем переходите на бой. Метки показывают, кто что делает.

Без кассы Kaspi: Песочница: разрабатываем и тестируем без денег

Бесплатно и сразу после регистрации. Касса Kaspi, тариф и деньги не нужны; адреса, запросы и ответы те же, что на бою.

  1. Зарегистрируйтесь в xPayment (Делаете вы): Регистрация по SMS на странице «Войти через xPayment». Тариф и касса Kaspi для песочницы не нужны.
  2. Подключите ассистента (Делаете вы): Войдите через xPayment и на странице согласия нажмите «Разрешить»: она показывает права, которые просит ассистент.
  3. Тестовый ключ и вебхук (Делает AI): Ассистент выпускает ключ xapi_test_… и тестовую подписку на вебхуки. В проекте записывает значения в .env, не печатая их.
  4. Код интеграции (Делает AI): Клиент и обработчик вебхука в вашем стеке: X-Idempotency-Key, проверка подписи по сырому телу, повторный delivery_id не обрабатывается дважды, после события запрашивается платёж.
  5. Платежи и исходы (Делает AI): Платёж создаётся так, как будут делать ваши клиенты. Исход задаётся для каждого случая: paid, declined, expired, failed.
  6. Вебхуки (Делает AI): Доставка проверяется целиком: верная подпись даёт ответ 2xx, неверная — 401; заказ в проекте меняет статус.
  7. Возвраты и ошибки (Делает AI): Тестовый возврат проходит сам; возврат ровно 13.13 всегда отклоняется; телефоны …7000000001 и …7000000002 дают ошибки Kaspi.
  8. Отчёт (Делает AI): Короткая таблица: что проверено и что исправлено. Для боя остаётся подключить кассу.

Без публичного адреса вебхуки не дойдут до сервера на вашем компьютере: ассистент предложит тоннель (рекомендует его) или проверки с локальной подписью.

В песочнице нет статического QR, онлайн-записи, регулярных платежей и подписок. Лимит: 60 тестовых записей в минуту и 1000 в сутки. Тестовые платежи хранятся 30 дней.

С кассой Kaspi: От песочницы до первого настоящего платежа

Сначала тот же цикл в песочнице, затем боевая касса, вебхук и ключ. Всё, что можете сделать только вы, отмечено.

  1. Кассир в приложении Kaspi Pay (Делаете вы): Отдельный кассир с ограниченными правами: только приём платежей и своя история, без переводов. Для него нужен отдельный номер. Ассистент не может сделать это за вас.
  2. Тариф (Делаете вы): Ассистент проверяет тариф, выбираете и оплачиваете вы. Первые 3 дня бесплатно, затем фиксированный тариф.
  3. Касса в xPayment (Делает AI, Делаете вы, Нужно ваше «да»): Ассистент запускает подключение, Kaspi присылает SMS-код на номер кассира, код называете вы. Касса сверх тарифа платная: ассистент назовёт цену и дождётся вашего «да».
  4. Песочница (Делает AI): Тот же цикл, что в первом пути: платежи, исходы, вебхуки и возвраты на тестовых ключах.
  5. Боевой вебхук (Делает AI, Делаете вы): Ассистент создаёт подписку на адрес вашего сервера и даёт одноразовую ссылку (действует час). Вы открываете её и сохраняете секрет на сервере. Затем уходит тестовое событие.
  6. Боевой ключ и переключение (Делает AI, Делаете вы): Ключ тоже приходит по одноразовой ссылке. В коде меняются три значения: ключ (xapi_test_… → xapi_…), device_name (test → имя вашей кассы) и секрет вебхука. Остальной код тот же.
  7. Первый настоящий платёж (Делаете вы, Нужно ваше «да»): Небольшую сумму оплачиваете вы: ассистент боевые платежи не создаёт. Возврат по настоящему платежу только после вашего «да».

Нет сайта или разработчика? Вместо кода ассистент создаст платёжную страницу в кабинете. Публикация только после вашего «да».

Попробуйте песочницу

Так выглядит цикл, который проходит ваш ассистент: платёж, исход, вебхук, возврат.

В теле вебхука нет суммы и статуса: после события ваш код запрашивает GET /v2/payments/PAYMENT_ID и опирается на статус платежа.

Кто что делает

Четыре колонки: что ассистент делает сам, что только после вашего «да», что можете сделать только вы и чего он не делает никогда.

Ассистент делает сам

Без лишних вопросов, в рамках выданных вами прав.

Только после вашего «да»

Ассистент называет действие точно и ждёт ответа именно на него.

Только вы

Этого ассистент сделать не может.

Ассистент не делает никогда

Это закрыто правилами плагина.

Семь прав доступа

На странице согласия вы видите, что просит ассистент, и разрешаете или отказываете. Инструмент без нужного права отвечает SCOPE_REQUIRED: подключитесь снова и разрешите это право.

Журнал действий ассистента и отзыв доступа: «Настройки» → «Подключённые AI».

Безопасность

Сначала всё проходит в песочнице на тестовых ключах — без денег и без Kaspi. Настоящий платёж AI создать не может, а менять боевые объекты начинает, только когда вы попросили именно бой.

  1. Вы входите через xPayment. Вход идёт на странице самого xPayment, «Войти через xPayment». Затем страница согласия показывает права, которые просит AI, и вы разрешаете их или отказываете.
  2. Опасные действия — только после вашего «да» в чате. Удаление кассы, отзыв ключа, удаление подписки на вебхуки или смена её секрета, архивирование и публикация платёжной страницы, возврат по настоящему платежу, касса сверх тарифа: AI делает это, только когда вы ответили «да» именно на это действие. Общее «делай всё» не считается.
  3. Боевые ключи и секреты вебхуков не попадают в чат. AI даёт одноразовую ссылку (она действует час): вы открываете её, один раз видите значение и сохраняете его сами, например в .env. Если вы всё же отправили ключ в чат, AI скажет заменить его.
  4. Вы видите, что делал AI, и можете это остановить. Журнал действий и отзыв доступа — в кабинете: «Настройки» → «Подключённые AI».

Ваши данные уходят в тот AI-сервис, который вы выбрали. Всё, что AI читает в вашем аккаунте, включая телефоны и email плательщиков, отправляется в этот сервис (Claude, ChatGPT или Codex).

Установка

Выберите, где вы работаете с AI. Быстрый вариант под вашего агента есть выше, в блоке «С чего начать».

Claude (claude.ai, приложение, Cowork)

Плагин ставится из маркетплейса. Эти шаги проверены на claude.ai в браузере; в приложении для компьютера и в Cowork путь тот же, но отдельно мы его там не проходили.

  1. Откройте Персонализация → Плагины → «+ Добавить», выберите «Добавить маркетплейс», затем «Добавить из репозитория».

  2. В поле поиска введите адрес репозитория и нажмите «Синхронизация».

    xpayment-kz/xpayment-ai
  3. Появится карточка «xPayment» (автор xpayment-ai). Нажмите «Добавить». Если появится окно с предупреждением, прочитайте его и нажмите «Продолжить».

  4. На странице плагина в списке «Коннекторы · 2» подключите оба коннектора. У каждого: «Подключить» → «Добавить пользовательский коннектор» → «Продолжить», затем «Добавить» и снова «Подключить». xpayment-docs — документация, вход ей не нужен.

  5. Для xpayment откроется страница xpayment.kz/login: войдите через «Войти через xPayment» и на странице согласия нажмите «Разрешить». Коннектор станет подключённым.

В первый раз Claude спрашивает разрешение на каждый инструмент: «Разрешить один раз». В плагине нет скриптов и хуков; пометка «Может отправлять данные в другие сервисы» относится к двум MCP-серверам.

Как вызвать. Нажмите «Попробовать в чате» на странице плагина: откроется чат с уже набранной командой /integrate. Навык также включается сам, когда запрос ему подходит.

Как обновить. Персонализация → Плагины → «+ Добавить» → «Управлять маркетплейсами» → xpayment-ai → ⋯ → «Проверить обновления».

Claude Code (терминал)

Нужен Claude Code 2.1.319 или новее.

  1. Установите плагин в терминале (он ставится для вашего пользователя):

    claude plugin marketplace add xpayment-kz/xpayment-ai
    claude plugin install xpayment@xpayment

    То же самое внутри сессии: /plugin marketplace add xpayment-kz/xpayment-ai, затем /plugin install xpayment@xpayment. После установки начните новую сессию.

  2. Проверьте, что всё на месте: плагин xpayment с четырьмя навыками (xpayment:ask, xpayment:check, xpayment:integrate, xpayment:migrate-v2). Сервер xpayment-docs подключён, сервер xpayment ждёт входа.

  3. Войдите в аккаунт: в сессии выполните /mcp, выберите plugin:xpayment:xpayment и Authenticate. Нужен интерактивный терминал. В браузере откроется «Войти через xPayment».

    Этот шаг описан по инструкции плагина; в нашей проверке вход в аккаунт из Claude Code не запускался.

    То же самое можно сделать одной командой в терминале:

    claude mcp login plugin:xpayment:xpayment

Как вызвать. Введите /xpayment:ask, /xpayment:integrate, /xpayment:migrate-v2 или /xpayment:check — или просто опишите задачу.

Как обновить. Выполните две команды, затем /reload-plugins или начните новую сессию.

claude plugin marketplace update xpayment
claude plugin update xpayment@xpayment

ChatGPT (chatgpt.com в браузере)

ChatGPT в браузере получает инструменты xPayment, но не навыки: команд ask и integrate здесь нет — опишите задачу обычными словами.

  1. На chatgpt.com откройте Плагины → «Добавить» → «Добавить пользовательский сервер MCP».

  2. «Название»: xPayment. «Описание»: своими словами.

  3. «Подключение» → «URL-адрес сервера»: введите адрес.

    https://api.xpayment.kz/mcp
  4. «Аутентификация»: OAuth. В «Расширенных настройках OAuth» ChatGPT сам находит данные клиента, вводить ничего не нужно.

  5. Отметьте «Я понимаю и хочу продолжить» и нажмите «Создать в виде плагина». Это решение вы принимаете сами.

  6. Войдите через «Войти через xPayment» и нажмите «Разрешить».

Как вызвать. В чате наберите @xPayment и свой запрос или нажмите «Попробовать в чате».

Как обновить. Обновлять ничего не нужно: сервер удалённый, изменения доходят сами.

Про приложение ChatGPT для компьютера читайте README в репозитории плагина. Плагин на GitHub

Codex (Codex CLI)

Проверено на Codex CLI 0.167.0.

  1. Установите плагин:

    codex plugin marketplace add xpayment-kz/xpayment-ai
    codex plugin add xpayment@xpayment
  2. Войдите в аккаунт:

    codex mcp login xpayment

    Codex сам представится xPayment, вводить ничего не нужно. В браузере откроется «Войти через xPayment»: разрешите доступ, и Codex сообщит, что вход выполнен.

    Если в браузере по умолчанию вы вошли в xPayment под другим аккаунтом, откройте ссылку, которую напечатал Codex, в браузере с нужным аккаунтом.

  3. Проверьте: codex mcp list показывает xpayment и xpayment-docs (до входа у xpayment написано «Not logged in»), а навыки называются xpayment:ask, xpayment:check, xpayment:integrate, xpayment:migrate-v2.

Как вызвать. Назовите навык по имени или опишите задачу.

Как обновить. Выполните команду и начните новую сессию.

codex plugin marketplace upgrade xpayment

Другой агент (другие клиенты и IDE)

Мы проверяли только Claude, Claude Code, Codex и ChatGPT. Эти варианты не проверялись: названия кнопок в вашем клиенте могут отличаться.

  1. MCP-сервер «документация» работает без входа, если клиент поддерживает MCP по HTTP. Адрес:

    https://api.xpayment.kz/mcp/docs
  2. MCP-сервер «аккаунт» входит в ваш аккаунт по OAuth («Войти через xPayment»), если клиент умеет OAuth для MCP. Адрес:

    https://api.xpayment.kz/mcp
  3. Без MCP: возьмите тестовый ключ xapi_test_… в кабинете («Песочница» → «Ключи») и сохраните его в .env сами. Боевые ключи тоже выпускаются в кабинете.

  4. Дайте агенту документацию одним файлом: в нём все эндпоинты API v1 и v2.

    https://xpayment.kz/llms-full.txt

Как вызвать. Опишите задачу своими словами или используйте готовое сообщение из блока «С чего начать».

Как обновить. Обновлять нечего: серверы удалённые.

Шаги проверены 10 ноября 2026: Claude Code 2.1.319, Codex CLI 0.167.0, claude.ai и chatgpt.com в браузере (русский интерфейс). Названия кнопок даны как в русском интерфейсе; экраны Claude и ChatGPT меняются, поэтому у вас они могут отличаться.

Только подключение, без плагина

Можно подключить только MCP-серверы xPayment, без плагина. Вы получите инструменты и документацию, но не навыки: пошаговые инструкции ask, integrate, migrate-v2 и check загружены не будут.

В Claude: Персонализация → Коннекторы → «+ Добавить» → «Добавить пользовательский коннектор». Добавьте два коннектора.

Документация. Вход не нужен.

https://api.xpayment.kz/mcp/docs

Аккаунт. OAuth: войдите через «Войти через xPayment» и нажмите «Разрешить».

https://api.xpayment.kz/mcp

У этого варианта мы проверяли только путь по меню.

Два MCP-сервера

MCP даёт ассистенту инструменты. Плагин подключает оба сервера xPayment и добавляет навыки: готовые инструкции.

«документация»: без входа

Пять инструментов: паспорт API, список разделов, раздел, поиск и описание эндпоинта. Ассистент отвечает по актуальной документации. https://api.xpayment.kz/mcp/docs

«аккаунт»: вход через xPayment

Инструменты вашего аккаунта: кассы, ключи, вебхуки, платёжные страницы, тестовые платежи и возвраты. Только в рамках ваших прав и прав, выданных ассистенту. https://api.xpayment.kz/mcp

Четыре навыка

Навыки — готовые инструкции для вашего AI. Скриптов и хуков в плагине нет.

Частые вопросы

Можно ли начать без кассы Kaspi Pay?

Да. Песочница бесплатна и доступна сразу после регистрации: тестовая касса test, тестовые ключи xapi_test_…, без тарифа, без Kaspi и без денег. Весь путь, от платежа до вебхука и возврата, проходит в ней. Настоящие платежи начнутся после подключения кассы.

Увидит ли ассистент мои ключи?

Тестовый ключ ассистент выпускает сам и записывает в .env вашего проекта, не печатая его. Боевые ключи и секреты вебхуков он не видит: даёт одноразовую ссылку на час, и вы сохраняете значение сами. Если ключ всё же попал в чат, ассистент скажет заменить его.

Может ли ассистент создать настоящий платёж?

Нет. Боевые платежи ассистент не создаёт и не отменяет: первый настоящий платёж делаете вы. Возврат по настоящему платежу он делает только после вашего «да» на это действие.

Как это работает в ChatGPT?

В ChatGPT в браузере подключается MCP-сервер xPayment: инструменты есть, навыков нет, поэтому опишите задачу словами или отправьте готовое сообщение из блока «С чего начать». Архив плагина chatgpt.com принял, но в приложении ChatGPT для компьютера мы его не проверяли.

Как посмотреть, что делал ассистент, и отозвать доступ?

В кабинете: «Настройки» → «Подключённые AI». Там журнал действий и кнопка отзыва доступа.

API v1 или v2?

Для нового подключения рекомендуем API v2: сейчас он в статусе beta и может меняться. API v1 стабилен и полностью поддерживается.

У меня другой агент или IDE. Это подойдёт?

Да, но эти варианты мы не проверяли. Дайте агенту файл llms-full.txt с документацией и описание API v2, а тестовый ключ возьмите в кабинете («Песочница» → «Ключи»). Если клиент поддерживает MCP, можно подключить оба сервера.

Материалы и ссылки

Начните с песочницы

Песочница бесплатна и доступна сразу после регистрации. Выберите агента выше и отправьте ему готовое сообщение.