Сервис «Кредит в корзине»

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

Информация о сервисе

Кредит в корзине – это сервис для организации расчетов между юридическими лицами (ЮЛ) и индивидуальными предпринимателями (ИП) с использованием денежных средств Банка. Сервис позволяет получать информацию по кредитным предложениям от Банка для Клиентов Платформы, создавать кредитные заявки, формировать и отслеживать статус платежного документа в СберБизнес плательщика.

Ядро механизма сервиса составляют платежные поручения, которые используются в качестве платежных документов для расчетов между компаниями.

Платежное требование

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

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

Подробнее о сервисе можно прочитать на сайте Банка .

До начала разработки интеграции с сервисом потребуется:

• Заключить договор с Банком на использование сервиса "Кредит в корзине".
• Завершить интеграцию со СберБизнес ID.
  Без сервиса СберБизнес ID настроить работу сервиса невозможно.

Терминология

• Платформа – любой web-ресурс (сайт, интернет-магазин, мобильное приложение и т.д.), который вы, как Партнер Банка, используете в рамках клиентского пути Клиентов
• Клиент – пользователь СберБизнес, представитель ЮЛ/ИП, который от лица своей компании приобретает услуги или товары на Платформе

Схема работы сервиса

Шаг	Что делаем	Подробности
1	Предложите Клиенту выбрать способ оплаты	Клиент, находясь на Платформе, выбрал необходимые товары/услуги и перешел к оплате. Покажите ему доступные способы оплаты. Среди доступных способов должен быть "Кредит в корзине" (кнопка "Оплата в кредит") без описания конкретных условий. Для получения информации для Клиента требуется авторизация с помощью СберБизнес ID.
2	Предложите Клиенту авторизоваться через СберБизнес ID	Подробно о подключении сервиса СберБизнес ID рассказали в соответствующем разделе документации. Если Клиент до старта этого сценария уже авторизовался с помощью СберБизнес ID на Платформе, и у вас есть его access_token, то обязательно обновите его с помощью refresh_token.
3	Проверьте возможность кредитования	С помощью ресурса /fintech/api/v2/oauth/user-info получите информацию по клиенту. Проверьте соответствие условиям кредитования. Условия доступности покупки в кредит
4	Получите информацию о наличии текущего кредита Клиента	С помощью ресурса /fintech/api/v1/credit-offers и access_token пользователя Клиента запросите информацию о текущем кредитном договоре. Эту информацию можно будет использовать для формирования выбора способов оплаты.
5	Получите информацию о кредитных предложениях	С помощью ресурса /fintech/api/v1/credit-offers и access_token пользователя вашей компании запросите информацию о кредитных предложениях для Платформы. Условия динамичны и могут меняться, поэтому запрашивать информацию необходимо в каждом клиентском пути. Процесс получения и обновления access_token аналогичен процессу авторизации Клиента. Получение access_token пользователя вашей компании требуется выполнить единожды при разработке интеграции до выхода в промышленную эксплуатацию. Также необходимо будет обновлять его с помощью refresh_token.
6	Предложите Клиенту выбрать способ оплаты (повторно)	После сбора информации о доступных способах оплаты на предыдущих этапах в интерфейсе Платформы предложите пользователю Клиента выбрать удобный вариант. Кнопка "Оплата в кредит" может иметь 2 состояния: новый или действующий кредит. - При выборе "новый кредит" переходим к шагу 7.1 - При выборе "действующий кредит" переходим к шагу 7.2
7.1	Сформируйте заявку на кредит	С помощью ресурса /fintech/api/v1/credit-requests вы можете создать в СберБизнес клиента заявку на оформление кредитного договора.
8.1	Перенаправьте Клиента на страницу заявки	С использованием идентификатора созданной заявки на кредитный договор из шага 7.1 вы формируете ссылку переадресации и перенаправляете по ней пользователя Клиента. Перейдя по ссылке в сервис, пользователь пройдет аутентификацию, заполнит кредитную заявку и подпишет ее для исполнения Банком. После получения положительного решения по заявке Клиенту автоматически будет создано платежное поручение для оплаты заказа. Автоматически созданному платежному поручению присваивается тот же идентификатор, который использовался в создании заявки на кредит из шага 7.1 Ссылка переадресации выглядит следующим образом: {контур Банка}/ic/dcb/index.html#/credits/credit-financing/credit-partners?order=externalID Дополнительная информация о формировании ссылки.
7.2	Сформируйте оплату за счет открытого кредитного договора	С помощью ресурса /fintech/api/v1/payments/from-invoice-any и access_token пользователя Клиента вы создадите платежное поручения в СберБизнес Клиента.
8.2	Перенаправьте клиента в сервис оплаты	С использованием идентификатора созданного платежного поручения из шага 7.2 вы формируете ссылку для оплаты и перенаправляете по ней пользователя Клиента. Перейдя по ссылке в сервис оплаты, пользователь пройдет аутентификацию, выберет счет списания и подпишет платежное поручение для исполнения Банком. Ссылка переадресации выглядит следующим образом: {контур Банка}/ic/dcb/index.html#/payment-creator/{externalid}?backUrl={backUrl} Дополнительная информация о формировании ссылки.
9	Получите статус платежного поручения	С помощью ресурса /fintech/api/v1/payments/{externalId}/state вы сможете разработать механизм проверки статуса оплаты и реакцию Платформы на каждый из них. В этой части страницы указали все статусы платежного поручения и их описание.

Варианты реализации

Ниже, в качестве примера, приведена диаграмма вариантов использования:

Выбор способа оплаты покупки

Клиент добавляет в корзину товары/услуги и переходит к оплате.

