Version: 1.0.0

Credit Requests Overview

Обновлено 13 марта 2025

Методы для работы с заявками на кредит

• Создание заявки на кредит

API URLs

• Тестовый контур: https://iftfintech.testsbi.sberbank.ru:9443
• Промышленный контур: https://fintech.sberbank.ru:9443

Дополнительная информация

Условия доступности покупки в кредит

Возможность покупки в кредит на Платформе должна предоставляться только при выполнении условия: Значение атрибута buyOnCreditMmb, возвращаемого на запрос /fintech/api/v2/oauth/user-info, должно быть true.

Также у Клиента может быть действующий кредитный договор, из денежных средств которого он может оплатить покупку. Необходимо проверить значение атрибута hasActiveCreditLine - признак наличия действующей возобновляемой кредитной линии (ВКЛ). При наличии ВКЛ проверьте атрибут creditLineAvailableSum - сумма действующей ВКЛ.

Наименование организационно-правовых форм, для которых доступны кредитные продукты и предложения для покупки в кредит:

Полное наименование организационно - правовой формы	Общепринятое сокращение
Общество с ограниченной ответственностью	ООО
Индивидуальный предприниматель	ИП
Глава крестьянского (фермерского) хозяйства	ГКФХ

Заполнение заявки на кредит

Правила заполнения полей сумма заказа (amount) и запрошенная сумма кредита (creditAmount):

• Если сумма заказа (значение amount) больше максимальной суммы доступной для покупки в кредит (значение sumMax, полученное в ответе на запрос /v1/credit-offers), то уведомлять клиента о сумме заказа, которую он может оплатить.
• Если клиенту доступна оплата несколькими платежами, то предлагать выбор: оплатить часть заказа или изменить сумму заказа (значение amount).
• Если клиент выбирает оплатить часть заказа, то заполнять сумму заказа (значение amount) значением остатка по кредитной линии (availableSum, полученное в ответе на запрос /v1/credit-offers).
• Если сумма заказа (значение amount) меньше минимальной суммы доступной для покупки в кредит (значение sumMin, полученное в ответе на запрос /v1/credit-offers), то заполнять сумму заказа значением amount, а запрошенную сумму кредита (creditAmount) заполнять минимальной суммой доступной для покупки в кредит (sumMin).
• Если сумма заказа (значение amount) между минимальной (sumMin) и максимальной (sumMax) суммами доступными для покупки в кредит, то заполнять сумму заказа и запрошенную сумму кредита (creditAmount) значением amount.

Переадресация на кредитную заявку

Платформа создает заявку на кредитный договор в СберБизнес Клиента. Необходимо переадресовать пользователя Клиента в заявку для завершения оформления кредитного договора.

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

Модель ссылки

{контур Банка}**/ic/dcb/index.html#/credits/credit-financing/credit-partners?order=**{externalId}

Переменная	Описание	Дополнительная информация
{контур Банка}	адрес Банка, на который делается запрос для открытия страницы сервиса оплаты	Для корректного выбора контура Банка потребуется определить тип криптопрофиля пользователя Клиента. В рамках запроса /ic/sso/api/v1/oauth/user-info вы получаете данные по Клиенту, в том числе атрибут userCryptoType. Атрибут позволяет определить криптопрофиль пользователя - SMS (СМС) или Token (электронный ключ (токен)). - Тестовый контур https://efs-sbbol-ift-web.testsbi.sberbank.ru:9443 - Промышленный контур СМС-пользователь https://sbi.sberbank.ru:9443 - Промышленный контур Токен-пользователь http://localhost:28016
{externalId}	уникальный идентификатор платежного документа	Данный идентификатор присваивает ваша Платформа на шаге создания кредитной заявки

Пример ссылки

https://sbi.sberbank.ru:9443/ic/dcb/index.html#/credits/credit-financing/credit-partners?order=d4fbfe27-ee37-4451-b224-8113a06c44a3

Переадресация на платежное поручение

Чтобы Банк начал обработку платежного поручения, платежное поручение должно быть подписано. В клиентском пути сервиса платежное поручение формируется в клиентской части СберБизнес Клиента, поэтому и подписывать платежное поручение должен Клиент.

Для реализации бесшовного перехода в клиентскую часть СберБизнес необходима переадресация Клиента. Перейдя по ссылке в сервис оплаты, клиент пройдет аутентификацию, выберет счет списания и подпишет черновик платежного поручения для его исполнения Банком.

Модель ссылки

{контур Банка}**/ic/dcb/index.html#/payment-creator/**{externalId}**?backUrl=**{backUrl}

Переменная	Описание	Дополнительная информация
{контур Банка}	адрес Банка, на который делается запрос для открытия страницы сервиса оплаты	Для корректного выбора контура Банка потребуется определить тип криптопрофиля пользователя Клиента. В рамках запроса /v1/oauth/user-info вы получаете данные по Клиенту, в том числе атрибут userCryptoType. Атрибут позволяет определить криптопрофиль пользователя - SMS (СМС) или Token (электронный ключ (токен)). - Тестовый контур https://efs-sbbol-ift-web.testsbi.sberbank.ru:9443 - Промышленный контур СМС-пользователь https://sbi.sberbank.ru:9443 - Промышленный контур Токен-пользователь http://localhost:28016
{externalId}	уникальный идентификатор платежного документа	Данный идентификатор присваивает ваша Платформа на шаге создания платежного поручения
{backUrl}	страница возврата, на которую Банк вернет пользователя Клиента после успешного подписания черновика платежного поручения	- backUrl нужно закодировать URLEncode; - Если не указать backUrl в ссылке, пользователи не смогут после подписания платежного поручения вернуться на Платформу; - Если backUrl будет отличаться от адреса вашей платформы, который указали при регистрации в Банке, то при возврате клиента на backUrl он будет видеть ошибку.

Пример ссылки

https://sbi.sberbank.ru:9443/ic/dcb/index.html#/payment-creator/d4fbfe27-ee37-4451-b224-8113a06c44a3?backUrl=https://www.example.ru/