Перейти к основному содержимому

Создать полную заявку

/api/v1/credit-products/{brokerId}/applications/full

POST

https://secured-openapi.tbank.ru/api/v1/credit-products/{brokerId}/applications/full

Метод для создания заявки на кредитный продукт банка. Запускает процесс принятия решения по продукту.

Метод асинхронный, решение и статус заявки передаются через вызов партнёра.

Авторизация

Security

Bearer API Token

RPS

Ограничение — 20 запросов в секунду

Scopes

Работа с заявкой → Управление заявками на кредитные продукты

Запрос

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Path parameters

Required

brokerId

String

Requirements: <= 36 characters

Уникальный идентификатор брокера.

Request body schema application/json

process

Object

Данные по процессу.

processId

String

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

partnerId

String

Идентификатор партнёра.

partner

Object

Данные партнёра.

pointId

String

Requirements: <= 36 characters

Уникальный идентификатор точки оформления заявки.

personId

String

Requirements: <= 36 characters

Уникальный идентификатор сотрудника.

Required

applicationPayload

Object

Данные по заявке.

Required

applicationId

String

Requirements: <= 36 characters

Уникальный идентификатор заявки.

Required

clientInfo

Object

Информация о клиенте.

Required

firstName

String

Requirements: <= 50 characters, Value must match regular expression ^[^\s]+(\s+[^\s]+)*$

Имя.

Required

lastName

String

Requirements: <= 50 characters, Value must match regular expression ^[^\s]+(\s+[^\s]+)*$

Фамилия.

middleName

String

Requirements: <= 50 characters, Value must match regular expression ^[^\s]+(\s+[^\s]+)*$

Отчество.

Required

birthDate

String

Requirements: Value must match regular expression ^((19|20)\d\d)-(0?[1-9]|1[012])-(0?[1-9]|[12][0-9]|3[01])$

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

emailAddress

String

