# СБП (Система быстрых платежей)

##### Общее описание

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

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

Обращаем ваше внимание, что для отображения гостям QR-кодов для оплаты через СБП Росбанк дополнительно требуется приобретение дисплея QR-кодов от компании Mertech: [https://mertech.ru/qr-code-display/](https://mertech.ru/qr-code-display/ "https://mertech.ru/qr-code-display/")

<details id="bkmrk-%D0%9F%D0%BE%D1%80%D1%8F%D0%B4%D0%BE%D0%BA-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8-%D0%B8%D0%BD"><summary>Порядок настройки интеграции</summary>

##### На стороне Росбанк

Для подключения партнера к системе необходимо получить от специалиста Росбанка пару логин/пароль для доступа к Личному кабинету.

##### Подписка на проект

Перед началом работы с API банка Вам необходимо перейти на сайт системы по адресу:  
Production: https://developer.rosbank.ru/devportal/apis  
Необходимо авторизоваться, нажав на кнопку «Sign In» и ввести предоставленные сотрудником Банка логин/пароль.  
После авторизации Вы увидите список доступных для Вас проектов:

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/fCFimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/fCFimage.png)

Необходимо выбрать в списке или при помощи поисковой строки проект «faster-payment-system» и войти в него, нажав на карточку проекта (<span style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">при поиске проекта необходимо выбирать самую актуальную версию проекта</span>). В открывшемся окне Вы увидите данные проекта, его название и версию:

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/XPFimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/XPFimage.png)

Далее переходим в раздел «<span lang="EN-US" style="mso-ansi-language: EN-US;">Subscriptions</span>»:

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/Y1Vimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/Y1Vimage.png)

На открывшейся странице нажать кнопку «<span lang="EN-US" style="mso-ansi-language: EN-US;">Subscribe</span>» и в появившемся окне вести название Вашего приложения:

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/4WBimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/4WBimage.png)

Ваше приложение появится в списке подписок

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/Icuimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/Icuimage.png)

Нажимаем «<span lang="EN-US" style="mso-ansi-language: EN-US;">Prod</span> <span lang="EN-US" style="mso-ansi-language: EN-US;">keys</span>» и далее кнопку «<span lang="EN-US" style="mso-ansi-language: EN-US;">Generate</span> <span lang="EN-US" style="mso-ansi-language: EN-US;">keys</span>».

У данного приложения появляется связка «<span lang="EN-US" style="mso-ansi-language: EN-US;">Customer</span> <span lang="EN-US" style="mso-ansi-language: EN-US;">key</span>» и «<span lang="EN-US" style="mso-ansi-language: EN-US;">Customer</span> <span lang="EN-US" style="mso-ansi-language: EN-US;">secret</span>»

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/GOOimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/GOOimage.png)

<span style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">Которые в последствии необходимо вписать в соответствующие поле в </span><span lang="EN-US" style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">ECVI</span><span style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">. Зайдите в </span><span lang="EN-US" style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">ECVI</span><span lang="EN-US" style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;"> </span><span style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">в Администрирование – Устройства – Кассы СБП нажмите на редактирование уже существующей кассы, либо нажмите на прямоугольник с карандашом справа наверху «Создать» и впишите «</span><span lang="EN-US" style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">Customer</span><span lang="EN-US" style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;"> </span><span lang="EN-US" style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">key</span><span style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">» и «</span><span lang="EN-US" style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">Consumer</span><span style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">-</span><span lang="EN-US" style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">secret</span><span style="font-size: 10.5pt; line-height: 110%; font-family: 'Calibri',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: minor-fareast; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: RU; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">».</span>

##### Запросы в Росбанк

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/VZaimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/VZaimage.png)

##### Авторизация

Получение временного токена

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/hvvimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/hvvimage.png)

Здесь требуется нажать <span lang="EN-US" style="mso-ansi-language: EN-US;">GET</span> <span lang="EN-US" style="mso-ansi-language: EN-US;">TEST</span> <span lang="EN-US" style="mso-ansi-language: EN-US;">KEY</span>

##### <span lang="EN-US" style="mso-ansi-language: EN-US;">Вызов API-методов</span>

Для дальнейшей работы с СБП Росбанк необходимо зарегистрировать кассу.  
Для этого понадобится следующий метод:

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/Bezimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/Bezimage.png)

Нужно указать ОГРН, <span lang="EN-US" style="mso-ansi-language: EN-US;">idempotence</span>-<span lang="EN-US" style="mso-ansi-language: EN-US;">key</span>, который генерируется в <span lang="EN-US" style="mso-ansi-language: EN-US;">ECVI</span>. Чтобы его сгенирировать вам необходимо в <span lang="EN-US" style="mso-ansi-language: EN-US;">ECVI</span>:

