B2BH2H

Получение списка счетов других банков по стандартам Банка России

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

transactions

Описание

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

Параметры запроса
HEADERS
Атрибут
Описание
Authorization
stringrequired
Accept
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-customer-user-agent
stringoptional

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

QUERY
Атрибут
Описание
page
integeroptional

Номер страницы

Пример запроса
Язык 
1curl --location --globoff 'https://baas.alfabank.ru/api/jp/open-banking/v1.3/external/accounts?page={page}' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: application/json' \
4--header 'x-fapi-auth-date: Tue, 12 Dec 2025 11:40:21 GMT' \
5--header 'x-fapi-customer-ip-address: 172.123.123.123' \
6--header 'x-fapi-interaction-id: 97ed4827-7b6f-4491-a06f-b548d5a7512d' \
7--header 'x-customer-user-agent: mobile'
Параметры ответа
Пример ответа 200 (OK) 
1{
2  "Data": {
3    "Account": [
4      {
5        "accountId": "12345678-1234-1234-1234-1234567890AB",
6        "status": "Enabled",
7        "currency": "RUR",
8        "accountType": "Business",
9        "AccountDetails": [
10          {
11            "name": "Основной счет",
12            "schemeName": "RU.CBR.BBAN",
13            "identification": "40817810621234570000"
14          }
15        ],
16        "Owner": {
17          "name": "Полное наименование Орг № 54717",
18          "Identification": [
19            {
20              "schemeName": "RU.CBR.TXID",
21              "identification": "0179909084"
22            }
23          ]
24        }
25      },
26      {
27        "accountId": "375916fb-351a-44b4-a9bc-2f9d60f4553d",
28        "status": "Enabled",
29        "currency": "RUR",
30        "accountType": "Business",
31        "AccountDetails": [
32          {
33            "name": "Основной счет",
34            "schemeName": "RU.CBR.BBAN",
35            "identification": "40817810621234570022"
36          }
37        ],
38        "Owner": {
39          "name": "Полное наименование Орг № 54717",
40          "Identification": [
41            {
42              "schemeName": "RU.CBR.TXID",
43              "identification": "0179909084"
44            }
45          ]
46        }
47      },
48      {
49        "accountId": "c3744069-1f3b-4b40-aa45-4cfb54abefc0",
50        "status": "Enabled",
51        "currency": "RUR",
52        "accountType": "Business",
53        "AccountDetails": [
54          {
55            "name": "Основной счет",
56            "schemeName": "RU.CBR.BBAN",
57            "identification": "40817810621234570033"
58          }
59        ],
60        "Owner": {
61          "name": "Полное наименование Орг № 54717",
62          "Identification": [
63            {
64              "schemeName": "RU.CBR.TXID",
65              "identification": "0179909084"
66            }
67          ]
68        }
69      }
70    ]
71  },
72  "Links": {
73    "self": "https://partner.ru/open-banking/v1/external/accounts"
74  },
75  "Meta": {
76    "totalPages": 1
77  }
78}
HEADERS
Атрибут
Описание
x-fapi-interaction-id
stringrequired

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

x-jws-signature
stringrequired

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

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

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

array of objectsoptional

Список счетов

accountId
stringrequired

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

status
stringrequired

Статус счёта в форме кода. Принимает возможные значения:

  • •
    Enabled - счёт доступен и может использоваться;
  • •
    Disabled - счет недоступен и не может использоваться, временно или навсегда;
  • •
    Deleted - счёт удалён и не может использоваться
statusUpdateDateTime
stringoptional

Дата и время изменения статуса счёта

currency
stringrequired

Валюта ведения счёта

accountType
stringrequired

Тип счёта. Принимает возможные значения:

  • •
    Business - счёт юридического лица
accountDescription
stringrequired

Краткое описание назначения счёта или продукта, привязанного к счёту

array of objectsoptional

Идентификация счёта

name
stringoptional

Наименование счёта, присвоенное учреждением, обслуживающим счёт, по согласованию с владельцем счёта

schemeName
stringrequired

