Assist: ИИ-агент для рекуррентных платежей

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

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

Три признака: работает в ваших сервисах, доводит дело до результата, работает без вас. Он ходит в шлюз по вашему доступу и запускается по расписанию.

Чат-бот вернёт текст инструкции, которую надо выполнить руками. Агент вернётся со сверкой.

Коннектор — описание подключения: где взять доступ, как проверить связь, какие данные доступны. У Assist запросы подписываются закрытым ключом, и коннектор фиксирует, что именно подписывается.

Это не плагин и не доработка шлюза: код не меняется. Пароль агент не хранит, работает только с выданным доступом.

По документации Assist для инициации рекуррентного платежа в первоначальном запросе на авторизацию передаётся recurringIndicator=1 и параметры, задающие диапазон сумм последующих списаний. При следующем платеже проверяется, что сумма попадает в этот диапазон, иначе операция не проходит. Валюта следующего платежа должна совпадать с валютой инициирующего. Параметры передаются методом POST в теле запроса как «ключ=значение», SOAP-запросом в UTF-8 или в формате JSON; есть описание Swagger. Подпись — значение, подписанное закрытым ключом, закодированное в BASE64.

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

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

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

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

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

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

Изменение диапазона сумм, отмена подписки и возврат — за финансистом. Агент не инициирует списание и не меняет условия договора.

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

Не подписывает запрос самовольно чужим ключом и не обходит проверку диапазона. Не проводит первый платёж за клиента. Не хранит данные карт.

Что такое агент, если коротко? — Программа, которая сама разбирает рекуррентные операции за период и приносит таблицу с причинами отказов. Вы не сверяете каждое списание вручную.

Что такое коннектор? — Описание доступа к Assist: какой идентификатор мерчанта, какой ключ подписи, какие операции открыты. Шлюз при этом не дорабатывается.

Почему списание не прошло? — Чаще всего сумма вышла за диапазон, заданный при первом платеже, или не совпала валюта. Агент показывает, какой параметр не сошёлся.