Зайдите в Администрирование – Устройства – кассы СБП, нажмите на прямоугольник с карандашом в правом верхнем углу «создать». В появившемся окне предварительно вы можете вписать название (потом его вы измените), номер (обязателен для заполнения, он всегда будет 1) и напротив “<span lang="EN-US" style="mso-ansi-language: EN-US;">idempotence</span>-<span lang="EN-US" style="mso-ansi-language: EN-US;">key</span>” нажмите на «Генерировать» (*нажать нужно один раз и больше не трогать*), скопируйте его и вставьте в соответствующее поле в ЛК Росбанка, как указано на скриншоте ниже. После этого в <span lang="EN-US" style="mso-ansi-language: EN-US;">ECVI</span> нажмите кнопку создать. К настройкам кассы в <span lang="EN-US" style="mso-ansi-language: EN-US;">ECVI</span> вернёмся чуть позже в этой инструкции. *Обратите внимание на то, что больше не надо нажимать кнопку «генерировать», иначе придётся данный ключ снова прописывать в ЛК Росбанка.*

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/zXiimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/zXiimage.png)

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/pbuimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/pbuimage.png)

Так<span style="mso-ansi-language: EN-US;"> </span>же<span style="mso-ansi-language: EN-US;"> </span>заполнить<span style="mso-ansi-language: EN-US;"> </span>необходимо<span style="mso-ansi-language: EN-US;"> </span>поля<span lang="EN-US" style="mso-ansi-language: EN-US;">: «address», «brandName», «city», «contactPhoneNumber», «countrySubDivisionCode», «mcc», «zip». </span>Для того, чтобы правильно заполнить нажмите на <span lang="EN-US" style="mso-ansi-language: EN-US;">Schema</span>, как указано на скриншоте раскроется поле в котором все данные расписаны.

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/CMQimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/CMQimage.png)

##### Настройка в ECVI

1\. Необходимо добавить во все существующие Юридические лица новые счета, с пометкой «Расчетный счет для СБП» для этого  
Перейдите в Администрирование – Отель – Юридические лица

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/4zEimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/4zEimage.png)

Напротив каждого Юр лица нажмите на карандаш. Обязательно проверьте чтобы было заполнено ИНН. Нажмите на «прямоугольник с карандашом» (создать) в появившемся окне создания нового счета заполните все данные и обязательно поставь галочку «Расчетный счет для СБП». Нажмите «сохранить» и «сохранить и вернуться к списку».

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/iJFimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/iJFimage.png)

2\. Создание типов платежей и платежей.  
Перейдите в Администрирование – Разное – справочник типов платежей  
Справа наверху нажмите на «прямоугольник с карандашом» (создать) в появившемся окне заполните:   
 1. Название (пример: СБП и (Юр лицо, по которому проводятся данные оплаты))  
 2. 1С ID  
Поставьте галочки   
 1. Платеж  
 2. Возврат  
 3. Быстрый платеж  
 4. Проводить по кассе  
 5. Включен  
После этого нажмите внизу кнопку «создать».

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/DUVimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/DUVimage.png)

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/9kyimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/9kyimage.png)

Перейдите в Администрирование – Разное – справочник типов платежей. Справа наверху нажмите на «прямоугольник с карандашом» (создать) в появившемся окне заполните:   
 1. Наименование (пример: СБП и (Юр лицо, по которому проводятся данные оплаты))  
 2. «тип платежа», тот, который вы только что создали для СБП.  
 3. Поставьте галочку «Включен».  
Нажмите кнопку создать.

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/9icimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/9icimage.png)

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/wK5image.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/wK5image.png)

3\. Создание Кассы СБП.  
Перейдите в Администрирование – устройства – Кассы СБП.  
Нажмите справа наверху на «прямоугольник с карандашом»(создать).

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/w8timage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/w8timage.png)

В появившемся окне вам необходимо заполнить:  
 1. Название (пример «Росбанк СБП (и указать Юр лицо)» для удобства пользования)  
 2. Юр лицо  
 3. Выбрать платёж, который вы создали ранее.  
 4. Указать номер (всегда 1)  
 5. Логин в банке  
 6. Идентификатор кассы   
 7. Consumer-key  
 8. Cosumer-secret  
Галочка Активности ставится тех поддержкой ECVI после проверки правильности настройки всех пунктов указанных в данной инструкции, которые указываются в ECVI.

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2022-09/scaled-1680-/gFJimage.png)](https://help.ecvi.ru/uploads/images/gallery/2022-09/gFJimage.png)

</details>##### Порядок работы интерфейса

При использовании соответствующего типа платежа (с признаком Быстрый платеж):

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2023-11/scaled-1680-/image.png)](https://help.ecvi.ru/uploads/images/gallery/2023-11/image.png)

По кнопке Сохранить будет генерироваться QR код с соответствующим диалоговым окном:

[![image.png](https://help.ecvi.ru/uploads/images/gallery/2023-11/scaled-1680-/KPSimage.png)](https://help.ecvi.ru/uploads/images/gallery/2023-11/KPSimage.png)

Гость считывает сгенерированный на экране QR код и оплачивает, при успешной оплате будет распечатан фискальный чек и оплата сохранится в счете гостя.