B2BH2H

Создание запроса на формирование выписки

Песочница
POST https://sandbox.alfabank.ru/api/jp/open-banking/v1.3/statements
Пром
POST https://baas.alfabank.ru/api/jp/open-banking/v1.3/statements
Scope

accounts

Описание

Метод позволяет создать запрос на формирование выписки по стандартам Банка России (версия 1.3.3le) по идентификатору номера расчётного счёта.

Параметры запроса
HEADERS
Атрибут
Описание
Authorization
stringrequired
Accept
stringrequired

application/json

Content-Type
stringrequired

application/json

x-fapi-auth-date
stringoptional

Время последнего входа Пользователя в систему с TPP. Значение предоставляется в виде HTTP-date, как в разделе 7.1.1.1 [RFC7231]

x-fapi-customer-ip-address
stringoptional

IP-адрес пользователя. Указывается, если пользователь в данный момент авторизован в приложении партнёра

x-fapi-interaction-id
stringrequired

RFC4122 UID, используемый в качестве идентификатора корреляции

x-idempotency-key
stringrequired

Уникальный идентификатор запроса для поддержки идемпотентности

x-jws-signature
stringrequired

Отделяемая подпись полезной нагрузки в формате JWS

x-customer-user-agent
stringoptional

Тип устройства (user-agent), которое использует пользователь

BODY
Атрибут
Описание
objectrequired

Полезная нагрузка запроса

objectrequired

Данные для формирования выписки

accountId
stringrequired
fromBookingDateTime
stringrequired

Дата и время начала расчётов, представленных в выписке, в формате YYYY-MM-DDThh:mm:ss±hh:mm. Глубина выписки ограничена 30 календарными днями.

  • •
    Глубина выписки ограничена 30 календарными днями.
  • •
    Допустимы даты не ранее чем 5 лет назад от первого дня текущего года. Например, если сейчас 2026 год, то минимальная дата - 2021-01-01
toBookingDateTime
stringrequired

Дата и время окончания расчётов, представленных в выписке, в формате YYYY-MM-DDThh:mm:ss±hh:mm. Глубина выписки ограничена 30 календарными днями

Пример запроса
Язык 
1curl --location 'https://baas.alfabank.ru/api/jp/open-banking/v1.3/statements' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--header 'x-fapi-auth-date: Mon, 26 Aug 2019 12:23:11 GMT' \
6--header 'x-fapi-customer-ip-address: 172.123.123.123' \
7--header 'x-fapi-interaction-id: 97ed4827-7b6f-4491-a06f-b548d5a7512d' \
8--header 'x-idempotency-key: 8e03978e-40d5-43e8-bc93-6894a57f9324' \
9--header 'x-jws-signature: eyJhbGciOiJSUzI1NiIsImtpZCI6IjYxMDAwMzYzY2NiNzU5Y2I0NDg2MDc4NjVkMDAwMTAwMDM2M2NjIn0..ApKNzZ9kLMtBY3LzReSHQ7_AyDnzocGo9GTQFRmxTiRS7Lj7a55Kr4ziwZAmmwloF1063JJMOaU0lS947q6_hSct9pxzPdZ9tTmpIDGnQL-ks0oB7zz9vUSUd3G00UZXSYnuhI9BBRXvmmTaue5Y2j5zVZofLdO2dqPWCnsQULyLn_vYf8PeABhnAQ29z1Bq42uxfRFTM35cF40Tp4VBSqXDI1vxfleLusQlOZM-5Sk7O3Vy4Sf-UB03RrRGSBerZjdoMRh7dgEyoYAXS6c4MejCm2vmXKqSd7pu2V2TxOM9UTchkCS16DL-RIJtnfMjznmznU5SoMCpncvs6gRNeQ' \
10--header 'x-customer-user-agent: mobile' \
11--data '{
12  "Data": {
13    "Statement": {
14      "accountId": "12345678-1234-1234-1234-1234567890AB",
15      "fromBookingDateTime": "2025-12-02T11:40:21+00:00",
16      "toBookingDateTime": "2025-12-03T11:40:21+00:00"
17    }
18  }
19}'
Параметры ответа
Пример ответа 201 (Created) 
1{
2  "Data": {
3    "Statement": {
4      "statementId": "9b23e27e-f4f8-4cab-9b80-aaa008d4330c",
5      "accountId": "95791e79-0f2d-47de-a5e0-df034b285XXx",
6      "fromBookingDateTime": "2025-12-02T11:40:21+00:00",
7      "toBookingDateTime": "2025-12-03T11:40:21+00:00"
8    }
9  },
10  "Links": {
11    "self": "https://sb.example.ru/v1.3/example"
12  },
13  "Meta": {
14    "totalPages": 1
15  }
16}
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

RFC4122 UID, используемый в качестве идентификатора корреляции

x-jws-signature
stringrequired

Отделяемая подпись полезной нагрузки в формате JWS

BODY
атрибут
описание
objectrequired

Полезная нагрузка ответа

objectrequired

Данные для формирования выписки

statementId
stringrequired

Идентификатор выписки

accountId
stringrequired

Идентификатор номера расчётного счёта

fromBookingDateTime
stringrequired