Схема идентификации счёта. Принимает возможные значения:

  • •
    RU.CBR.BBAN - базовый номер банковского счёта;
  • •
    RU.CBR.EPID - идентификатор электронного средства платежа;
  • •
    RU.CBR.PAN - идентификатор счёта по номеру карты;
  • •
    RU.CBR.MTEL - идентификатор счёта по номеру телефона;
  • •
    RU.CBR.ORID - иной идентификатор (номер, однозначно идентифицирующий счёт стороны)
identification
stringrequired

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

objectoptional

Информация о владельце счёта

name
stringrequired

Наименование организации

mobileNumber
stringoptional

Номер мобильного телефона

countryOfResidence
stringoptional

Страна проживания

countryOfBirth
stringoptional

Место рождения (страна)

provinceOfBirth
stringoptional

Место рождения (область)

cityOfBirth
stringoptional

Место рождения (город)

birthDate
stringoptional

Дата рождения

array of objectsrequired

Идентификация физического лица

schemeName
stringrequired

Схема идентификации юридического или физического лица. Принимает возможные значения:

  • •
    RU.CBR.TXID - ИНН/КИО;
  • •
    RU.CBR.LEI - код организации в соответствии с ISO 17442;
  • •
    RU.CBR.PASP - номер паспорта;
  • •
    RU.CBR.CLID - другой идентификатор;
  • •
    RU.CBR.QRST - идентификатор в виде QR-кода;
  • •
    RU.CBR.TAXT - КПП;
  • •
    RU.CBR.OGRN - ОГРН;
  • •
    RU.CBR.SNILS - СНИЛС;
  • •
    RU.CBR.PAN - идентификатор платёжной карты;
  • •
    RU.CBR.MTEL - номер мобильного телефона;
  • •
    RU.CBR.BBAN - идентификатор банковского счёта
identification
stringrequired

Идентификатор участника

objectoptional

Почтовый адрес

addressType
stringoptional

Тип адреса. Принимает возможные значения:

  • •
    Business - адрес, указанный в едином государственном реестре юридических лиц;
  • •
    Correspondence - адрес для корреспонденции;
  • •
    DeliveryTo - адрес доставки;
  • •
    MailTo - почтовый ящик;
  • •
    POBox - абонентский ящик;
  • •
    Postal - фактический/почтовый адрес местонахождения юридического лица;
  • •
    Residential - адрес постоянной регистрации физического лица (прописка);
  • •
    Statement - адрес временной регистрации физического лица (регистрация временного пребывания)
addressLine
array of stringsoptional

Строка адреса

streetName
stringoptional

Наименование улицы или проспекта

buildingNumber
stringoptional

Номер, который определяет положение здания на улице

postCode
stringoptional

Почтовый индекс

townName
stringoptional

Наименование населённого пункта или территории, находящейся вне границ поселений

countrySubDivision
stringoptional

Наименование и тип субъекта Российской Федерации

country
stringoptional

Название страны в кодированной форме

objectoptional

Банк, обслуживающий счёт

name
stringrequired

Наименование организации

array of objectsrequired

Идентификация финансового учреждения

schemeName
stringrequired

Схема идентификации финансового учреждения. Принимает возможные значения:

  • •
    RU.CBR.BICFI - BIC для финансовых учреждений согласно ISO 9362;
  • •
    RU.CBR.BIC - уникальный идентификатор банка, используемый в платёжных документах на территории Российской Федерации
identification
stringrequired

Идентификатор финансового учреждения

array of objectsoptional

Идентификация юридического лица

schemeName
stringrequired

Схема идентификации физического или юридического лица. Принимает возможные значения:

  • •
    RU.CBR.TXID - ИНН/КИО;
  • •
    RU.CBR.LEI - код организации в соответствии с ISO 17442;
  • •
    RU.CBR.TAXT - КПП;
  • •
    RU.CBR.OGRN - ОГРН;
  • •
    RU.CBR.OKPO - ОКПО
identification
stringrequired

Идентификатор участника

objectoptional

Корреспондентский счёт

schemeName
stringrequired

