Skip to main content

Изменить данные бенефициара

/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}

PUT

https://secured-openapi.tbank.ru/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}

Метод полностью изменяет данные бенефициара по его ID.

Ограничение на использование метода — 10 запросов в секунду.

Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manageУправление номинальными счетами.

Авторизация

Security

Bearer API Token

Запрос

Path parameters

Required

beneficiaryId

String<uuid>

Идентификатор бенефициара.

Request body schema application/json

oneOf

Required

type

String

Requirements: [FL_RESIDENT, FL_NONRESIDENT, UL_RESIDENT, UL_NONRESIDENT, IP_RESIDENT, IP_NONRESIDENT, LITE_CONTACT]

Тип бенефициара:

  • FL_RESIDENT — физическое лицо, резидент.
  • FL_NONRESIDENT — физическое лицо, нерезидент.
  • UL_RESIDENT — юридическое лицо, резидент.
  • UL_NONRESIDENT — юридическое лицо, нерезидент.
  • IP_RESIDENT — ИП, резидент.
  • IP_NONRESIDENT — ИП, нерезидент.
  • LITE_CONTACT — легкий контакт.

Required

firstName

String

Имя.

middleName

String

Отчество.

Required

lastName

String

Фамилия.

Required

isSelfEmployed

Boolean

Самозанятый.

Required

birthDate

String<date>

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

birthPlace

String

Место рождения.

Required

citizenship

String

Requirements: Value must match regular expression ^([A-Z]{2})$

Гражданство. Код страны в формате ISO 3166-1 alpha-2.

phoneNumber

String

Requirements: Value must match regular expression ^((\+[0-9])([0-9]){6,14})$

Номер телефона. phoneNumber или email обязателен к заполнению.

email

String

Электронная почта. phoneNumber или email обязателен к заполнению.

Required

documents

Array of objects ()

Requirements: >= 1 items

Документы. Обязательно — минимум 2.

В большинстве случаев основной документ нерезидента РФ — FOREIGN_PASSPORT. Второй документ — любой из документов, подтверждающих право на пребывание в РФ. Подробнее о документах.

Для нерезидентов с гражданством BY достаточно одного документа с типом FOREIGN_PASSPORT.

oneOf

Required

type

String

Requirements: [PASSPORT, FOREIGN_PASSPORT, FOREIGN_PASSPORT_OF_FOREIGN_CITIZENS, OFFICIAL_PASSPORT, DIPLOMATIC_PASSPORT, MIGRATION_CARD, TEMPORARY_RESIDENCE_PERMIT, VISA, RESIDENCE_PERMIT, CONTRACT, CONTRACT_GPD, PATENT]

Тип документа.

Required

number

String

Номер документа.

Required

date

String<date>

Дата выдачи.

expireDate

String<date>

Дата истечения.

Required

addresses

Array of objects ()

Requirements: >= 1 items

Адреса.

Required

type

String

Requirements: [POSTAL_ADDRESS, REGISTRATION_ADDRESS, RESIDENCE_ADDRESS, LEGAL_ENTITY_ADDRESS, OFFICE_OF_FOREIGN_LEGAL_ENTITY_ADDRESS]

Тип адреса. Для типов FL_RESIDENT, FL_NONRESIDENT, IP_RESIDENT, IP_NONRESIDENT обязателен один из адресов:

  • REGISTRATION_ADDRESS — адрес регистрации по месту жительства;
  • RESIDENCE_ADDRESS — адрес регистрации по месту пребывания.

Для типов UL_RESIDENT, UL_NONRESIDENT обязательно передавать LEGAL_ENTITY_ADDRESS — адрес юридического лица.

Required

address

String

Requirements: <= 256 characters

Адрес.

inn

String

Requirements: Value must match regular expression ^(\d{12})$

ИНН.

Ответ

200

OK

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Пример запроса

Payload

cURL

Go

Java

NodeJs

PHP

Python

Content type

application/json

Физическое лицо, резидент

Физическое лицо, нерезидент

Юридическое лицо, резидент

Юридическое лицо, нерезидент

ИП, резидент

ИП, нерезидент

Легкий контакт

{

"type":

"FL_RESIDENT",

"firstName":

"Фома",

"middleName":

"Семенович",

"lastName":

"Киняев",

"isSelfEmployed":

true,

"birthDate":

"1969-08-21",

"birthPlace":

"г. Москва",

"citizenship":

"RU",

"phoneNumber":

"+79998887766",

"email":

"f.kiniaev@tbank.ru",

"documents": [
{ ... }

"type":

"PASSPORT",

"serial":

"5000",

"number":

"287846",

"date":

"1998-01-01",

"organization":

"Отделом УФМС по всем городам всех областей необъятной нашей Родины",

"division":

"123-456"

}
],
"addresses": [
{

"type":

"REGISTRATION_ADDRESS",

"address":

"127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"

}
],

"inn":

"266445718640",

"snils":

"72865174431"

}

Пример ответа

200
400
401
403
422
429
500

Content type

application/json

Физическое лицо, резидент

Физическое лицо, нерезидент

Юридическое лицо, резидент

Юридическое лицо, нерезидент

ИП, резидент

ИП, нерезидент

Легкий контакт

{

"beneficiaryId":

"61f656e0-0a86-4ec2-bd43-232499f7ad66",

"type":

"FL_RESIDENT",

"firstName":

"Фома",

"middleName":

"Семенович",

"lastName":

"Киняев",

"isSelfEmployed":

true,

"birthDate":

"1969-08-21",

"birthPlace":

"г. Москва",

"citizenship":

"RU",

"phoneNumber":

"+79998887766",

"email":

"f.kiniaev@tbank.ru",

"documents": [
{ ... }

"type":

"PASSPORT",

"serial":

"5000",

"number":

"287846",

"date":

"1998-01-01",

"organization":

"Отделом УФМС по всем городам всех областей необъятной нашей Родины",

"division":

"123-456"

}
],
"addresses": [
{

"type":

"REGISTRATION_ADDRESS",

"address":

"127287, г. Москва, ул. 2-я Хуторская, д. 38А, стр. 26"

}
],

"inn":

"266445718640",

"snils":

"72865174431"

}

openapi@tbank.ru

АО «ТБанк» использует файлы «cookie» с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.