Alfa API: Получить выписку по счёту юридического лица

Сценарий из mcp-everything. Актуально на 2026-10-13.

Возвращает операции по расчётному счёту за дату исполнения. Для валютного счёта параметр curFormat определяет, вернётся curTransfer или swiftTransfer.

Подключи scope transactions и получи доступ через Alfa ID или API Key.
Запроси страницу операций: GET /api/jp/v1/statement/transactions с accountNumber и statementDate.
Обработай transactions и переходи по страницам с помощью page и ссылок _links; на одной странице возвращается не больше 1000 объектов.

curl --location --globoff 'https://baas.alfabank.ru/api/jp/v1/statement/transactions?accountNumber={accountNumber}&statementDate={statementDate}&page={page}&curFormat={curFormat}' \
  --header 'Authorization: Bearer {access-token}' \
  --header 'Accept: application/json'

Базовые URL

Боевой хост: https://baas.alfabank.ru
Тестовый хост: https://sandbox.alfabank.ru
Авторизация пользователя в боевой среде: https://id.alfabank.ru/oidc/authorize
Авторизация пользователя в песочнице: https://id-sandbox.alfabank.ru/oidc/authorize
Продукты и сервисы: https://baas.alfabank.ru/api
Продукты и сервисы в песочнице: https://sandbox.alfabank.ru/api
Alfa ID: https://baas.alfabank.ru/oidc
Alfa ID в песочнице: https://sandbox.alfabank.ru/oidc

Авторизация

Тип: OAuth 2.0

Alfa ID использует OAuth 2.0/OIDC. Для Authorization Code Flow нужны client_id, client_secret, redirect_uri и scopes подключённых продуктов; токен передаётся в заголовке Authorization: Bearer {access_token}. Alfa ID подходит для всех типов интеграций и продуктов.

Для части B2B- и H2H-методов доступен API Key: передавай Authorization: ApiKey {API Key}. Внутренний ключ предназначен для операций по своей компании, внешний — по другой компании; API Key доступен не для всех продуктов, поэтому проверяй описание конкретного метода.

Методы сценария

GET /api/jp/v1/statement/transactions — Получение выписки

Возвращает операции по расчётному счёту за дату. Требует scope transactions; принимает Bearer-токен или API Key.

Документация: https://developers.alfabank.ru/products/alfa-api/documentation/articles/transactions/articles/statement/v1/statement

Параметр	Где	Тип	Обяз.	Описание
`Authorization`	header	string	да	Bearer {access_token} или ApiKey {API Key}
`Accept`	header	string	да	application/json
`accountNumber`	query	string	да	Номер расчётного счёта
`statementDate`	query	string	да	Дата исполнения операции, YYYY-MM-DD
`page`	query	integer	нет	Номер страницы; не больше 1000 объектов на странице
`curFormat`	query	string	нет	Формат операции по валютному счёту

Нюансы

В песочнице все вызовы Alfa API должны выполняться с mTLS. Тестовый сертификат и закрытый ключ выдаются после подключения; негативные сценарии песочницы могут отличаться от промышленной среды и спецификации метода.
Код авторизации действует две минуты и используется один раз. access_token действует один час; refresh_token — 180 дней и может быть использован не более двух раз, после обновления сохраняй новую пару токенов.
При Content-Type: application/x-www-form-urlencoded в cURL специальные символы client_secret нужно экранировать; redirect_uri экранировать не нужно. При отправке через Postman в режиме x-www-form-urlencoded специальное экранирование не требуется.
API Key действует один год или бессрочно, но автоматически отзывается, если после последнего запроса прошло более 30 дней.
statementDate допускает даты не ранее пяти лет от первого дня текущего года. Одна страница выписки содержит не больше 1000 операций.
externalId платёжного поручения назначает партнёр. Документация требует UUID; в песочнице для каждого нового теста генерируй уникальное значение.
Платёж без digestSignatures сохраняется в начальном статусе и ожидает подписания в Альфа-Бизнес. Для платёжного поручения по собственному счёту можно передать одну или две подписи.
Партнёрский обработчик вебхука рекомендуется завершать не более чем за 300 мс. Если приходит 4xx/5xx, ответ не получен за пять секунд или соединение не установлено, банк повторяет доставку через 30 секунд, 5 и 30 минут, 1, 3, 6, 12, 24, 48 и 72 часа.
Дубли вебхуков по выписке нужно определять по transactionId, по входящим платежам СБП — по nspkTransactionId; на дубликат всё равно возвращай 2xx.
Старые версии endpoint’ов поддерживаются от двух до шести месяцев. Переход на новую версию нужно предварительно тестировать в песочнице.
Сохраняй заголовок ответа x-traceid: при обращении в поддержку банк просит передать X-TraceId вместе с датой, временем, URI, заголовками и телом запроса.

Другие сценарии

Если этого недостаточно — официальная документация: https://developers.alfabank.ru/products/alfa-api/documentation Вся интеграция одним документом: https://mcp-everything.ru/integrations/alfa-bank-api.md