Подробная инструкция по установке и активации

Содержание

1. Создание Ключа доступа к API
2. Вход в настройки модуля
3. Настройка модуля
   — Вкладка «Доступ»
   — Вкладка «Сбербанк эквайринг»(«Юкасса)»
4. Создание типов оплат

 1. Создание Ключа доступа к API

1. Войдите под своей учетной записью в RetailCRM с правами администратора.
2. Перейдите в Настройки/Интеграции/Ключи доступа к API.

3. Нажмите кнопку «Добавить».

4. Выберите тип доступа к магазину.

5. Отметьте магазин из списка, с которым будет работать модуль.
6. Отметьте методы из списка Разрешенные методы API. (Нужные методы указаны в Приложении 1).
7. Скопируйте ключ.
8.Нажмите “Сохранить”. 

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

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

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

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

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

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

Аккаунты Sberbank

Для добавления аккаунта нажимаем одноименную кнопку Добавить аккаунт Sberbank

Основные настройки

— Магазин. Выберете один из доступных магазинов для подключения модуля.

— В поля Логин и Пароль введите соответствующие данные аккаунта, который будет работать с выбранным магазином.
Альтернативой является работа по Токену, но мы рекомендуем использовать Логин и Пароль

— Версия ФФД. Указываем нужную версию ФФД.

— Чек-бокс: Активность аккаунта. Активирует аккаунт для возможности подключения и работы с аккаунтом в Сбербанк (НЕ ЯВЛЯЕТСЯ ПЕРЕВЕДЕНИЕМ АККАУНТА В БОЕВОЙ РЕЖИМ)

Дополнительные настройки:

— Время жизни счета — время в течении которого клиент может перейти по ссылке и оплатить счет. Можно указать время в секундах, если счета должны быть с коротким временем жизни (максимум 86400 секунд), или указать в часах, максимум 720 часов. (30 дней). Если за это время клиент не оплатил, счет будет не действительный и по нему придет отмена.

— Ссылка для перенаправления клиента после успешной оплаты. Если она заполнена, то перенаправление будет происходить на нее.

— Ссылка для перенаправления клиента после ошибки оплаты. Если она заполнена, то перенаправление будет происходить на нее.

— Тип оплаты Сбербанк при полной предоплате RetailCRM. Выберите один из возможных типов оплат.

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

— Чек-бокс: Использовать тестовый шлюз Сбербанк-Эквайринга. Если установить галочку «тестовый шлюз» — выставление счета сработает, значит аккаунт еще находится в тестовом режиме.

— Чек-бокс: Передача состава корзины. При активации, при выставлении счета в Сбербанк передается состав заказа.

— Чек-бокс: Использовать только для оплаты доставки. Функционал позволяет формировать оплату с назначением платежа — Оплата услуги Доставка. Подробнее в Приложение №5

— Чек-бокс: Разрешить осуществлять возвраты. Данный функционал позволит совершать возвраты прямо из заказа, НО при условии, что возвраты разрешены банком.

     Для работы отмен и возвратов напишите в техническую поддержку Сбербанка support_ecomm@sberbank.ru, с просьбой подключить Вам данную возможность.

— Чек-бокс: Сокращать ссылку на платеж. Функционал позволяет сокращать ссылку для удобной отправки через мессенджеры и соц.сети.

После нажмите Сохранить.

Callback-уведомления:

Способ 1. Написать со своей почты которая привязана к Сбербанку сообщение для подключения callback – так мы сможем принимать платежи по sberbank-pay и другим способам оплаты.

    Адрес технической поддержки Сбербанка — support_ecomm@sberbank.ru

Текст: Здравствуйте установите callback, url — https://marketplace.imb-service.ru/sberbank-pro/payment/callback для мерчанта ВАШ_МЕРЧАНТ.

Способ 2. Для самостоятельной настройки Callback-уведомлений нужно сделать следующие шаги:
1. Зайти в ЛК Сбербанк Эквайринг;

