B2BH2H

Создание запроса на формирование выписки по счетам других банков

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

transactions

Описание

Метод позволяет создать запрос на формирование выписки по счетам других банков, к которым клиент предоставил доступ в их приложениях, по идентификатору номера расчётного счёта. Метод реализован по стандартам Банка России (версия 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

toBookingDateTime
stringrequired

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

Пример запроса
Язык 
1curl --location 'https://baas.alfabank.ru/api/jp/open-banking/v1.3/external/statements' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--header 'x-fapi-auth-date: Tue, 12 Dec 2025 11:40:21 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: eyJraWQiOiJhbGZhLXRlc3Qtand0IiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ..kY-ZLlq9gtdI4dpxhIeRRnhgqSjtjl9bZFG3YwNK_Mzf4ZbiNdDlqKtBMsJHxsneG33zVEZ9QigSLosxx0m_d3zxkORLDEyqeoX-naDwt1BiXtIqpeDsWZ6RkuPjxBD-9VOuSphE19qWCKcyQRoOoGJjRnfYADC5lbmDDBthlDc5_T4J5mdvvy4-lU-D7q5LexGAR8-FSjvdChPmbp9kOpVAFYgDRttAzYrreoFguP2fQrSPUeQKSSZ3OrtwwHVOWneYzRiRzVATJYHQYNcaflDaCDKIfD6k1FXj2tcDYuBaFaAe6QCBgjrvuis_cyAJjOtXQah5bs-mUUgfoaPlkQ' \
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": "12345678-1234-1234-1234-1234567890AB",
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
stringoptional

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

fromBookingDateTime
stringrequired

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

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": "12345678-1234-1234-1234-1234567890AB",
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

Высокоуровневый текстовый код ошибки

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  "id": "4aca5b0d-1730-416f-a52b-6d353b687082",
4  "message": "Bad Request",
5  "Errors": [
6    {
7      "errorCode": "RU.CBR.Field.Missing",
8      "message": "Обязательное поле, необходимое для API, отсутствует в полезной нагрузке",
9      "path": "Data.Model.Object.filled",
10      "url": "https://example.com/error-description"
11    }
12  ]
13}
Нет тела ответа
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

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

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

Высокоуровневый текстовый код ошибки

id
stringoptional

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

message
stringrequired

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

array of objectsrequired

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

errorCode
stringrequired

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

message
stringrequired

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

path
stringoptional

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

url
stringoptional

URL для помощи в устранении проблемы

Пример ошибки 403 (Forbidden) 
1{
2  "code": "403",
3  "id": "ab41a751-619b-4947-bf0a-251f6e92f599",
4  "message": "Forbidden",
5  "Errors": [
6    {
7      "errorCode": "RU.CBR.Authenticate.InvalidScope",
8      "message": "Предъявленный токен доступа не содержит область действия (scope) необходимый для доступа к ресурсу",
9      "url": "https://example.com/error-description"
10    }
11  ]
12}
Нет тела ответа
Нет тела ответа
Нет тела ответа
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

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

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

Высокоуровневый текстовый код ошибки

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  "id": "af467d1b-985d-4a8e-972e-24a32287085f",
4  "message": "Internal Server Error",
5  "Errors": [
6    {
7      "errorCode": "RU.CBR.UnexpectedError",
8      "message": "Что-то пошло не так на стороне Поставщика услуг",
9      "path": "Data.Model.Object.filled",
10      "url": "https://example.com/error-description"
11    }
12  ]
13}
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

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

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

Высокоуровневый текстовый код ошибки

id
stringoptional

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

message
stringrequired

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

array of objectsrequired

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

errorCode
stringrequired

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

message
stringrequired

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

path
stringoptional

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

url
stringoptional

URL для помощи в устранении проблемы

Пример ошибки 501 (Not Implemented) 
1{
2  "code": "501",
3  "id": "451f7718-2e96-46f0-b286-4b1c8370b87e",
4  "message": "Not Implemented",
5  "Errors": [
6    {
7      "errorCode": "RU.CBR.UnexpectedError",
8      "message": "Данный код ошибки можно использовать при возникновении непредвиденной ошибки",
9      "path": "Data.Model.Object.filled",
10      "url": "https://example.com/error-description"
11    }
12  ]
13}
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

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

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

Высокоуровневый текстовый код ошибки

id
stringoptional

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

message
stringrequired

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

array of objectsrequired

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

errorCode
stringrequired

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

message
stringrequired

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

path
stringoptional

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

url
stringoptional

URL для помощи в устранении проблемы

Пример ошибки 503 (Service Unavailable) 
1{
2  "code": "503",
3  "id": "63a8dddb-b92d-4ac7-82c3-c9a9efb878a5",
4  "message": "Service Unavailable",
5  "Errors": [
6    {
7      "errorCode": "RU.CBR.UnexpectedError",
8      "message": "Сервис временно не доступен",
9      "path": "Data.Model.Object.filled",
10      "url": "https://example.com/error-description"
11    }
12  ]
13}

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

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