Изменить данные бенефициара
https://secured-openapi.tbank.ru/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}
Метод полностью изменяет данные бенефициара по его ID.
Ограничение на использование метода — 10 запросов в секунду.
Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage
— Управление номинальными счетами
.
Запрос
Path parameters
Required
beneficiaryId
String<uuid>
Идентификатор бенефициара.
Request body schema application/json
- BeneficiaryFlNonresidentRequest
- BeneficiaryFlResidentRequest
- BeneficiaryIpNonresidentRequest
- BeneficiaryIpResidentRequest
- BeneficiaryLiteContactRequest
- BeneficiaryUlNonresidentRequest
- BeneficiaryUlResidentRequest
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 обязателен к заполнению.
String
Электронная почта. phoneNumber или email обязателен к заполнению.
Required
documents
Array of objects ()
Requirements: >= 1 items
Документы. Обязательно — минимум 2.
В большинстве случаев основной документ нерезидента РФ — FOREIGN_PASSPORT
. Второй документ — любой из документов, подтверждающих право на пребывание в РФ. Подробнее о документах.
Для нерезидентов с гражданством BY достаточно одного документа с типом FOREIGN_PASSPORT
.
Required
documents
Array of objects ()
Requirements: >= 1 items
Документы. Обязательно — минимум 2.
В большинстве случаев основной документ нерезидента РФ — FOREIGN_PASSPORT
. Второй документ — любой из документов, подтверждающих право на пребывание в РФ. Подробнее о документах.
Для нерезидентов с гражданством BY достаточно одного документа с типом FOREIGN_PASSPORT
.
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса.
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса.
inn
String
Requirements: Value must match regular expression ^(\d{12})$
ИНН.
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})$
Номер телефона. Номер телефона или электронная почта обязательны к заполнению.
String
Электронная почта. Номер телефона или электронная почта обязательны к заполнению.
Required
documents
Array of objects ()
Requirements: >= 1 items
Документы. Обязательный тип для физического лица-резидента — PASSPORT
.
Required
documents
Array of objects ()
Requirements: >= 1 items
Документы. Обязательный тип для физического лица-резидента — PASSPORT
.
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса
inn
String
Requirements: Value must match regular expression ^(\d{12})$
ИНН
snils
String
Requirements: Value must match regular expression ^(\d{11})$
СНИЛС
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
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 обязателен к заполнению.
String
Электронная почта. phoneNumber или email обязателен к заполнению.
Required
documents
Array of objects ()
Requirements: >= 1 items
Документы. Обязательно — минимум 2 документа. Основной документ нерезидента РФ в большинстве случаев — FOREIGN_PASSPORT
. Второй документ — любой из документов, подтверждающих право на пребывание в РФ. Подробнее о документах.
Для нерезидентов с гражданством BY достаточно 1 документа с типом FOREIGN_PASSPORT
Required
documents
Array of objects ()
Requirements: >= 1 items
Документы. Обязательно — минимум 2 документа. Основной документ нерезидента РФ в большинстве случаев — FOREIGN_PASSPORT
. Второй документ — любой из документов, подтверждающих право на пребывание в РФ. Подробнее о документах.
Для нерезидентов с гражданством BY достаточно 1 документа с типом FOREIGN_PASSPORT
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса.
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса.
Required
registrationDate
String<date>
Дата регистрации.
Required
inn
String
Requirements: Value must match regular expression ^(\d{12})$
ИНН.
ogrn
String
Requirements: Value must match regular expression ^(\d{15})$
Основной государственный регистрационный номер.
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
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 обязателен к заполнению.
String
Электронная почта. phoneNumber или email обязателен к заполнению.
Required
documents
Array of objects ()
Requirements: >= 1 items
Документы. Для ИП резидента обязателен тип PASSPORT.
Required
documents
Array of objects ()
Requirements: >= 1 items
Документы. Для ИП резидента обязателен тип PASSPORT.
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса.
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса.
Required
registrationDate
String<date>
Дата регистрации.
Required
inn
String
Requirements: Value must match regular expression ^(\d{12})$
ИНН.
ogrn
String
Requirements: Value must match regular expression ^(\d{15})$
Основной государственный регистрационный номер.
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
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
name
String
Наименование организации.
phoneNumber
String
Requirements: Value must match regular expression ^((\+[0-9])([0-9]){6,14})$
Номер телефона. phoneNumber или email обязателен к заполнению.
String
Электронная почта. phoneNumber или email обязателен к заполнению.
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса.
Required
addresses
Array of objects ()
Requirements: >= 1 items
Адреса.
nza
String
Номер записи об аккредитации.
Required
registrationDate
String<date>
Дата регистрации.
Required
registrationNumber
String
Номер регистрации.
opf
String
Организационно-правовая форма.
inn
String
Requirements: Value must match regular expression ^(\d{10})$
ИНН.
kio
String
Код иностранной организации. Обязателен, если ИНН не задан.
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
— легкий контакт.
name
String
Наименование организации.
phoneNumber
String
Requirements: Value must match regular expression ^((\+[0-9])([0-9]){6,14})$
Номер телефона. phoneNumber или email обязателен к заполнению.
String
Электронная почта. phoneNumber или email обязателен к заполнению.
addresses
Array of objects ()
Адреса.
addresses
Array of objects ()
Адреса.
registrationDate
String<date>
Дата регистрации.
opf
String
Организационно-правовая форма.
Required
inn
String
Requirements: Value must match regular expression ^(\d{10})$
ИНН.
ogrn
String
Requirements: Value must match regular expression ^(\d{13})$
Основной государственный регистрационный номер.
Ответ
Это полезный материал?
Пример запроса
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"
}
Пример ответа
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"
}