2. Настройки -> Основные -> Callback-уведомления: выбираем продавца и нажимаем «Включить Callback-уведомления»

3. Заполняем следующие поля:
1) Ссылки: https://marketplace.imb-service.ru/sberbank-pro/payment/callback
2) HTTP-метод — GET
3) Тип коллбэка — Статический
4) Тип подписи — Симметричный
5) Операции — Успешное списание, Отмены, Возврат, Платёж отклонён по таймауту

Поля, которые не упоминались, НЕ ЗАПОЛНЯЮТСЯ.

4. Сохранить

Приложение №1

Необходимые методы API RetailCRM для работы модуля

Приложение №2

Доступы в Сбербанк-Эквайринг находится в письме от Сбербанка, которое приходит на почту после заключения договора на использование системы Сбербанк-Эквайринг

Пояснение о доступах в Сбербанк-Эквайринг:

Доступы в Сбербанк-Эквайринг находится в письме от Сбербанка, которое приходит на почту после заключения договора на использование системы Сбербанк-Эквайринг.

Обратите внимание:

1. Логин должен быть оканчиваться на слово «-API», т.е. вида ЛОГИН-API. Логин оканчивающийся на -operator НЕ МОЖЕТ БЫТЬ использован;
2. Если ввести в настройки одновременно логин, пароль и token, модуль будет работать в режиме логина и пароля.
3. Через поддержку Сбербанк возможно вносить индивидуальные ограничения на аккаунт, например, запретить возврат.

Приложение №3. Вопросы

1. Обратите внимание. Через систему RetailCRM возможен только полный возврат. Частичный не предусмотрен. При этом подразумевается, что платежная система сама формирует и отправляет чек возврата
2. Нумерация заказов должна быть уникальна. В случае если ранее выставлялись счета через ЛК сбербанка, и номер заказа уже такой существует, счет на заказ с таким же номером заказа создан не будет.
3. Удаления выставленного счета возможно после отмены счета. При истечении времени ссылки счет также будет автоматически отменен. Если клиент выбрал иной способ оплаты, можно просто создать новый способ оплаты с нужной суммой.
4. Если возврат сделать не через модуль, а через ЛК Сбербанк, статус на возврат не изменится
5. Для возможности отмены счетов и возвратов, необходимо с Вашей почты написать в поддержку Сбербанка, для активации функционала отмены и возврата по API (reverse.do, decline.do и refund.do).
6. Модуль позволяет создавать любое количество счетов в каждом заказе.

Приложение №4. Проблема с передачей статусов оплат в RetailCRM

«Здравствуйте установите callback, url — https://marketplace.imb-service.ru/sberbank-pro/payment/callback
для мерчанта ВАШ_МЕРЧАНТ.»

• Ошибка формирования счета — доступ запрещен.   — Скорее всего аккаунт не переведен в боевой режим. Если установить галочку «тестовый шлюз» — выставление счета сработает, значит аккаунт еще находится в тестовом режиме.
• Невозможно выставить счет — не сходится сумма чека и товаров.  — Такое возможно если в названии товаров встречается спецсимволы, например %. $,#, *    Такие символы запрещены в чеке.
• Ответ Сбербанка — Пользователь не имеет разрешений на отклонение заказов   — это значит что в аккаунте были запрещены отмены. Необходимо активировать через тех. поддержку Сбербанка.

Приложение №5. Настройка для «Использовать только для оплаты доставки»

1. Добавляем свой аккаунт Сбербанк 2 раза и в одном из них проставьте чек-бокс «Использовать только для оплаты доставки». Таким образом мы получим один аккаунт для формирования ссылка на оплату заказа, а второй для формирования ссылки.Учтите: аккаунты должны быть подключены к разным магазинам, иначе нельзя будет создать 2 типа оплат.Использование тестового шлюза предусмотрено аккаунтом для примера, если для ваших настроек это не нужно — не выставляем.
2. Добавляем 2 типа оплаты и интегрируем их с магазинами.
3.  Дальше вам нужно лишь в заказе выставлять нужный тип оплаты.