Инструкция по подключению

1.  Получение доступов от Сбербанка:
— Инструкция;
— Инструкция для потала разработчика.
2. Подключение «Платити QR»;
3. Вход в настройки модуля:
— API-ключ;
— Настройка модуля.
4. Создание типов оплат
Приложение 1

1. Получение доступов от Сбербанк

1. Подписать Договор на сервис Плати QR: https://www.sberbank.ru/ru/s_m_business/bankingservice/platiqr;
2. После подписания Договора, необходимо зарегистрироваться на портале согласно Инструкции* — переходим в соответствующий раздел;
3. Для создания организации, получения регистрационных данных (идентификатор терминала мерчанта TID и привязке договора, необходимо передать Анкету (скачать) для интеграции на Боевом доступе по адресу технической поддержки: support@ecom.sberbank.ru c отметкой «Продукт: QR.API, регистрации организации, API V3.0.0»; — В ответ поступит информация с присвоенным номером MemberId — важный параметр — и в течение 3 дней будет создана Организация;
4. Если организация была создана при входе на портал под СберБизнесID, для дальнейшей настройки вам так же необходимо обратится к менеджеру Сбербанка для заключения договора и получить MemberID организации. (писать по данным из пункта выше);
5. Техническая поддержка регистрирует Организацию и направляет вам письмо с информацией о передаче прав для начала работы (в течении 3-х рабочих дней);
6. После регистрации Организации, необходимо совершить действия указанные в Инструкции для потала разработчика**— переходим в соответствующий раздел;
7. Для подключения к Плати QR продавца, необходимо на портале в списке API выбрать – Плати QR*** — переходим в соответствующий раздел;

Инструкция*

1. Переходим по ссылке: https://api.developer.sber.ru и нажимаем Зарегистрироваться;
2. На открывшейся форме нужно пройти стандартную регистрацию с введением почты или войти по SberID/Сбер Бизнес ID — перед регистрацией прочтите примечание. Для первичной регистрации физ. лица нажмите «зарегистрироваться».Примечание:
   Если воспользоваться стандартной регистрацией с введением почты, то аккаунт будет создан на ФЛ и далее потребуются дополнительные действия для регистрации Организации — делаем действия после Примечания, а потом возвращаемся к Получение доступов от Сбербанк пункт 3;
   
   Если войти по Сбер Бизнес ID с использованием Сбербанк Бизнес Онлайн, Организация будет создана автоматически, но для завершения настройки подключения требуется заключить договор, обратившись к менеджеру Сбербанка. Инструкция по входу через Сбер Бизнес ID: https://api.developer.sber.ru/how-to-use/sberbusiness_id ; — возвращаемся в раздел Получение доступов от Сбербанк пункт 4.
3. При регистрации физ лица на указанный адрес электронной почты поступит письмо для подтверждения:
   
   После подтверждения учетной записи по ссылке вы вернетесь на главную страницу портала. Для входа в учетную запись (в личный кабинет) нажмите на кнопку «Войти» в правом верхнем углу.
   После входа на портал под своей учетной записью отредактируйте свой профиль (в правом верхнем углу) – укажите ФИО и номер телефона. Здесь же можно сменить пароль.
4. — возвращаемся в раздел Получение доступов от Сбербанк пункт 3.

Инструкция для портала разработчика**

Переключение ЛК на режим «Организация»:

1. После регистрации организации и присвоения MemberId необходимо зайти в ЛК, затем в раздел «Мой профиль» и переключиться в режим организации.
   
2. Чтобы при входе в ЛК попадать в режим организации отметьте чек-бокс «установить по умолчанию» после включения режима организации(1), после отметки чек-бокса будет запрошено подтверждение(2)

Создание приложения и выпуск сертификата:

1. Для создания приложения необходимо войти в ЛК в режиме организации и нажать «создать новое приложение»:
2. Откроется форма создания приложения (1), в которой необходимо указать название: Плати QR — RetailCRM и произвольное описание(можно прописать тоже, что и в названии).  Поле OAuth Redirect URI не используется и не требует заполнения.
   
   Одновременно с созданием приложения необходимо выпустить сертификат(2). Сертификат выпускается на почту личного аккаунта.
   Придумайте пароль состоящий из латинских букв и цифр длиной не менее 8 символов. — понадобится в дальнейшей настройке
   Работа с сертификатами описана по ссылке: https://api.developer.sber.ru/how-to-use/create_certificate — для ознакомленияВАЖНО!!! После создания приложения откроется окно с ClientID и ClientSecret. ClientSecret будет показан 1 раз, его необходимо скопировать и сохранить себе отдельно для использования в дальнейшем при интеграции.
3. — возвращаемся в раздел Получение доступов от Сбербанк пункт 7.

 «Плати QR»***

1. Войдите в каталог сервисов, найдите продукт Плати QR и нажмите «Подключить»;

Важно!!! если у вас зарегистрирована организация, но нет договора, подключение сервиса будет невозможно:

2. Выбираем Тариф QR Продавца:

Примечание: Если  тарифы не доступны, то необходимо написать об этом на почту support@ecom.sberbank.ru c пометкой «продукт: QR.API, создание договора».
   Уточнить какой тариф/сценарий подключается и приложить Анкету (скачать).

3. На следующем шаге в ниспадающем списке укажите название приложения из пункта 2 Инструкция для потала разработчика;

4. Проверьте выбранные настройки и завершите процесс нажатием кнопки «Подключить». Подписка завершена.

 3. Вход в настройки модуля

API-ключ

1. Перейдите в Настройки/Интеграции/Маркетплейс.
2.  Выберите модуль.

3. Нажмите кнопку «Перейти в личный кабинет». При первом входе откроется страница регистрации.

Настройка модуля

— Вкладка «Доступ»

1. Вводим ссылку на RetailCRM
2. Вставляем скопированный ранее API-ключ и ссылку на RetailCRM
3. Нажимаем «Сохранить».

— Вкладка «Аккаунты»

Для добавления аккаунта необходимо нажать на одноименную кнопку. В появившемся окне нужно вписать название аккаунта (любое). После нажмите «Сохранить».

Максимально возможно добавить до 4 магазинов

Затем переходим в редактирование — «Редактировать».

— Вкладка «Основные настройки»

Заполняем настройки:

Подробная инструкция по их получению — https://api.developer.sber.ru/product/PlatiQR/doc/v1/QR_API_doc3

Сlient ID Приложения — из пункта 2 Создание приложения (Инструкция для портала разработчика https://api.developer.sber.ru/);

Client Secret Приложения — из пункта 2 Создание приложения (Инструкция для портала разработчика https://api.developer.sber.ru/);

MemberId аккаунта — отправляют при регистрации компании в письме от Сбербанка(https://api.developer.sber.ru/);

Сертификат и пароль от него — в портале разработчика (https://api.developer.sber.ru/)

IdQR устройства — после подключения сервиса Плати QR СБП (раздел «Плати QR»***) нужно запросить IdQR у поддержки(ЛК Сбербизнес).

—  Вкладка «Дополнительные»

Для удобства отправки ссылки в СМС-сообщении или в мессенджере мы добавили функционал по сокращению ссылки.

4. Создание типов оплат

1. Перейдите в RetailCRM/Администрирование/Справочники/Типы оплат. Нажмите кнопку «Добавить»;
2. Введите название типа оплаты (Пример: Сбербанк-Эквайринг);
3. Введите символьный код типа оплаты (Пример: sber-shop);
4. Выберите из списка «Интегрировать с» нужный магазин, с которым будет работать указанный аккаунт в модуле;
5. В поле «Статусы счетов» — нажмите на кнопку «Перейти к настройке». Соотнесите статусы платежей со статусами оплат из RetailCRM. Нажмите Сохранить.

Подсказка.

Не забудьте разрешить новые способы оплаты в настройках типов доставки, иначе оплаты будут недоступны.

ДЛЯ ИНТЕГРАЦИОННЫХ ТИПОВ ОПЛАТЫ НЕЛЬЗЯ ВЫБИРАТЬ НАЛОЖЕННЫЙ ПЛАТЁЖ!

Учтите: статусы по только созданным заказом обновляются каждые 5 минут. Статусы за 14 дней — раз в 3 часа.

Приложение 1

Необходимые методы API для ключа RetailCRM: