# ИИ для ЮKassa: AI-агент ЭДДИ проверяет платежи и возвраты

URL: https://eddi-ai.ru/blog/ai-agent-dlya-yukassa
Опубликовано: 14 октября 2026 г.
Автор: Дмитрий Зайченко, Сооснователь ЭДДИ АИ
Рубрика: Гайды

> ЮKassa подключается к ЭДДИ АИ шаблоном MCP. Финансист или сотрудник поддержки спрашивает в чате, прошла ли оплата по заказу, оформлен ли возврат, сколько платежей было за неделю, — и агент отвечает по данным API ЮKassa. Проводить возвраты агент может только с разрешения администратора.

**AI-агент ЭДДИ подключается к ЮKassa через шаблон MCP: находит платёж по заказу, проверяет статус оплаты и возврата и собирает сводки по выручке по запросу в чате.** Поддержке больше не нужно ждать ответа бухгалтерии на вопрос «клиент оплатил?», а финансист получает сводку без выгрузок из личного кабинета.

## Что агент видит в ЮKassa?

Агент работает через [API ЮKassa](https://yookassa.ru/developers/api). Через него доступны:

- **платежи** — сумма, статус (ожидает, оплачен, отменён), способ оплаты, описание и метаданные заказа;
- **возвраты** — сумма, статус и причина возврата по каждому платежу;
- **чеки** — данные чеков, отправленных по 54-ФЗ;
- **история операций** — список платежей и возвратов за период с фильтрами.

## Какие вопросы закрывает агент?

| Кто спрашивает | Пример запроса                                                                      | Что получает                  |
| -------------- | ----------------------------------------------------------------------------------- | ----------------------------- |
| Поддержка      | «Клиент говорит, что оплатил заказ 18452. Платёж прошёл?»                           | Статус платежа, сумма и время |
| Поддержка      | «Возврат по заказу 17990 уже ушёл клиенту?»                                         | Статус возврата и дата        |
| Финансы        | «Собери сводку по оплатам за неделю: сколько платежей и возвратов и на какую сумму» | Таблица по дням и итоги       |
| Финансы        | «Какие платежи висят в статусе „ожидает подтверждения“ больше суток?»               | Список для разбора            |
| Руководитель   | «Сравни выручку через ЮKassa в сентябре и августе»                                  | Таблица и короткий вывод      |

Ежедневную сводку можно поставить на расписание. Другие сценарии — на страницах [ИИ для финансового отдела](https://eddi-ai.ru/ai-dlya-finansov) и [нейросеть для службы поддержки](https://eddi-ai.ru/ai-dlya-podderzhki).

## Как подключить ЮKassa к ЭДДИ?

1. В личном кабинете ЮKassa выпустите секретный ключ API для агента.
2. В ЭДДИ откройте раздел MCP-серверов, нажмите «Новый сервер MCP» и выберите шаблон «ЮKassa».
3. Укажите идентификатор магазина и секретный ключ.
4. Выберите инструменты и откройте доступ группам — например, поддержке и финансовому отделу.

## Какие действия требуют разрешения?

| Действие                              | Тип    |
| ------------------------------------- | ------ |
| Поиск платежа и проверка статуса      | Читает |
| Список платежей и возвратов за период | Читает |
| Создание возврата                     | Меняет |
| Подтверждение или отмена платежа      | Меняет |

Деньги — чувствительная зона, поэтому изменяющие инструменты имеет смысл включать точечно: например, только старшему специалисту поддержки и с контролем по журналу действий агента.

## Какие ограничения стоит учитывать?

- **Поиск по номеру заказа.** Найти платёж по номеру заказа можно, если сайт передаёт этот номер в описании или метаданных платежа.
- **Возврат — только по успешному платежу** и в пределах его суммы.
- **Начните с тестового магазина.** Сценарии удобно сначала проверить на тестовом магазине ЮKassa, а потом подключить боевой.

## Как защищены платёжные данные?

Секретный ключ указывается один раз в настройках подключения, сотрудникам он не нужен. Запросы проверяются на номера карт, телефоны и другие персональные данные до отправки в модель, а каждый шаг агента записывается в журнал. Подробнее о проверке — в статье [о защите персональных данных в ЭДДИ АИ](https://eddi-ai.ru/blog/zashchita-personalnyh-dannyh-v-eddi-ai).

Если вы принимаете оплату через другие сервисы, посмотрите статьи про [Т-Кассу](https://eddi-ai.ru/blog/ai-agent-dlya-t-kassa), [Robokassa](https://eddi-ai.ru/blog/ai-agent-dlya-robokassa) и [CloudPayments](https://eddi-ai.ru/blog/ai-agent-dlya-cloudpayments).

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

### Может ли ИИ сделать возврат в ЮKassa?

Технически API ЮKassa позволяет создавать возвраты, но в ЭДДИ это изменяющий инструмент. Администратор решает, включать ли его и каким группам. Чаще агенту оставляют только проверку статусов, а возврат оформляет сотрудник.

### Какие ключи нужны для подключения?

Идентификатор магазина и секретный ключ API из личного кабинета ЮKassa. Для агента удобно выпустить отдельный ключ, чтобы при необходимости отозвать его, не трогая основную интеграцию сайта.

### Увидит ли модель номера карт покупателей?

API ЮKassa не передаёт полный номер карты. Кроме того, ЭДДИ проверяет запросы на номера карт и другие персональные данные до отправки в модель и применяет правило компании.