Выдача кредитных продуктов

С помощью методов API для работы с кредитными продуктами вы можете:

создать заявку на кредитный продукт;
привязать карту и подтвердить выбор предложения;
запросить печатные формы для подписания;
загрузить фотографии и сканы документов;
отправить запрос на проверку документов;
отправить запрос на активацию кредитного продукта;
отменить заявку;
получить статус по заявке для перехода на следующий шаг.

Также вы можете воспользоваться вебхуком Статус заявки на кредитный продукт. Как подключить вебхук.

Перед интеграцией

Чтобы использовать методы API, у вас должен быть заключен договор с Т-Банком на выдачу кредитных продуктов. Подробности можно узнать у вашего менеджера.

После заключения договора аналитик со стороны T-Банка направит вам константы — brokerId, partnerId, processId, — которые используются при интеграции.

Интеграция

Практически весь процесс взаимодействия с банком является асинхронным. Брокер вызывает метод API с запросом какого-либо действия и ждет вебхук с результатом выполнения этого действия.

Создание заявки

Для создания заявки используйте метод Создать полную заявку. В результате обработки запроса будет отправлен вебхук с одним из следующих статусов:

APPROVED — процесс скоринга в системе банка успешно завершен, выдача кредитной карты одобрена клиенту. Можно начинать привязку карты, если клиент согласен с условиями продукта. В этом статусе содержится флаг с информацией о том, что по данной заявке доступно полное онлайн-подписание.
REJECTED — процесс скоринга в системе банка завершен, банк отказал в получении карты. Заявка на стороне банка будет закрыта. Дальнейшие запросы от партнера будут проигнорированы.

В методе для создания заявки обязательно нужно передать паспорт (основной разворот и станицу регистрации), фото клиента и согласие на БКИ и ПД.

Привязка карты, подтверждение выбора предложения

Для привязки карты используйте метод Привязать карту к счету. Если вы привязываете карту:

В первый раз — в параметре eventType передайте LINK_CARD.
Повторно во второй и последующие разы — в параметре eventType передайте LINK_CARD_UPDATE.

Если параметр eventType передан неверно, запрос будет проигнорирован.

В результате обработки запроса будет отправлен вебхук с одним из следующих статусов:

CONFIRMED — карта с указанным UCID привязана к клиенту, можно начинать подписание документов.
REBIND — привязанная карта невалидна, нужно повторить операцию привязки карты с другим UCID. Максимальное число попыток привязки — 3.
REJECTED — после трех неудачных попыток привязать карту или по решению банка заявка на стороне банка будет закрыта. Дальнейшие запросы от партнера будут проигнорированы.

Генерация документов

Для получения документов используйте метод Сгенерировать документы.

Загрузка документов

Для загрузки документов используйте метод Загрузить документы.

Список используемых типов документов:

PASSPORT_2_3P — паспорт, основной разворот;
PASSPORT_REG — паспорт, страница регистрации;
PHOTO — фото клиента;
BCI_PD — согласие на БКИ и ПД;
AGREEMENT — оферта.

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

Проверка документов

Чтобы начать проверку документов, используйте метод Проверить документы. Если вы проверяете документы:

В первый раз — в параметре eventType передайте SIGNING.
Повторно во второй и последующие разы — в параметре eventType передайте RESIGNING.

Если параметр eventType передан неверно, запрос будет проигнорирован.

В результате обработки запроса будет отправлен вебхук с одним из следующих статусов:

CHECKED — документы проверены, начинается этап онлайн-подписания. Можно помочь клиенту подписать документы онлайн.
RESIGNING — требуется исправить или догрузить документы. Документы, требующие исправления, нужно загрузить заново, и вызвать метод проверки документов. Максимальное число попыток переподписания документов — 3.
REJECTED — после трех неудачных попыток проверки документов или по решению банка заявка на стороне банка будет закрыта. Дальнейшие запросы от партнера будут проигнорированы.

Онлайн-подписание и активация карты

Если вы выбрали ручной вариант активации карты, используйте метод Активировать карту.

Варианты активации карты

Обратите внимание: статус SIGNED может не прийти, если вы используете автоматический способ активации карты.

В результате обработки запроса будет отправлен вебхук с одним из следующих статусов:

SIGNED — документы успешно подписаны онлайн, можно начинать активацию карты.
COMPLETED — карта успешно активирована. Дальнейшие запросы от партнера будут проигнорированы.
REJECTED — по решению банка заявка на стороне банка будет закрыта. Дальнейшие запросы от партнера будут проигнорированы.

Отмена заявки

Для отмены заявки используйте метод Отменить заявку.

Иногда статус CANCELLED также может прийти, если клиент самостоятельно отменил заявку через форму онлайн-подписания или через поддержку в чате мобильного приложения.

В результате обработки запроса будет отправлен вебхук с одним из следующих статусов:

CANCELLED — хаявка успешно отменена. Дальнейшие запросы от партнера будут проигнорированы.
REJECTED — по решению банка заявка на стороне банка будет закрыта. Дальнейшие запросы от партнера будут проигнорированы.

Варианты подписания документов

Есть два сценария подписания документов — основной (комбинированный) и онлайн.

Доступен всем клиентам.

После привязки карты клиент должен подписать бумажную универсальную оферту. Банк ее проверит, и клиенту придет СМС с электронными документами, которые он также должен подписать.

Обратите внимание: если универсальная оферта была загружена, ее проверят в любом случае. Если на ней найдутся негативы, их придется исправлять.

Варианты активации карты

Есть два варианта активации карты: ручная и автоматическая. Вариант активации настраивается под партнера.

По всем заявкам карта будет активироваться сразу же после успешно завершенного онлайн-подписания. Метод активации карты не используется.

Мы рекомендуем автоматическую активацию карты.