ИИ + ЮKassa
ИИ + ЮKassa: сверка платежей, статусы, возвраты и безопасные варианты API и read-only MCP.
Безопасный старт
- начните с skill или выгрузки
- не вставляйте API-токены в demo
- write-actions только с подтверждением
Обновлено 2 июля 2026 г.
Что можно получить быстро
Объяснить статус оплаты
Подготовить понятный ответ клиенту: оплачен, в обработке, отменён или ожидает capture.
Разобрать возврат
Объяснить цепочку refund → банк без обещаний вне регламента.
Сверить с CRM/заказами
Найти расхождения между платежами ЮKassa и заказами за период.
С чего начать без кода
Если клиент спрашивает про оплату или возврат, не начинайте с API keys. Вставьте статус заказа, сумму, дату оплаты и регламент возврата в skill — получите вежливый черновик ответа без доступа к ЮKassa.
Безопасный первый шаг: используйте refund-explanation-draft для возвратов или support-faq-draft для вопросов об оплате. Оператор проверяет факты и отправляет клиенту.
Что можно автоматизировать
- Объяснение статусов платежа: succeeded, pending, waiting_for_capture, canceled.
- Черновики ответов о возврате: refund → банк, сроки по регламенту.
- Сверка платежей ЮKassa с заказами CRM/склада.
- Summary выручки и refunds для собственника.
- Поиск «зависших» платежей и расхождений.
- Проектирование webhook: payment.succeeded → CRM → Telegram.
Как подключать глубже
YooKassa API v3 (https://api.yookassa.ru/v3/) работает через HTTP Basic Auth. На POST обязателен Idempotence-Key (UUID). Webhooks доставляют события payment/refund на ваш HTTPS endpoint.
Для production начинайте с read-only: GET /payments, GET /payments/{id}, GET /refunds. Create payment, capture и refund — high-risk: только с human approval и отдельным workflow.
Community MCP @theyahia/yookassa-mcp покрывает 20 tools включая 54-FZ receipts — используйте read-only subset. Seed @agentpoint/mcp-yookassa-readonly — placeholder для сверки.
Важно про доступы
AgentPoint не подключается к вашему магазину ЮKassa и не хранит secret_key. Все credentials — в вашей инфраструктуре, n8n credentials или backend.
AI не списывает и не возвращает деньги. Любые финансовые операции — только после проверки человеком.
Когда нужна адаптация
Запросите адаптацию, если хотите автоматическую сверку платежей с CRM, webhook → n8n → AI summary, read-only payment dashboard или controlled MCP без create/refund tools.
Ещё полезные сценарии
Summary для собственника
Собрать выручку, refunds и проблемные платежи за неделю или месяц.
Спроектировать webhook
Описать flow payment.succeeded → CRM/склад → уведомление команде.
Варианты подключения
Идите от простого к сложному: сначала skill и выгрузки, потом workflow, API и MCP только если нужна регулярная автоматизация.
L0Без подключения
Вставьте статус заказа, сумму и регламент в skill — без shop_id и secret_key.
SMB
Без подключения
Вставьте статус заказа, сумму и регламент в skill — без shop_id и secret_key.
L1Ручная сверка
Выгрузите платежи из кабинета ЮKassa и анализируйте через support/refund skills.
SMB
Ручная сверка
Выгрузите платежи из кабинета ЮKassa и анализируйте через support/refund skills.
L2Workflow
n8n: webhook payment events → AI summary → Telegram или CRM update draft.
Внедренец
Workflow
n8n: webhook payment events → AI summary → Telegram или CRM update draft.
L3YooKassa API v3
get_payment / list_payments read-only; write — только с idempotence key и approval.
Разработчик
YooKassa API v3
get_payment / list_payments read-only; write — только с idempotence key и approval.
L4MCP
Read-only MCP или @theyahia/yookassa-mcp с ограничением write-tools.
Power user
MCP
Read-only MCP или @theyahia/yookassa-mcp с ограничением write-tools.
Доступы и ограничения
Где выполняется
У пользователя / в инфраструктуре интегратора
Авторизация
YOOKASSA_SHOP_ID, YOOKASSA_SECRET_KEY
Права
Read-only API key или full access
Данные
Платежи, суммы, статусы, персональные данные покупателей
Read-only + черновики; create/refund только с idempotence key и подтверждением
- Не вставляйте secret_key в demo-chat.
- AI не инициирует refund и create_payment без human approval.
- Объяснение клиенту — черновик оператора, не автоответ.
- 54-FZ чеки и оферта — сверяйте с юристом/бухгалтером.
Для внедренцев и разработчиков
Платформы, API и MCP-варианты. Этот блок нужен, когда вы уже готовы автоматизировать регулярный процесс.
Advanced
Для внедренцев и разработчиков
Платформы, API и MCP-варианты. Этот блок нужен, когда вы уже готовы автоматизировать регулярный процесс.
Пути по платформам
n8n
Webhook Trigger + HTTP Request к api.yookassa.ru/v3 для сверки и уведомлений.
Yandex AI Studio
Read-only backend tools или MCP Hub + scoped yookassa MCP.
GigaChat
Function schema + payment proxy (list/get only).
Cursor / Claude
Read-only MCP или @theyahia/yookassa-mcp без create/refund tools в production.
CMS / магазин
Официальный модуль ЮKassa для Tilda/Bitrix/и др. — проще API для SMB.
MCP-источники
MCP здесь advanced-вариант. Перед production проверяйте репозиторий, scopes токена, read-only режим и rate limits.