Alfa API: Получать уведомления по операциям

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

Вебхук избавляет от опроса API по выписке или входящим платежам СБП. Сценарий заканчивается активной подпиской и доставкой событий на партнёрский callbackUri.

  1. Реализуй на своей стороне POST {callbackUri}. Метод должен принимать массив событий и возвращать любой код 2xx после успешной обработки.
  2. Убедись, что домен второго уровня callbackUri совпадает с доменом второго уровня redirect_uri интеграции, и заранее предоставь банку сетевой доступ к адресу.
  3. Создай подписку: POST /api/v1/webhooks с нужным object. Для выписки используй ul_transaction_default; для входящих платежей СБП — jp_sbp_incoming_payments.
  4. Проверь подписку: GET /api/v2/webhooks с обязательным object; используй offset и limit для пагинации.
  5. При получении событий устраняй дубли по transactionId для выписки или nspkTransactionId для входящего платежа СБП и всё равно отвечай 2xx на повторное сообщение.
curl -X POST https://baas.alfabank.ru/api/v1/webhooks \
  -H 'Authorization: Bearer {token}' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "object": "ul_transaction_default",
    "data": {
      "accounts": [
        "40702810800000000001",
        "40702810800000000004",
        "40702810800000000007"
      ]
    },
    "callbackUri": "https://webhook.partner.ru/api/v1/webhook-events",
    "version": 1
  }'

Базовые URL

Авторизация

Тип: 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 доступен не для всех продуктов, поэтому проверяй описание конкретного метода.

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

POST /api/v1/webhooks — Создание вебхука

Создаёт подписку на событие. Требует Bearer-токен и scope события.

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

Параметр Где Тип Обяз. Описание
Authorization header string да Bearer {access_token}
Accept header string да application/json
Content-Type header string да application/json
object body string да ul_transaction_default или jp_sbp_incoming_payments
callbackUri body string да URL партнёра для доставки вебхука
version body integer нет Для указанных объектов поддерживается 1
data body object нет Дополнительные параметры подписки
data.accounts body array of string нет Счета для ul_transaction_default; без поля подписка создаётся на все доступные счета

Пример ответа:

{
  "id": "f9f8c674-7a2a-4297-bdb8-ddd3013de3a3",
  "object": "ul_transaction_default",
  "enabled": true,
  "callbackUri": "https://webhook.partner.ru/api/v1/webhook-events",
  "version": 1
}

GET /api/v2/webhooks — Получение списка вебхуков

Возвращает подписки по типу события с пагинацией.

Документация: https://developers.alfabank.ru/products/alfa-api/documentation/articles/webhooks/articles/get-lists-webhooks/v2/get-lists-webhooks

Параметр Где Тип Обяз. Описание
Authorization header string да Bearer {access_token}
Accept header string да application/json
object query string да ul_transaction_default или jp_sbp_incoming_payments
offset query integer нет Смещение в результатах
limit query integer нет Количество элементов

{callbackUri} — Партнёрский метод для получения вебхуков

Метод реализуется партнёром. При успешной обработке должен вернуть любой код 2xx; тело входящего запроса — массив событий.

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

Параметр Где Тип Обяз. Описание
actionType body string да Тип действия с объектом
eventTime body string да Время события
object body string да Тип объекта события
data body object да Данные события
organizationId body string нет Идентификатор организации
sub body string нет Идентификатор пользователя

Нюансы

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

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