Альфа-Банк API: ИИ-агент для платежей и выписок

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

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

Это подключение к API банка, а не плагин в бухгалтерскую программу. Запрос идёт на песочницу или на промышленный адрес, авторизация — заголовком Authorization в одном из двух вариантов: Bearer с access-token по Authorization Code Flow либо ApiKey, выпущенный на портале разработчика.

Метод выписки требует скоупа transactions, номера расчётного счёта и даты исполнения. Пароль от интернет-банка коннектор не хранит: он работает с ключом и токеном, а доступ отзывается на портале.

Портал разработчика описывает эндпоинты Alfa API, даёт песочницу и примеры кода. В нём есть разделы интеграций, вебхуков, TLS-сертификатов и API Keys, а также инструкции по подключению, подписанию договора и запуску в промышленную среду.

Типы интеграций разделены: B2B — операции по другим организациям при их согласии, B2C — когда конечный потребитель физическое лицо, H2H — обмен с системами компании. Отдельным блоком идёт Alfa ID с авторизационными сценариями.

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

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

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

Из выписки агент видит, как клиент платит и на что жалуется в назначении платежа. Он готовит черновики ответов на языке переписки и подкладывает нужные реквизиты, а спорные случаи помечает для человека.

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

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

Подпись платежа, проводка в учёте и решение по спорной операции. Ключи, скоупы и TLS-сертификаты тоже настраивает человек на портале разработчика.

Зарегистрируйтесь на портале разработчика, подпишите договор и выпустите API Key в разделе портала. Для сценариев от имени пользователя настройте Authorization Code Flow. Проверьте запросы на песочнице, затем переключитесь на промышленный адрес.

Не подписывает платёжные документы и не проводит операции без выданного скоупа. Не работает, если доступ не оформлен договором. Не хранит пароль от интернет-банка.

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

Что такое коннектор к Альфа-Банк API? Подключение по ключу или токену к методам банка. Доступ ограничен скоупами, а ключ отзывается на портале разработчика.

Сколько данных видит агент? Ровно те счета и операции, на которые выдан скоуп. Всё остальное для него закрыто.