Схема идентификации корреспондентского счёта. Принимает возможные значения:

  • •
    RU.CBR.BBAN - базовый номер банковского счёта;
  • •
    RU.CBR.EPID - идентификатор электронного средства платежа;
  • •
    RU.CBR.PAN - идентификатор счёта по номеру карты;
  • •
    RU.CBR.MTEL - идентификатор счёта по номеру телефона;
  • •
    RU.CBR.ORID - иной идентификатор (номер, однозначно идентифицирующий счёт стороны)
identification
stringrequired

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

objectoptional

Почтовый адрес

addressType
stringoptional

Тип адреса. Принимает возможные значения:

  • •
    Business - адрес, указанный в едином государственном реестре юридических лиц;
  • •
    Correspondence - адрес для корреспонденции;
  • •
    DeliveryTo - адрес доставки;
  • •
    MailTo - почтовый ящик;
  • •
    POBox - абонентский ящик;
  • •
    Postal - фактический/почтовый адрес местонахождения юридического лица;
  • •
    Residential - адрес постоянной регистрации физического лица (прописка);
  • •
    Statement - адрес временной регистрации физического лица (регистрация временного пребывания)
addressLine
array of stringsoptional

Строка адреса

streetName
stringoptional

Наименование улицы или проспекта

buildingNumber
stringoptional

Номер, который определяет положение здания на улице

postCode
stringoptional

Почтовый индекс

townName
stringoptional

Наименование населённого пункта или территории, находящейся вне границ поселений

countrySubDivision
stringoptional

Наименование и тип субъекта Российской Федерации

country
stringoptional

Название страны в кодированной форме

objectoptional

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

self
stringrequired

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

first
stringoptional

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

prev
stringoptional

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

next
stringoptional

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

last
stringoptional

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

objectoptional

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

totalPages
integeroptional

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

Пример ответа 200 (OK) 
1{
2  "Data": {
3    "Account": [
4      {
5        "accountId": "12345678-1234-1234-1234-1234567890AB",
6        "status": "Enabled",
7        "currency": "RUR",
8        "accountType": "Business",
9        "AccountDetails": [
10          {
11            "name": "Основной счет",
12            "schemeName": "RU.CBR.BBAN",
13            "identification": "40817810621234570000"
14          }
15        ],
16        "Owner": {
17          "name": "Полное наименование Орг № 54717",
18          "Identification": [
19            {
20              "schemeName": "RU.CBR.TXID",
21              "identification": "0179909084"
22            }
23          ]
24        }
25      },
26      {
27        "accountId": "375916fb-351a-44b4-a9bc-2f9d60f4553d",
28        "status": "Enabled",
29        "currency": "RUR",
30        "accountType": "Business",
31        "AccountDetails": [
32          {
33            "name": "Основной счет",
34            "schemeName": "RU.CBR.BBAN",
35            "identification": "40817810621234570022"
36          }
37        ],
38        "Owner": {
39          "name": "Полное наименование Орг № 54717",
40          "Identification": [
41            {
42              "schemeName": "RU.CBR.TXID",
43              "identification": "0179909084"
44            }
45          ]
46        }
47      },
48      {
49        "accountId": "c3744069-1f3b-4b40-aa45-4cfb54abefc0",
50        "status": "Enabled",
51        "currency": "RUR",
52        "accountType": "Business",
53        "AccountDetails": [
54          {
55            "name": "Основной счет",
56            "schemeName": "RU.CBR.BBAN",
57            "identification": "40817810621234570033"
58          }
59        ],
60        "Owner": {
61          "name": "Полное наименование Орг № 54717",
62          "Identification": [
63            {
64              "schemeName": "RU.CBR.TXID",
65              "identification": "0179909084"
66            }
67          ]
68        }
69      }
70    ]
71  },
72  "Links": {
73    "self": "https://partner.ru/open-banking/v1/external/accounts"
74  },
75  "Meta": {
76    "totalPages": 1
77  }
78}
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-адрес, с которого был отправлен запрос.
Получение выписки по идентификаторуКак асинхронно получить выписку по счетам других банков