Requirements: Value must match regular expression ^[a-zA-Z0-9_!#$%&'*+/=?{|}~^.-]+@[a-zA-Z0-9.-]+$`

Адрес электронной почты.

education

String

Requirements: [SECONDARY_SPECIAL, INCOMPLETE_HIGHER, HIGHER, SECOND_HIGHER, ACADEMIC_DEGREE]

Образование.

maritalStatus

String

Requirements: [WIDOW, DIVORCED, MARRIED_UNOFFICIAL, MARRIED_OFFICIAL, SINGLE, SEPARATED]

Семейное положение.

workPhone

String

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

Рабочий телефон.

Required

mobilePhone

String

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

Мобильный телефон.

Required

documents

Object

Документы.

Required

passport

Object

Паспорт.

birthPlace

String

Requirements: <= 150 characters

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

Required

serialNumber

String

Requirements: <= 20 characters

Серия и номер документа.

division

String

Requirements: <= 10 characters

Код организации, выдавшей документ.

date

String

Requirements: Value must match regular expression ^((19|20)\d\d)-(0?[1-9]|1[012])-(0?[1-9]|[12][0-9]|3[01])$

Дата выдачи документа.

organisationWhoGiven

String

Requirements: <= 200 characters

Организация, выдавшая документ.

registrationAddress

Object

Адрес.

Required

country

String

Requirements: <= 70 characters

Страна.

correspondence

Boolean

Корреспонденция.

zipCode

String

Requirements: <= 30 characters

Индекс.

Required

region

String

Requirements: <= 50 characters

Регион, согласно КЛАДР.

regionType

String

Requirements: <= 50 characters

Тип региона.

Required

area

String

Requirements: <= 50 characters

Район.

areaType

String

Requirements: <= 50 characters

Тип района.

cityType

String

Requirements: <= 50 characters

Тип населённого пункта, согласно КЛАДР.

Required

cityName

String

Requirements: <= 50 characters

Название населённого пункта.

placeType

String

Requirements: <= 50 characters

Тип подчиненного населённого пункта, согласно КЛАДР.

placeName

String

Requirements: <= 50 characters

Название подчинённого населенного пункта.

streetType

String

Requirements: <= 50 characters

Тип улицы, согласно КЛАДР.

street

String

Requirements: <= 200 characters

Название улицы.

Required

house

String

Requirements: <= 30 characters

Номер дома.

building

String

Requirements: <= 30 characters

Корпус.

structure

String

Requirements: <= 30 characters

Строение.

flat

String

Requirements: <= 12 characters

Квартира.

residenceAddress

Object

Адрес.

Required

country

String

Requirements: <= 70 characters

Страна.

correspondence

Boolean

Корреспонденция.

zipCode

String

Requirements: <= 30 characters

Индекс.

Required

region

String

Requirements: <= 50 characters

Регион, согласно КЛАДР.

regionType

String

Requirements: <= 50 characters

Тип региона.

Required

area

String

Requirements: <= 50 characters

Район.

areaType

String

Requirements: <= 50 characters

Тип района.

cityType

String

Requirements: <= 50 characters

Тип населённого пункта, согласно КЛАДР.

Required

cityName

String

Requirements: <= 50 characters

Название населённого пункта.

placeType

String

Requirements: <= 50 characters

Тип подчиненного населённого пункта, согласно КЛАДР.

placeName

String

Requirements: <= 50 characters

Название подчинённого населенного пункта.

streetType

String

Requirements: <= 50 characters

Тип улицы, согласно КЛАДР.

street

String

Requirements: <= 200 characters

Название улицы.

Required

house

String

Requirements: <= 30 characters

Номер дома.

building

String

Requirements: <= 30 characters

Корпус.

structure

String

Requirements: <= 30 characters

Строение.

flat

String

Requirements: <= 12 characters

Квартира.

previousJob

Object

Текущее место работы.

organization

String

Requirements: <= 300 characters

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

jobPositionType

String

Requirements: [EMPLOYEE, SELF_EMPLOYED, COMMERCIAL_EMPLOYEE, GOVERNMENT_EMPLOYEE, STUDENT, PENSIONER, PENSIONER_WORKING, UNEMPLOYED]

Тип занятости.

jobTitle

String

Requirements: <= 100 characters

Название должности.

startMonth

Integer<int32>

Requirements: >= 1 and <= 12

Месяц начала работы. Если данных нет, не передавайте этот параметр.

startYear

Integer<int32>

Requirements: >= 1900 and <= 3000

Год начала работы.

averageMonthlyIncome

Number

Requirements: >= 1

Средний доход в месяц.

workAddress

Object

Адрес.

Required

country

String

Requirements: <= 70 characters

Страна.

correspondence

Boolean

Корреспонденция.

zipCode

String

Requirements: <= 30 characters

Индекс.

Required

region

String

Requirements: <= 50 characters

Регион, согласно КЛАДР.

regionType

String

Requirements: <= 50 characters

Тип региона.

Required

area

String

Requirements: <= 50 characters

Район.

areaType

String

Requirements: <= 50 characters

Тип района.

cityType

String

Requirements: <= 50 characters

Тип населённого пункта, согласно КЛАДР.

Required

cityName

String

Requirements: <= 50 characters

Название населённого пункта.

placeType

String

Requirements: <= 50 characters

Тип подчиненного населённого пункта, согласно КЛАДР.

placeName

String

Requirements: <= 50 characters

Название подчинённого населенного пункта.

streetType

String

Requirements: <= 50 characters

Тип улицы, согласно КЛАДР.

street

String

Requirements: <= 200 characters

Название улицы.

Required

house

String

Requirements: <= 30 characters

Номер дома.

building

String

Requirements: <= 30 characters

Корпус.

structure

String

Requirements: <= 30 characters

Строение.

flat

String

Requirements: <= 12 characters

Квартира.

contacts

Array of objects ()

Requirements: >= 1 and <= 5, <= 5 items

Required

firstName

String

Requirements: <= 50 characters

Имя.

Required

lastName

String

Requirements: <= 50 characters

Фамилия.

middleName

String

Requirements: <= 50 characters

Отчество.

Required

relation

String

Requirements: [BROTHER, SISTER, MOTHER, FATHER, DAUGHTER, SON, HUSBAND, WIFE, OTHER_RELATIVE, FRIEND, COLLEAGUE]

Тип отношений контактного лица с клиентом.

Required

mobilePhone

String

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

Мобильный телефон.

Required

files

Array of objects ()

Requirements: >= 1 items, <= 5 items

Файлы.

Required

data

String<base64>

Содержимое документа.

Required

mimeType

String

Requirements: <= 50 characters

MIME-тип

Required

fileType

String

Requirements: [PASSPORT_2_3P, PASSPORT_REG, PHOTO, BCI_PD, CONSENT_ECP, AGREEMENT, INDIV_CONDITIONS]

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

Ответ

200

OK

400

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

401

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

403

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

422

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

429

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

500

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

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

Обратиться в поддержку
Получить консультацию по интеграции
Loading...

openapi@tinkoff.ru

APIСценарииПодключение

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