# Альфа-Банк Бизнес

Смотрите обороты и операции по счетам Альфа-Банка в чате

Банковский API — счета, выписки, операции, платежи

## Как агент работает с Альфа-Банк Бизнес

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

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

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

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

## Сценарии интеграции

### Операции и остатки за период
Агент выгрузит выписку по счетам Альфа-Бизнеса, посчитает обороты и покажет крупные и нетипичные операции.

### Сверка с бухгалтерией
Агент сверит банковские операции с проводками 1С и покажет, какие платежи не отражены в учёте.

### Еженедельный финансовый дайджест
Агент по расписанию соберёт динамику остатков, топ-платежи и поступления недели в один отчёт.

### Расклад по контрагентам
Агент разложит поступления и платежи по контрагентам и назначениям и покажет, кто принёс больше всего денег, а на что они утекли.

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

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

## Как подключить

**Перед подключением**

- Расчётный счёт и оформленное РКО в Альфа-Банке
- Руководитель или сотрудник с правом подписи
- OpenSSL на компьютере для генерации приватного ключа

### Проверьте счёт и Альфа-Бизнес Онлайн
Alfa API выдают компаниям с расчётным счётом, оформленным РКО и подключённым Альфа-Бизнес Онлайн. Комиссий за подключение и использование API банк не берёт.

### Запросите доступ и подпишите ИТВ
Отправьте заявку на alfa_api@alfabank.ru с реквизитами компании. Договор ИТВ придёт на подпись в Альфа-Бизнес Онлайн; после подписи банк выдаёт Client ID.

### Сформируйте CSR и заберите сертификат
Выполните openssl req -new -key name.key -out name.csr и заполните поля с данными компании и ИНН. Банк вернёт сертификат в PEM; name.key остаётся только у вас.

### Пройдите «Песочницу» и откройте доступ
Проверьте методы в «Песочнице» и напишите на alfa_api@alfabank.ru письмо с темой «Завершено тестирование» — банк откроет baas.alfabank.ru.

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

### Что нужно для подключения Альфа-Банка?
API-ключ из Альфа-Бизнес Онлайн и, для части методов, клиентский сертификат. Всё хранится в зашифрованном виде.

### Какие данные читает агент?
Счета, выписки, операции и платежи компании — в рамках прав ключа. Данные запрашиваются в момент задачи, без постоянной выгрузки.

### Можно ли отозвать доступ?
Да, в один клик: удалите подключение у нас или отзовите ключ в Альфа-Бизнес Онлайн — доступ прекращается сразу.

[Открыть Альфа-Банк Бизнес](https://developers.alfabank.ru/products/alfa-api)
