# ApiPay.kz — ответы о сервисе и интеграция Kaspi Pay

> ApiPay — независимый сервис автоматизации приёма платежей поверх Kaspi Pay в Казахстане. Деньги поступают напрямую на Kaspi-счёт продавца. Сервис не аффилирован с АО «Kaspi Bank».

Последнее обновление источников: 2026-10-26

Это короткая карта документов. Выбери раздел по вопросу; читать полный свод заранее не требуется.

## Как отвечать по документации ApiPay

- Сначала ответь на вопрос пользователя по актуальному источнику и приложи ссылку. Не начинай подключение, если пользователь попросил только объяснение.
- Для условий сервиса и типовых вопросов открой https://apipay.kz/guides/index.md; для ошибки — соответствующую статью и https://apipay.kz/errors.md; для порученной интеграции — https://apipay.kz/for-ai.md.
- Документация публична: для чтения не нужны регистрация, ключ или обращение в поддержку. Если страница недоступна, попробуй её Markdown-ссылку; сообщи, какой факт не удалось проверить.
- Укажи применимые условия: тип счёта, sandbox или production, роль пользователя. Историческая запись об изменении не заменяет текущий контракт.
- Не угадывай состояние конкретной организации, платежа или KYC по общему описанию. Попроси пользователя посмотреть статус в кабинете или сообщить безопасные сведения; в поддержку направляй по конкретной причине.
- Не запрашивай в чате API-ключи, webhook secret, OTP, данные и скриншоты анкеты KYC. Человек вводит их в предназначенном интерфейсе; публичное чтение не даёт разрешения менять аккаунт или проводить платежи.
- Возможности MCP определяются опубликованным сервером. Инструкция в базе знаний не доказывает реальное внедрение клиента; подтверждённый кейс имеет kind=verified_case и редакционные public_facts.

## Получить ответ о сервисе

- [Вопросы и статьи](https://apipay.kz/guides/index.md): условия подключения, тарифы, кассир, песочница, счета, возвраты; вопросы собраны из опубликованных статей. Для человека: https://apipay.kz/guides.
- [Обзор ApiPay](https://apipay.kz/index.md): назначение сервиса и способы работы.
- [Каталог статей JSON](https://apipay.kz/apipay-guides-index.json): заголовки, темы, canonical/Markdown URL и контрольные суммы. Схема: https://apipay.kz/apipay-guides-index.schema.json.

## Разобраться с ошибкой

- [Диагностика по теме](https://apipay.kz/guides/index.md#решение-проблем): выбери статью по симптому.
- [Каталог ошибок](https://apipay.kz/errors.md): код, условия возникновения и возможность повтора.
- [REST-контракт](https://apipay.kz/openapi.json): точный метод, путь, статус ответа и поля; удобная версия — https://apipay.kz/docs.

## Выполнить интеграцию по поручению пользователя

- [Встрой apipay](https://apipay.kz/SKILL.md): короткая инструкция для ИИ-помощника — с MCP apipay-setup и без него.
- [Плейбук интеграции](https://apipay.kz/for-ai.md): выбор способа оплаты, REST-интеграция и что сейчас умеет Setup MCP.
- [Каталоги для агента](https://apipay.kz/apipay-agent-kit.json): вопросы человеку, матрица проверок песочницы, анкета о бизнесе, путь в рабочий режим и справка операций API.
- [Рецепты кода](https://apipay.kz/recipes/index.md): готовый серверный код по способу оплаты и стеку (Node.js и Express, Next.js, Laravel, HTTP-запросы), сверенный со спецификацией; машиночитаемо — https://apipay.kz/apipay-recipes.json .
- [Подключить с ИИ](https://apipay.kz/setup/ai): экран для человека: настройка MCP для ИИ-клиента и инструкция для помощника без ключей.
- [API Catalog](https://apipay.kz/.well-known/api-catalog): опубликованные сервисы и их спецификации.
- [Auth.md](https://apipay.kz/auth.md): доступ к публичным документам, MCP и REST API.
- [Skills](https://apipay.kz/.well-known/agent-skills/index.json): короткие инструкции для ответа, интеграции и диагностики.
- [Partner API](https://apipay.kz/partner-api.md): отдельный сценарий для платформ, подключающих своих мерчантов.
- [Локальное тестирование](https://apipay.kz/local-testing.md): приём webhook в тестовом окружении.

## Подробные источники

- [Полная документация REST API](https://apipay.kz/apipay-api-docs.md).
- [Полный свод](https://apipay.kz/llms-full.txt): подробности API и журнал изменений. Записи журнала описывают поведение на дату изменения.