Scope
transactions
Описание
Параметры успешного ответа передаются в соответствии с Правилами SWIFT.
Параметры запроса
Возможны два варианта:
- •Bearer {access_token}, полученный по Authorization Code Flow / Authorization Code Flow H2H
- •ApiKey {API Key}, полученный через Портал разработчика
text/plain
Дата исполнения операции в формате YYYY-MM-DD. Допустимы даты не ранее чем 5 лет назад от первого дня текущего года. Например, если сейчас 2026 год, то минимальная дата – 2021-01-01
Количество объектов на одной странице
Количество объектов в списке, которые необходимо пропустить
Номер расчётного счёта
1curl --location --globoff 'https://baas.alfabank.ru/api/jp/v1/accounts/{accountNumber}/transactions/MT940?executeDate={executeDate}&Limit={Limit}&offset={offset}' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: text/plain'Параметры ответа
1:20:: +57610880b621435
2:25:: 40702810701300000761
3:28C:: 1
4:60a:: C220112RUR99527,00 20
5:86:: /BENM//03271643540000095400 INN5752006960.KPP575301001 GAVRILOV ДОБРЫНЯ ТРОФИМОВИЧ /NZP/'(VO21100)' OPLATA PO DOGOVORU
6:62a:: C220113RUR99407,00Референс операции
Номер счёта. Заполняется номером счёта, по которому предоставляется выписка
Номер выписки
Входящий остаток. Составное поле состоит из 4 полей:
- •1-ый символ - знак дебета (отрицательный остаток) / кредита (положительный остаток);
- •2-ой символ - дата;
- •3-ий символ - валюта;
- •4-ый символ - сумма
Строка движения по счёту. Это поле повторяется столько раз, сколько транзакций в выписке. Алгоритм заполнения смотрите во вложенности
Дата валютирования (в формате ISO -ГГMMДД)
Дата проводки (поле не заполняется)
Знак дебета (списание со счёта) / кредита (поступление на счёт)
Код средств (представляет собой третью букву кода валюты)
Сумма
Код типа операции. Заполняется всегда = NTRF
Референс для владельца счёта. Заполняется всегда = NONREF
Референс, обслуживающей счёт финансовой организации (поле не заполняется)
В этом поле указывается номер платежа + Код дебитора + Расширенный код дебитора. Заполняется числовым значением с новой строки
Информация для владельца счёта. Это поле повторяется столько раз, сколько транзакций в выписке. В этом поле содержится дополнительная информация по операции. Для кредитовых операций после кодового слова ORDP указывается значение поле Плательщик (поле 50а из SWIFT MT103), а именно: номер счёта плательщика, ИНН и КПП (если он есть) плательщика и его наименование. Для дебетовых операций после кодового слова BENM указывается значение поле Бенефициар (поле 59 из SWIFT MT103), а именно: номер счёта бенефициара, ИНН и КПП (если он есть) бенефициара и его наименование. Для всех операций после кодового слова NZP указывается информация о платеже из поля 70 платёжных инструкций. Поля разделены между собой пробелами. Алгоритм заполнения для кредитовых операций: /ORDP/ + / + Номер счёта плательщика + знак пробела + INN + Номер ИНН плательщика + . + KPP + Номер КПП плательщика (необязательное) + знак пробела + Наименование плательщика + знак пробела + /NZP/ + информация о платеже из поля 70 платежных инструкций после транслитерации. /BENM/ + / + Номер счёта бенефициара (получателя) + знак пробела + INN + Номер ИНН бенефициара + . + KPP + Номер КПП бенефициара (необязательное) + знак пробела + Наименование бенефициара + знак пробела + /NZP/ + информация о платеже из поля 70 платёжных инструкций после транслитерации
Исходящий остаток (учтённые средства). Данное поле является составным из 4 полей: Знак дебета/кредита + Дата + Валюта + Сумма. Поле заполняется в одну строку, разделительных знаков между значениями нет
1:20:: +57610880b621435
2:25:: 40702810701300000761
3:28C:: 1
4:60a:: C220112RUR99527,00 20
5:86:: /BENM//03271643540000095400 INN5752006960.KPP575301001 GAVRILOV ДОБРЫНЯ ТРОФИМОВИЧ /NZP/'(VO21100)' OPLATA PO DOGOVORU
6:62a:: C220113RUR99407,00Код ошибки. Принимает возможные значения:
- •
invalid_request- неверные входные параметры запроса
Описание ошибки
1{
2 "error": "invalid_request",
3 "error_description": "Authorization header is not present in request headers"
4}Код ошибки. Принимает возможные значения:
- •
invalid_token- предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
Описание ошибки
1{
2 "error": "invalid_token",
3 "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
4}Код ошибки. Принимает возможные значения:
- •
insufficient_scope- у пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope; - •
insufficient_privileges- у пользователя нет прав на просмотр счёта; - •
access_denied- доступ к счёту запрещён
Описание ошибки
1{
2 "error": "insufficient_scope",
3 "error_description": "The request requires higher privileges than provided by the access token"
4}Код ошибки. Принимает возможные значения:
- •
unknown_endpoint- эндпоинт не найден или неактивен
Описание ошибки
1{
2 "error": "unknown_endpoint",
3 "error_description": "Endpoint is not found or not active"
4}Код ошибки. Принимает возможные значения:
- •
internal_error- внутренняя ошибка сервиса при выполнении обработки запроса
Описание ошибки
1{
2 "error": "internal_error",
3 "error_description": "Internal server error"
4}Подпись
Вектор инициализации
Симметричный ключ
Зашифрованное тело ответа
1X-Signature: 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-X-SymmetricKey
2X-InitializationVector: wqM/4CR4UenyqPPZfojfkl1YqxFjWPFUurGiJGtWXJepmigWlyB0qtSn7Pw6EW3sboWNvIAl6UJ5VCRLHY47yZda5hxm07uXToYniNUKp+fvtKgZ3DErlWRoXlZ2aUukCED76dONIs0zCWHHXbwv+LhfIHXhDjJcUXZvf8TQZIKpcKA08GBTqeMYIvFHpSqtGcgh+59HqhoUWgFCkfqxJWS0aUrRgyf3iKGeZ3NbyxLQ1WGHdNlsZ5xRU28ktW7JlvP07sgBYGA7ORmbsAfPaP3SGjR2G1f7xBAzny+Qc8hvDJMW76EIizlbMjPlAW8Lt2Qv9WoMiAoTEjSJ6IdbKQ==
3X-SymmetricKey: lVUEx4SLTqzYCDbUPO9n5s7KwqfHGOeEKVZ+zdi0CvZoE5rScwqAAySLscqCQrgtkn8mD26v9aYFTecQmBFVgmjxL/CX5+AUfBpYVsxFYEpSaklEX9zBQK7nKg/egQQRas7t0bH6+eBHNE/nCfYhua3rwMhZTFZikscNft8/fIBRshv0BzSGM6BT+QCBhKVeCOTouoBCS87UxpMIXlUIfScwB37Mqpfvva9kicfJWMGDfwnOK2IhbdyEBzzrBoT2cBIdjzmkV2ntsprjBm2MYbFUX7/VSJFirLHE5LCHudb24nWjyTJu0uaT5dOyahmwuc/pDvZam8137ou8ov+e2g==
4
5B2XnhB+4w5PZ6AslAt5oRZ24GrkAcuRIjnyGSKniL2uCwCXDqp9qwEa95yQFyYln9/iHY8E1Br8vSSweyr05lslxLeecOLI98aZaYE3mq9v5UuBWxCj+dngKaK0L8H7gC3ycC+OOs3n3U33kmf5lfsdTHePXvhxazkKdvb92QdYfjSVoYgLM7QJnU83r0yiJrKT5N5ZhX7B/E5yg0MJiIYIrmt7FNdj2sJy+nN8iCnWfsYvHF3KP8GZ6e/fca3HQRffgX7XrENg2v+V2E79+JZueck+sAPTEGTO8WTYfmwnOda3TWLyxGk5XoNgdu6908jJbC5JQDPCrH87UpdbF2lwqaxYeNzFQXaKqN9B5h18=Значения параметров ошибок могут изменяться. Рекомендуем предусмотреть стандартную обработку ошибок, не описанных в текущей версии документации.