IntellectMoney Payout API: ИИ-агент для выплат

IntellectMoney Payout API — интерфейс массовых выплат на карты, кошельки и СБП. Карточка о том, как подключить к нему агента: она для финансиста, который вручную сверяет реестр выплат и статусы операций.

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

Коннектор — описание подключения: где взять ключ доступа клиента, как проверить связь и какие данные доступны. Это не плагин и не доработка: ключ выдаёт PersonalAPI, у него есть срок, и агент берёт новый перед вызовом. Секрет подписи он не хранит в открытом виде.

Payout API проводит массовые выплаты любым получателям. Все запросы используют ключ доступа клиента: его выдаёт метод getUserToken из PersonalAPI, и поскольку у ключа есть срок валидности, вызывать его нужно перед операцией. Поддерживаются JSON и x-www-form-urlencoded, уровни доступа — Базовый и PCI DSS.

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

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

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

Агент готовит ответ клиенту по статусу выплаты: принято, в обработке, исполнено, отклонено. Причину отказа он берёт из ответа метода, а не придумывает; формулировки — из вашего словаря. Если данных нет, он пишет «уточняется» и зовёт оператора. Пока операция в обработке, ответ честно говорит об этом, а не обещает зачисление сегодня и не превращает ожидание в отказ.

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

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

Запуск операции, проверку реквизитов и спор с банком. Агент готовит и сверяет, а ExecuteOperation нажимает человек.

Нужен доступ к Payout API: он выдаётся по договору, а ключ клиента получают методом getUserToken из PersonalAPI перед вызовом. Заголовок Sign собирается по правилу UserToken::Pan::Account::Amount::Currency::RecipientName::signSecretKey.

Не хранит ключ и signSecretKey в открытом виде. Не проводит выплату без подтверждения.

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

Что такое коннектор? Описание подключения: где взять ключ доступа клиента, как проверить связь и какие данные доступны. Не плагин и не доработка — доступ по договору и ключ из PersonalAPI. Секрет подписи агент не хранит в открытом виде.

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