CreditRequests
Список запросов
Дополнительная информация
Условия доступности покупки в кредит
Возможность покупки в кредит на Платформе должна предоставляться только при выполнении условия:
Значение атрибута **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/