Дата и время начала расчётов, представленных в выписке, в формате YYYY-MM-DDThh:mm:ss±hh:mm

toBookingDateTime
stringrequired

Дата и время окончания расчётов, представленных в выписке, в формате YYYY-MM-DDThh:mm:ss±hh:mm

objectoptional

Раздел для указания ссылок

self
stringrequired

Текущая ссылка

first
stringoptional

Первая ссылка

prev
stringoptional

Предыдущая ссылка

next
stringoptional

Следующая ссылка

last
stringoptional

Последняя ссылка

objectoptional

Раздел метаданных

totalPages
integeroptional

Количество передаваемых страниц

Пример ответа 201 (Created) 
1{
2  "Data": {
3    "Statement": {
4      "statementId": "9b23e27e-f4f8-4cab-9b80-aaa008d4330c",
5      "accountId": "95791e79-0f2d-47de-a5e0-df034b285XXx",
6      "fromBookingDateTime": "2025-12-02T11:40:21+00:00",
7      "toBookingDateTime": "2025-12-03T11:40:21+00:00"
8    }
9  },
10  "Links": {
11    "self": "https://sb.example.ru/v1.3/example"
12  },
13  "Meta": {
14    "totalPages": 1
15  }
16}
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

RFC4122 UID, используемый в качестве идентификатора корреляции

BODY
атрибут
описание
code
stringrequired

HTTP-код ошибки

id
stringoptional

Уникальный идентификатор ошибки

message
stringrequired

Краткое сообщение об ошибке

array of objectsrequired

Детализация ошибки

errorCode
stringrequired

Низкоуровневое описание ошибки

message
stringrequired

Описание ошибки

path
stringoptional

Путь к элементу с ошибкой в JSON-объекте

url
stringoptional

URL для помощи в устранении проблемы / предоставления дополнительной информации

Пример ошибки 400 (Bad Request) 
1{
2  "code": "400",
3  "message": "Bad Request",
4  "Errors": [
5    {
6      "errorCode": "RU.CBR.Field.Missing",
7      "message": "Parameter \"accountId\" is not valid. Length must be 20 characters",
8      "path": "accountId"
9    }
10  ]
11}
Нет тела ответа
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

RFC4122 UID, используемый в качестве идентификатора корреляции

BODY
атрибут
описание
code
stringrequired

HTTP-код ошибки

id
stringoptional

Уникальный идентификатор ошибки

message
stringrequired

Краткое сообщение об ошибке

array of objectsrequired

Детализация ошибки

errorCode
stringrequired

Низкоуровневое описание ошибки

message
stringrequired

Описание ошибки

path
stringoptional

Путь к элементу с ошибкой в JSON-объекте

url
stringoptional

URL для помощи в устранении проблемы / предоставления дополнительной информации

Пример ошибки 403 (Forbidden) 
1{
2  "code": "403",
3  "message": "Forbidden",
4  "Errors": [
5    {
6      "errorCode": "RU.CBR.Authenticate.InvalidConsent",
7      "message": "The user does not have rights to view the account statement {accountId}"
8    }
9  ]
10}
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

RFC4122 UID, используемый в качестве идентификатора корреляции

BODY
атрибут
описание
code
stringrequired

HTTP-код ошибки

message
stringrequired

Краткое сообщение об ошибке

array of objectsrequired

Детализация ошибки

errorCode
stringrequired

Низкоуровневое описание ошибки

message
stringrequired

Описание ошибки

path
stringoptional

Путь к элементу с ошибкой в JSON-объекте

url
stringoptional

URL для помощи в устранении проблемы / предоставления дополнительной информации

Пример ошибки 404 (Not Found) 
1{
2  "code": "404",
3  "message": "Not found",
4  "Errors": [
5    {
6      "errorCode": "RU.CBR.Resource.NotFound",
7      "message": "Endpoint is not found or not active"
8    }
9  ]
10}
Нет тела ответа
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

RFC4122 UID, используемый в качестве идентификатора корреляции

BODY
атрибут
описание
code
stringrequired

HTTP-код ошибки

id
stringoptional

Уникальный идентификатор ошибки

message
stringrequired

Краткое сообщение об ошибке

array of objectsrequired

Детализация ошибки

errorCode
stringrequired

Низкоуровневое описание ошибки

message
stringrequired

Описание ошибки

path
stringoptional

Путь к элементу с ошибкой в JSON-объекте

url
stringoptional

URL для помощи в устранении проблемы / предоставления дополнительной информации

Пример ошибки 500 (Internal Server Error) 
1{
2  "code": "500",
3  "message": "Internal Server Error",
4  "Errors": [
5    {
6      "errorCode": "RU.CBR.UnexpectedError",
7      "message": "Internal server error"
8    }
9  ]
10}

Отправьте письмо на alfa_api@alfabank.ru, указав следующие данные:

  1. 1.
    client_id.
  2. 2.
    Дата и время запроса с указанием часового пояса.
  3. 3.
    Метод и URI запроса.
  4. 4.
    Заголовки и тело запроса.
  5. 5.
    Полученная ошибка и заголовки ответа, включая X-TraceId.
  6. 6.
    IP-адрес, с которого был отправлен запрос.
Как получить выписку асинхронноПолучение выписки по идентификатору