Scope
beneficiaries
Описание
Метод позволяет добавить платёжные реквизиты бенефициара по beneficiaryId.
Первые добавленные реквизиты автоматически назначаются основными для бенефициара.
Параметры запроса
Bearer {access_token}, полученный по Authorization Code Flow H2H
application/json
application/json
Идентификатор бенефициара
Идентификатор бенефициара
Тип платёжного реквизита. Возможные значения:
-
•
ACCOUNT- реквизиты счёта; -
•
CARD- номер карты (токен); -
•
PHONE- номер телефона
Токен номера карты. Поле обязательно при типе реквизитов CARD. Как сформировать токен номера карты
Номер телефона. Поле обязательно при типе реквизитов PHONE
Идентификатор банка контрагента. Поле обязательно при типе реквизитов PHONE
Номер счёта. Поле обязательно при типе реквизитов ACCOUNT
БИК банка. Поле обязательно при типе реквизитов ACCOUNT
Тип контрагента
ИНН организации или физического лица
КПП организации (только для юридических лиц)
Признак основных платёжных реквизитов бенефициара. По умолчанию для первых добавленных реквизитов - true, для следующих - false
Электронная подпись УЛ клиента
Значение электронной подписи, закодированное в Base64
Тип электронной подписи. Возможные значения:
-
•
RSA- RSA; -
•
KEP- КЭП
1curl --location --globoff 'https://baas.alfabank.ru/api/na/jp/v1/beneficiaries/{beneficiaryId}/requisites' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--data '{
6 "beneficiaryId": "ab9cbb96-360a-4462-a683-955cc29f7f54",
7 "type": "ACCOUNT",
8 "pan": "wS7fElYo8VWeJ8KelaJ0XA==",
9 "phoneNumber": "79130000011",
10 "bankId": "012345678910",
11 "accountNumber": "40817810306050000000",
12 "bik": "044525593",
13 "name": "ООО Ромашка",
14 "inn": "1234567890",
15 "kpp": "123456789",
16 "isMain": true,
17 "digestSignatures": [
18 {
19 "base64Encoded": "SEwHwYDVQQDExhDUllQVE8tUFJPIFRlc3QgQ2VudGVyIDICExIAVH4YMX0u3fEONSkAAQBUfhgwCgYIKoUDBwEBAQEEQBU0EntPGWz8EfJ5CFL2m10xeBrkAEeWDglGQDZWLKQ0ff4TyBT9X1NhG/+ETj4TcQhExy6k+WZ9w/CpF5FjyyA=",
20 "signatureType": "RSA"
21 }
22 ]
23}'Параметры ответа
1{
2 "id": "ab9cbb96-360a-4462-a683-955cc29f7f54",
3 "isMain": true,
4 "isActive": true
5}Идентификатор платёжного реквизита
Признак основного платёжного реквизита. Принимает возможные значения:
-
•
true- основной; -
•
false- неосновной
Признак активности платёжного реквизита. Принимает возможные значения:
-
•
true- активен; -
•
false- деактивирован
1{
2 "id": "ab9cbb96-360a-4462-a683-955cc29f7f54",
3 "isMain": true,
4 "isActive": true
5}Код ошибки. Принимает возможные значения:
-
•
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}