Сервис «Безопасные сделки»
Информация о сервисе
Безопасные сделки — это технология Сбера для защищенных расчетов между контрагентами. Технология предоставляет возможность интеграции по API для торговых площадок (Маркетплейсов), позволяет осуществлять безопасные расчеты покупателей (бенефициаров) с продавцами (поставщиками).
Ядро механизма сервиса составляют смарт-контракты, которые используются для автоматизированных и безопасных расчетов между клиентами (ЮЛ, ИП).
Смарт-контракт
Смарт-контракт — это инструмент, помогающий автоматизировать расчеты между участниками сделки. В нем отражается финансово-значимая информация из договорных отношений клиентов торговой площадки (Маркетплейса).
Главным конкурентным преимуществом расчетов через смарт-контракты является безопасность сделки. За счет использования технологии холдирования денежных средств на номинальном счете продавец (поставщик) может быть уверен, что он получит оплату за товар или услугу, а покупатель (бенефициар) гарантирует наличие у него необходимой суммы, при этом без риска ее потерять.
Это дает торговой площадке (Маркетплейсу) больше доверия со стороны пользователей, что позволяет дополнительно привлекать клиентов для безопасных расчетов по сделкам.
Перед подключением к сервису "Безопасные сделки":
- Откройте расчетный счет в Сбербанке и заключите договор дистанционного банковского обслуживания СберБизнес. Открыть счет и заключить договор можно в любом отделении Сбербанка. Список офисов размещен на сайте Банка.
- Ознакомьтесь с договорной документацией на сайте Банка.
- Откройте номинальный счет для учета средств нескольких бенефициаров. При открытии номинального счета выберите расчетный счет, с которого будет взиматься комиссия. Открыть счет можно в любом отделении Сбербанка. Список офисов размещен на сайте Банка.
Для подключения сервиса "Безопасные сделки":
- Пройдите шаги по подключению к Сбер API по инструкции.
- Выполните настройки в личном кабинете (общая документация):
Параметр | Значение |
---|---|
Redirect URL | http://localhost:9999/ |
Авторизация для получения токенов доступа
Особенности получения токенов для сервиса «Безопасная сделка»:
В основном необходимо руководствоваться общей инструкцией.
Для сервиса «Безопасные сделки» нет необходимости автоматизировать отдельные шаги из общей инструкции, т.к. необходима однократная авторизация СберБизнесID площадки. Первичная авторизация выполняется сотрудником Вашей организации, имеющим СберБизнесID. Для этого необходимо:
- Получите код авторизации (единоразово).
Сформировать ссылку для получения кода авторизации — инструкция.
Пример сформированной ссылки: https://efs-sbbol-ift-web.testsbi.sberbank.ru:9443/ic/sso/api/v1/oauth/authorize?scope=openid+nominal_accounts&response_type=code&client_id=9223376456675586&state=abc123&nonce=abc123&redirect_uri=http://localhost:9999.
Данные для запроса /v2/oauth/authorize возьмите из сформированной ссылки:
Параметр | Как заполнять | Пример | Описание |
---|---|---|---|
scope | openid+nominal_accounts | openid+nominal_accounts | Всегда одно и то же значение |
response_type | code | code | Всегда одно и то же значение |
client_id | Взять значение из личного кабинета | 9223376456675586 | Выдается при подключении к SberAPI |
state | Произвольный набор символов | abc123 | Подробное описание соответствующего параметра |
nonce | Произвольный набор символов | abc123 | Подробное описание соответствующего параметра |
redirect_uri | http://localhost:9999 | http://localhost:9999 | Всегда одно и то же значение |
По этой ссылке сотрудник должен перейти в браузер на страницу авторизации. После ввода аутентификационных данных произойдет редирект на адрес http://localhost:9999 и в адресной строке отобразится значение query parameter «code», что и будет являться кодом авторизации.
На этом шаге не требуется развертывание сервиса на порту 9999. В момент редиректа в браузере отобразится ошибка, нас интересует только значение в адресной строке браузера.
- Обменяйте полученный код авторизации на токены доступа (единоразово) — Инструкция.
- Реализуйте логику обновления токенов доступа на бэкенде приложения — Инструкция.
- Реализуйте процесс замены client_secret — Инструкция.
- Ознакомьтесь с информацией по тестовым стендам и Смарт-контрактами на ном. счете v1. в спецификации основного (ПРОМ) API.
- Разверните на сервере КриптоПро, чтобы подписывать POST-запросы с помощью УКЭП.
- Установите сертификат Минцифры.
Схема работы сервиса
- Графическое описание
- Текстовое описание
Шаг | Что делаем | Подробности |
---|---|---|
1 | Торговая площадка (Маркетплейс) авторизуется через СберБизнес ID | Шаг реализуется с помощью СберБизнес ID - в рамках процесса авторизации через СберБизнес ID вы получаете access_token клиента и, при необходимости, дополнительную информацию о Клиенте. Подробно о подключении сервиса СберБизнес ID рассказали в соответствующем разделе документации. |
2 | Торговая площадка (Маркетплейс) регистрируется в продукте "Безопасные сделки" | С помощью метода /v1/nominal-account/signup выполняется единоразовый запрос для активации API при регистрации в продукте "Безопасные сделки" |
3 | Работа с реестром бенефициаров | С помощью набора методов для работы с реестром бенефициаров торговая площадка (Маркетплейс) имеет возможность:/v1/nominal-account/beneficiaries - отправить запрос на создание бенефициара/v1/nominal-account/beneficiaries/registry - отправить запрос на получение реестра бенефициаров/v1/nominal-account/beneficiaries/details/{id} - отправить запрос на получение сведений о бенефициаре/v1/nominal-account/beneficiaries/state/{id} - отправить запрос на получение состояния бенефициара/v1/nominal-account/beneficiaries/balance-report/{id} - отправить запрос на получение выписки по движению денежных средств на балансе бенефициара/v1/nominal-account/beneficiaries/moneyback - отправить запрос на вывод денежных средств бенефициара с номинального счета на расчетный счет /v1/nominal-account/beneficiaries/{beneficiaryId}/balance/events/{eventId} - отправить запрос на получение информации про денежный event конкретного бенефициара |
4 | Работа со смарт-контрактами | С помощью набора методов для работы со смарт-контрактами торговая площадка (Маркетплейс) имеет возможность:/v1/nominal-account/smart-contracts - отправить запрос на создание смарт-контракта/v1/nominal-account/smart-contracts/confirmstep - отправить запрос на подверждение шага смарт-контракта/v1/nominal-account/smart-contracts/completion - отправить запрос на завершение смарт-контракта/v1/nominal-account/smart-contracts/{id} - отправить запрос на получение актуальных сведений о смарт-контракте |
Вариант реализации
В рамках Платформы торговая площадка (Маркетплейс) самостоятельно разрабатывает ролевую модель и настраивает права доступа к функциональности.
Вариант реализации работы торговой площадки (Маркетплейса) с сервисом "Безопасные сделки"
Шаги
- Торговая площадка (Маркетплейс) интегрируется с сервисом Безопасные сделки
- Покупатель/заказчик заключает с продавцом (поставщиком) сделку на торговой площадке (Маркетплейсе) с использованием безопасной сделки
- С помощью технологии расчетов безопасной сделки производится контроль наличия средств покупателя/заказчика на номинальном счете под конкретную покупку
- По факту подтверждения сделки (получения товара/услуг) средства перечисляются продавцу (поставщику)/исполнителю
Участники
- Покупатель — представитель ЮЛ/ИП, который от лица своей компании приобретает услуги или товары на вашей платформе;
- Поставщик — представитель ЮЛ/ИП, который от лица своей компании осуществляет продажу услуг или товаров на вашей платформе;
- Платформа — любой web-ресурс (интернет-магазин, мобильное приложение и т.д.), который вы используете в рамках клиентского пути Клиентов;
- Банк — в контексте данного usecase представляет из себя методы и ресурсы Sber API, к которым обращается Платформа, и СберБизнес, на который переадресовывают Клиента для проведения оплаты.
Общая схема процессов в рамках работы с сервисом "Безопасные сделки"
Используемые методы
№ | Метод | Точка вызова | Описание | Шаг в схеме |
---|---|---|---|---|
1 | /v1/smart-contracts | Создать смарт-контракт | 10 | |
2 | /v1/smart-contracts/confirmstep | Подтвердить шаг смарт-контракта | 14 | |
3 | /v1/smart-contracts/completion | Завершить смарт-контракт | 22 | |
4 | /v1/beneficiaries | Создать бенефициара | 2 | |
5 | /v1/beneficiaries/details/{id} | Запросить сведения о бенефициарe | 4 | |
6 | /v1/beneficiaries/moneyback/beneficiaries/moneyback | Вывести средства с номинального счета | 19 |
Cпецификация основного API
FAQ
Как проходит сделка через смарт-контракты?
Владельцем номинального счета является торговая площадка (Маркетплейс), а зарегистрированные на ней покупатели/заказчики — бенефициары денежных средств по данному счету. В целях проведения безопасной сделки покупатель/заказчик заключает с продавцом сделку на платформе торговой площадки (Маркетплейса) с использованием безопасной сделки от Сбера. Технология таких расчетов позволяет торговой площадке (Маркетплейсу) контролировать наличие денег покупателя/заказчика на номинальном счете под конкретную покупку и перечислять их продавцу/исполнителю только тогда, когда товар будет доставлен, услуга исполнена, либо по каким-либо иным признакам подтверждения сделки. В контракте может быть предусмотрено несколько сторон от поставщика/исполнителя, например — транспортная компания. Также допускается финансирование покупателя/заказчика за счет кредитных средств, перечисленных на номинальный счет торговой площадки (Маркетплейса).
Интеграция с торговой площадкой осуществляется по API. Таким образом, торговой площадке (Маркетплейсу) необходимо адаптировать свой интерфейс личного кабинета под логику работы со смарт-контрактами, а также предусмотреть в договорной документации использование номинального счета.
Кто должен подписывать УКЭП смарт-контракт?
Смарт-контракт создается между Банком и торговой площадкой (Маркетплейсом) и подписывается самой площадкой. Подписание смарт-контракта всеми участниками сделки не требуется.
Заменяет ли смарт-контракт договор?
Смарт-контракт не заменяет договор, а является инструментом, помогающим автоматизировать расчеты между участниками сделки, в нем отражается финансово-значимая информация из договорных отношений клиентов торговой площадки (Маркетплейса).
В какой валюте можно открыть номинальный счет?
На номинальный счет можно перечислять средства только в валюте Российской Федерации (рубли)
В чем преимущество при заключении сделок через смарт-контракты?
Главным конкурентным преимуществом расчетов через смарт-контракты является безопасность сделки между покупателем и продавцом/заказчиком. За счет использования технологии холдирования денежных средств на номинальном счете, продавец может быть уверен, что он получит оплату за товар или услугу, а покупатель гарантирует наличие у него необходимой суммы, при этом без риска ее потерять. Это дает торговой площадке (Маркетплейсу) больше доверия со стороны пользователей, что позволяет дополнительно привлекать клиентов для безопасных расчетов по сделкам.
Кто может стать владельцем номинального счета?
Юридическое лицо/индивидуальный предприниматель — резидент РФ, у которого открыт в Сбербанке расчетный счет.
Кто такие бенефициары номинального счета?
Юридическое лицо, индивидуальный предприниматель или физическое лицо, которое приняло правила платформы и расчеты через номинальный счет, владеющее денежными средствами, находящимися на номинальном счете торговой площадки, (бенефициаром может быть только резидент РФ). Бенефициар может иметь расчетный счет как в Сбербанке, так и в любом другом коммерческом банке РФ.
Какую комиссию возьмет Сбербанк по смарт-контракту?
Вознаграждение банка взимается с расчетного счета торговой площадки (Маркетплейса) в виде процента с каждой сделки по факту перечисления средств с номинального счета по каждой исполненной транзакции согласно тарифам банка (процент от суммы платежа, комиссия включает НДС).
Можно ли ознакомиться с возможностями сервиса через тестовый стенд?
Да, мы предоставляем такую возможность. Тестовый доступ аналогичен промышленному API.
Какая должна быть электронная подпись?
Для работы с нашим сервисом и подписания смарт-контрактов торговой площадке (Маркетплейсу) необходимо подключить УКЭП.
Наличие у торговой площадки (Маркетплейса) УКЭП является обязательным условием подключения к сервису. Список уполномоченных УЦ. Подробнее об УКЭП.
Как бенефициар может пополнять баланс номинального счета?
Бенефициар пополняет номинальный счет платежным поручением со своего расчетного счета в банке.
Возможно ли бенефициару увидеть баланс собственных денежных средств на номинальном счете?
Такая информация может быть доступна бенефициару в случае настроек личного кабинета торговой площадки (Маркетплейса).
Можно ли создавать смарт-контракт без обеспечения денежных средств бенефициара на номинальном счете для пост оплаты со стороны покупателя/заказчика?
Нет. Однако допускается пополнение номинального счета третьим лицом, в том числе за счет кредитных средств.
От каких рисков защищает покупателя сделка через номинальный счет?
- Невозможно взыскание денежных средств по обязательствам владельца номинального счета — торговой площадки.
- Невозможно взыскание денежных средств с бенефициаров по запросам ФНС.
- Возможно взыскание денежных средств с бенефициаров по судебному решению.