ym88659208ym87991671
Сервис «Кредит в корзине» | Документация для разработчиков

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

Обновлено 3 декабря 2024

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Варианты реализации
Выбор способа оплаты покупки

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

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

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

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

Шаги

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

Участники usecase

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

Предусловия

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

Постусловия

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

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

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

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

Шаги

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

Участники usecase

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

Предусловия

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

Постусловия

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

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

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

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

Шаги

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

Участники usecase

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

Предусловия

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

Постусловия

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

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

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

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}уникальный идентификатор платежного документаДанный идентификатор присваивает ваша Платформа на шаге создания кредитной заявки

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

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

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

Ссылка переадресации выглядит следующим образом:

{контур Банка}/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 он будет видеть ошибку.

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.