Scope
beneficiaries
Описание
Метод позволяет получить платёжные реквизиты бенефициара по beneficiaryId.
Параметры запроса
Bearer {access_token}, полученный по Authorization Code Flow H2H
application/json
Идентификатор бенефициара
1curl --location --globoff 'https://baas.alfabank.ru/api/na/jp/v1/beneficiaries/{beneficiaryId}/requisites' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: application/json'
Параметры ответа
1[
2 {
3 "Id": "cba2888c-71ad-4211-9420-a85f6e4c10f9",
4 "type": "ACCOUNT",
5 "pan": "wS7fElYo8VWeJ8KelaJ0XA==",
6 "phoneNumber": "79130000011",
7 "bankId": "012345678910",
8 "accountNumber": "40817810306050000000",
9 "bik": "044525593",
10 "maskedPan": "220015****8276",
11 "keyId": "cba2888c-71ad-4211-9420-a85f6e4c10f9",
12 "isMain": true,
13 "isActive": true
14 }
15]
Идентификатор платёжного реквизита
Тип платёжного реквизита. Принимает возможные значения:
-
•
ACCOUNT- реквизиты счёта; -
•
CARD- номер карты (токен); -
•
PHONE- номер телефона
Токен номера карты. Заполняется при типе реквизитов CARD
Номер телефона. Заполняется при типе реквизитов PHONE
Идентификатор банка контрагента. Заполняется при типе реквизитов PHONE
Номер счёта. Заполняется при типе реквизитов ACCOUNT
БИК банка. Заполняется при типе реквизитов ACCOUNT
Маскированный номер карты
Идентификатор публичного ключа для расшифровки токена номера карты
Признак основного платёжного реквизита. Принимает возможные значения:
-
•
true- основной; -
•
false- неосновной
Признак активности платёжного реквизита. Принимает возможные значения:
-
•
true- активен; -
•
false- деактивирован
1[
2 {
3 "Id": "cba2888c-71ad-4211-9420-a85f6e4c10f9",
4 "type": "ACCOUNT",
5 "pan": "wS7fElYo8VWeJ8KelaJ0XA==",
6 "phoneNumber": "79130000011",
7 "bankId": "012345678910",
8 "accountNumber": "40817810306050000000",
9 "bik": "044525593",
10 "maskedPan": "220015****8276",
11 "keyId": "cba2888c-71ad-4211-9420-a85f6e4c10f9",
12 "isMain": true,
13 "isActive": true
14 }
15]
Код ошибки. Принимает возможные значения:
-
•
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- при запросе кода авторизации не были переданы все необходимые scopes. Необходимо переподписать договор согласия, повторно отправив запрос на получение кода авторизации с указанием всех доступных scopes и параметраprompt=consent
Описание ошибки
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}