ЮKassa: ИИ-агент для сверки платежей

ЮKassa — сервис приёма платежей с открытым справочником API. Материал для финансиста, у которого платежи, возвраты и счета живут в разных выгрузках, а сверка идёт руками.

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

Три признака. Он работает в ваших сервисах, а не в отдельном окне чата. Доводит дело до конца: сам заходит в систему и сам кладёт итог туда, где вы его ждёте. И работает без вас — по расписанию или по событию.

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

Коннектор — описанное подключение агента к сервису по выданному доступу, а не плагин в сайт или кассу.

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

Справочник API описывает платежи, возвраты, счета, чеки, кассовые ссылки и выплаты, а также способы оплаты и участников СБП. Для каждого объекта есть создание, список и информация по конкретной операции, отдельно описан формат запросов, требования к аутентификации и ключ идемпотентности, чтобы повтор запроса не создал второй платёж.

### Платёжный календарь: сроки и пустые дни

Агент сопоставляет платежи и возвраты за период с платёжным календарём: что уже подтверждено, что висит в ожидании, где дата оплаты попала на пустой день. Помечает дни, когда платежей больше, чем поступлений, и показывает операцию, из которой сложился разрыв. Финансист видит проблему заранее, а не после выписки, когда деньги уже ушли и вернуть их сложно. Календарь обновляется при каждой новой операции.

### Просроченные счета: напоминание клиенту

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

### Поддержка на языке клиента

Агент отвечает на вопросы по оплате на языке обращения: как прошёл платёж, почему не зачислилось, какие данные нужны для возврата. Ответ строит по данным из справочника, а не по памяти. Сложные случаи с расхождением сумм передаёт оператору вместе с историей операции, чтобы клиент не повторял всё заново с самого начала разговора. Частые вопросы собираются в сводку.

Решение. Спорный платёж, возврат и блокировку оформляет сотрудник: агент показывает данные и готовит текст. Подпись под платёжным поручением и решение о списании остаются за человеком.

Доступ берётся в личном кабинете ЮKassa: идентификатор магазина и секретный ключ. Агенту хватает чтения платежей, возвратов и счетов. Тестовый режим и полный перечень прав уточняются при подключении.

Агент не проводит платежи и не подписывает поручения. Он не хранит реквизиты карт клиентов и не отвечает клиенту от вашего имени без подтверждения.

Что такое агент, если коротко? Программа, которая получает задачу словами и возвращает готовое дело: сама заходит в кабинет, собирает операции, кладёт сводку. Чат-бот отвечает текстом, агент приносит результат.

Что такое коннектор? Описанное подключение к сервису по выданному доступу. Здесь это идентификатор магазина и секретный ключ: агент читает платежи и счета, пароль кабинета не хранит.