Вы ему показываете доступные способы оплаты, среди которых есть "Кредит в корзине". Клиент видит данный способ без условий для него - до авторизации СберБизнес ID и получения информации по Клиенту у вас отсутствует возможность проверить возможность кредитования Клиента и условия. После авторизации через СберБизнес ID вы вновь показываете способы оплаты, среди которых "Кредит в корзине" с условиями для Клиента (если присутствует возможность кредитования).

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

В данном usecase рассматривается случай первой авторизации Клиента на вашей Платформе.

Шаги

1. Показать доступные способы оплаты
2. Получить access_token Клиента
3. Проверить возможность кредитования
4. Получить информацию о действующем кредите
5. Получить информацию по условиям кредитования
6. Предложить выбрать способ оплаты

Участники usecase

• Клиент — представитель ЮЛ/ИП, который от лица своей компании приобретает услуги или товары вашей компании;
• Платформа — любой web-ресурс (сайт, интернет-магазин, мобильное приложение и т.д.), который Вы используете рамках клиентского пути Клиентов;
• Банк — в контексте данного usecase представляет из себя методы и ресурсы Sber API, к которым обращается Платформа.

Предусловия

• Клиент находится на Платформе
• Клиент не авторизован через СберБизнес ID
• Клиент (пользователь) имеет доступ к работе с кредитами в СберБизнес компании

Постусловия

• Клиент выбрал способ для оплаты покупки

Используемые ресурсы

№	Метод	Точка вызова	Описание	Операция в scope	Шаг в схеме
1		/ic/sso/api/v2/oauth/authorize	Получение кода авторизации	openid	2. Получить access_token
2		/ic/sso/api/v2/oauth/token	Получение токена доступа	openid	2. Получить access_token
3		/ic/sso/api/v2/oauth/user-info	Получение информации	openid	2. Получить access_token и 3. Проверить возможность кредитования
4		/fintech/api/v1/credit-offers	Получение информации по кредитным предложениям	GET_CREDIT_OFFERS	4. Получить информацию о действующем кредите и 5. Получить информацию по условиям кредитования
5		/ic/sso/api/v2/oauth/token	Обновление токена доступа	openid	Ресурс может потребоваться для обновления access_token на любом шаге

Оплата из нового кредита

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

Шаги

1. Создать кредитную заявку
2. Подписать кредитную заявку
3. Получить статус платежного поручения

Участники usecase

• Клиент — представитель ЮЛ/ИП, который от лица своей компании приобретает услуги или товары вашей компании;
• Платформа — любой web-ресурс (сайт, интернет-магазин, мобильное приложение и т.д.), который Вы используете рамках клиентского пути Клиентов;
• Банк — в контексте данного usecase представляет из себя методы и ресурсы Sber API, к которым обращается Платформа.

Предусловия

• Клиент завершил сценарий "Выбор способа оплаты покупки"
• Клиент выбрал способ оплаты "Оплатить в кредит" (новая кредитная заявка "Кредит в корзине")

Постусловия

• Клиент оплатил покупку из денежных средств, полученных по новому кредиту

Используемые ресурсы

№	Метод	Точка вызова	Описание	Операция в scope	Шаг в схеме
1		/ic/sso/api/v2/oauth/token	Обновление токена доступа	openid	Ресурс может потребоваться для обновления access_token на любом шаге
2		/ic/sso/api/v2/oauth/user-info	Получение информации	openid	1. Создать кредитную заявку Может потребоваться для получения реквизитов Клиента и вашей компании.
3		/fintech/api/v1/credit-requests	Создание заявки на кредитный договор	CREDIT_REQUEST	1. Создать кредитную заявку
4		/fintech/api/v1/payments/{externalId}/state	Получить статус платежного поручения	PAY_DOC_RU_INVOICE_ANY	3. Получить статус платежного поручения

Оплата из действующего кредита

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

Шаги

1. Создать платежное поручение
2. Подписать платежное поручение
3. Получить статус платежного поручения

Участники usecase

• Клиент — представитель ЮЛ/ИП, который от лица своей компании приобретает услуги или товары вашей компании;
• Платформа — любой web-ресурс (сайт, интернет-магазин, мобильное приложение и т.д.), который Вы используете рамках клиентского пути Клиентов;
• Банк — в контексте данного usecase представляет из себя методы и ресурсы Sber API, к которым обращается Платформа.

Предусловия

• Клиент завершил сценарий "Выбор способа оплаты покупки"
• Клиент выбрал способ оплаты "Оплатить с действующего кредита"

Постусловия

• Клиент оплатил покупку из денежных средств действующего кредита

Используемые ресурсы

№	Метод	Точка вызова	Описание	Операция в scope	Шаг в схеме
1		/ic/sso/api/v2/oauth/token	Обновление токена доступа	openid	Ресурс может потребоваться для обновления access_token на любом шаге
2		/ic/sso/api/v2/oauth/user-info	Получение информации	openid	1. Создать платежное поручение Может потребоваться для получения реквизитов Клиента и вашей компании.
3		/fintech/api/v1/payments/from-invoice-any	Создать черновик платежного поручения	PAY_DOC_RU_INVOICE_ANY	1. Создать платежное поручение
4		/fintech/api/v1/payments/{externalId}/state	Получить статус платежного поручения	PAY_DOC_RU_INVOICE_ANY	3. Получить статус платежного поручения

Scope сервиса

Scope

openid+CREDIT_REQUEST+GET_CREDIT_OFFERS+PAY_DOC_RU_INVOICE_ANY+buyOnCreditMmb+creditLineAvailableSum+hasActiveCreditLine+orgLawFormShort+userCryptoType+aud+iss+inn+sub+orgFullName+email+phone_number+HashOrgId+orgKpp

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

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