ИИ для ЮKassa: AI-агент ЭДДИ проверяет платежи и возвраты
Коротко
ЮKassa подключается к ЭДДИ АИ шаблоном MCP. Финансист или сотрудник поддержки спрашивает в чате, прошла ли оплата по заказу, оформлен ли возврат, сколько платежей было за неделю, — и агент отвечает по данным API ЮKassa. Проводить возвраты агент может только с разрешения администратора.
AI-агент ЭДДИ подключается к ЮKassa через шаблон MCP: находит платёж по заказу, проверяет статус оплаты и возврата и собирает сводки по выручке по запросу в чате. Поддержке больше не нужно ждать ответа бухгалтерии на вопрос «клиент оплатил?», а финансист получает сводку без выгрузок из личного кабинета.
Что агент видит в ЮKassa?
Агент работает через API ЮKassa. Через него доступны:
- платежи — сумма, статус (ожидает, оплачен, отменён), способ оплаты, описание и метаданные заказа;
- возвраты — сумма, статус и причина возврата по каждому платежу;
- чеки — данные чеков, отправленных по 54-ФЗ;
- история операций — список платежей и возвратов за период с фильтрами.
Какие вопросы закрывает агент?
| Кто спрашивает | Пример запроса | Что получает |
|---|---|---|
| Поддержка | «Клиент говорит, что оплатил заказ 18452. Платёж прошёл?» | Статус платежа, сумма и время |
| Поддержка | «Возврат по заказу 17990 уже ушёл клиенту?» | Статус возврата и дата |
| Финансы | «Собери сводку по оплатам за неделю: сколько платежей и возвратов и на какую сумму» | Таблица по дням и итоги |
| Финансы | «Какие платежи висят в статусе „ожидает подтверждения“ больше суток?» | Список для разбора |
| Руководитель | «Сравни выручку через ЮKassa в сентябре и августе» | Таблица и короткий вывод |
Ежедневную сводку можно поставить на расписание. Другие сценарии — на страницах ИИ для финансового отдела и нейросеть для службы поддержки.
Как подключить ЮKassa к ЭДДИ?
- В личном кабинете ЮKassa выпустите секретный ключ API для агента.
- В ЭДДИ откройте раздел MCP-серверов, нажмите «Новый сервер MCP» и выберите шаблон «ЮKassa».
- Укажите идентификатор магазина и секретный ключ.
- Выберите инструменты и откройте доступ группам — например, поддержке и финансовому отделу.
Какие действия требуют разрешения?
| Действие | Тип |
|---|---|
| Поиск платежа и проверка статуса | Читает |
| Список платежей и возвратов за период | Читает |
| Создание возврата | Меняет |
| Подтверждение или отмена платежа | Меняет |
Деньги — чувствительная зона, поэтому изменяющие инструменты имеет смысл включать точечно: например, только старшему специалисту поддержки и с контролем по журналу действий агента.
Какие ограничения стоит учитывать?
- Поиск по номеру заказа. Найти платёж по номеру заказа можно, если сайт передаёт этот номер в описании или метаданных платежа.
- Возврат — только по успешному платежу и в пределах его суммы.
- Начните с тестового магазина. Сценарии удобно сначала проверить на тестовом магазине ЮKassa, а потом подключить боевой.
Как защищены платёжные данные?
Секретный ключ указывается один раз в настройках подключения, сотрудникам он не нужен. Запросы проверяются на номера карт, телефоны и другие персональные данные до отправки в модель, а каждый шаг агента записывается в журнал. Подробнее о проверке — в статье о защите персональных данных в ЭДДИ АИ.
Если вы принимаете оплату через другие сервисы, посмотрите статьи про Т-Кассу, Robokassa и CloudPayments.
Частые вопросы
Может ли ИИ сделать возврат в ЮKassa?
Технически API ЮKassa позволяет создавать возвраты, но в ЭДДИ это изменяющий инструмент. Администратор решает, включать ли его и каким группам. Чаще агенту оставляют только проверку статусов, а возврат оформляет сотрудник.
Какие ключи нужны для подключения?
Идентификатор магазина и секретный ключ API из личного кабинета ЮKassa. Для агента удобно выпустить отдельный ключ, чтобы при необходимости отозвать его, не трогая основную интеграцию сайта.
Увидит ли модель номера карт покупателей?
API ЮKassa не передаёт полный номер карты. Кроме того, ЭДДИ проверяет запросы на номера карт и другие персональные данные до отправки в модель и применяет правило компании.
