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

/api/offline/partners/v1/demo/create

POST

https://secured-openapi.tbank.ru/api/offline/partners/v1/demo/create

Метод создает кредитную заявку в системе Т-Банк Кредит Брокер.

В ответе возвращается ссылка с ссылочной авторизацией для продолжения заявочного процесса внутри личного кабинета агента.

Авторизация

Security

Bearer API Token

MTLS-сертификат

RPS

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

Scopes

Кредитование покупателей → Создание новой заявки

Запрос

Header parameters

X-Request-Id

String<uuid>

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

Request body schema application/json

agentLogin

String

Requirements: Value must match regular expression ^[9]{1}[0-9]{9}$

Номер телефона агента, под которым он заведен в TCB.

Required

orderNumber

String<string>

Requirements: non-empty and <= 50 characters

Номер заказа на стороне продавца.

order

Object

Модель заказа клиента в запросе создания заявки.

firstPayment

Integer<int32>

Первоначальный взнос.

Required

items

Array of objects ()

Requirements: >= 1 items, <= 99 items

Товары в корзине.

Required

name

String<string>

Requirements: non-empty and <= 255 characters

Наименование товара.

Required

quantity

Integer<int32>

Количество товара.

Required

price

Number<double>

Стоимость одной единицы товара.

externalId

String<string>

Requirements: non-empty

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

Required

type

Object

Объект с информацией по запрашиваемым продуктам.

Required

isPos

Boolean<boolean>

Флаг отправки заявки на POS-кредит.

Required

isCreditCard

Boolean<boolean>

Флаг отправки заявки на кредитную карту.

isCallSigning

Boolean<boolean>

Флаг телефонного заполнения. По умолчанию — false.

isOnlyCredit

Boolean<boolean>

Флаг отключения рассрочек, возможно оформление только кредитов. По умолчанию — false.

values

Object

Данные клиента.

contact

Object

Модель данных клиента.

fio

Object

ФИО клиента.

Required

firstName

String<string>

Requirements: Value must match regular expression ^[а-яА-ЯёЁ\-\s]{1,}$

Имя клиента.

Required

lastName

String<string>

Requirements: Value must match regular expression ^[а-яА-ЯёЁ\-\s]{1,}$

Фамилия клиента.

middleName

String<string>

Requirements: Value must match regular expression ^[а-яА-ЯёЁ\-\s]{1,}$

Отчество клиента.

mobilePhone

String

Requirements: Value must match regular expression ^[9]{1}[0-9]{9}$

Номер телефона клиента.

birthDate

String<date>

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

isResident

Boolean<boolean>

Флаг резидента РФ.

webhookURL

String<url>

Requirements: Value must match regular expression ^https?:\/\/(?:www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_\+.~#?&\/=]*)$

URL для отправки вебхуков. Если не указан, используется URL из настроек точки.

pointId

String<string>

Requirements: non-empty and <= 50 characters

Внешний идентификатор точки.

companyId

String<string>

Requirements: non-empty and <= 100 characters

Внешний идентификатор компании.

agentId

String<string>

Requirements: non-empty and <= 100 characters

Внешний идентификатор агента.

creditCards

Object

Объект с кредитными картами.

property name*

Object

Required

ean

String<string>

Requirements: <= 13 characters, Value must match regular expression ^\d{13}$

Штрихкод кредитной карты. Допускаются только цифры.

Ответ

200

Успешный запрос

400

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

401

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

403

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

422

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

429

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

500

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

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

Обратиться в поддержку

Интеграция

Прямая (H2H)Партнерская

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

Payload

cURL

Go

Java

NodeJs

PHP

Python

Content type

application/json

{

"agentLogin":

"string",

"orderNumber":

"string",

"order": {

"firstPayment":

0,

"items": [

{ ... }

"name":

"string",

"quantity":

0,

"price":

0,

"externalId":

"string"

}

]

},

"type": {

"isPos":

true,

"isCreditCard":

true

},

"isCallSigning":

true,

"isOnlyCredit":

true,

"values": {

"contact": { ... }

"fio": {

"firstName":

"string",

"lastName":

"string",

"middleName":

"string"

},

"mobilePhone":

"string",

"birthDate":

"2025-08-14",

"isResident":

true

}

},

"webhookURL":

"string",

"pointId":

"string",

"companyId":

"string",

"agentId":

"string",

"creditCards": {

"skb-card": {

"ean":

123456789101

},

"kvk-card": {

"ean":

123456789101

}

}

}

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

200

400

401

403

422

429

500

Content type

application/json

{

"id":

"21dc246d-ff4b-451b-a1f6-c746579bfb26",

"link":

"https://forma.tbank.ru/auth/authorize?authToken={accessToken}&redirect_uri={redirectUrl}&client_id=tcb&responseType=code"

}