Интеграция Сбербанк эквайринг с RetailCRM
Содержание
- Создание Ключа доступа к API
- Вход в настройки модуля
- Настройка модуля
— Вкладка «Доступ»
— Вкладка «Сбербанк эквайринг»
- Создание типов оплат
1. Создание Ключа доступа к API
- Войдите под своей учетной записью в RetailCRM с правами администратора.
- Перейдите в Настройки/Интеграции/Ключи доступа к API.

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

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

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


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

3. Настройка модуля — Шлюз Сбербанка
Вкладка «Доступ RetailCRM»
- Вводим ссылку на RetailCRM;
- Вставляем скопированный ранее API-ключ и ссылку на RetailCRM;
- Выбираем желаемый способ интеграции. ВАЖНО: При переключении между способами интеграции, типы платежей можно оставить те же
- Нажимаем «Сохранить».

Вкладка «Доступ»
- В поля Логин и Пароль введите соответствующие данные аккаунта, который будет работать с выбранным магазином.
Альтернативой логина и пароля может быть уникальный token (API-ключ) Сбербанк. Но обратите внимание, что при использовании token не доступен функционал возвратов.
- Нажимаем «Сохранить».

Вкладка «Сбербанк эквайринг»
— Магазин. Выберете один из доступных магазинов для подключения модуля.
— Время жизни счета — время в течении которого клиент может перейти по ссылке и оплатить счет. Можно указать время в секундах, если счета должны быть с коротким временем жизни (максимум 86400 секунд), или указать в часах, максимум 720 часов. (30 дней). Если за это время клиент не оплатил, счет будет не действительный и по нему придет отмена.
— Тип оплаты Сбербанк при полной предоплате RetailCRM. Выберите один из возможных типов оплат: «Предоплата 100%», или «Полный расчет».

Вкладка «Дополнительные настройки«
— Ссылка для перенаправления клиента после успешной оплаты. Если она заполнена, то перенаправление будет происходить на нее.
— Ссылка для перенаправления клиента после ошибки оплаты. Если она заполнена, то перенаправление будет происходить на нее.
— Версия ФФД. Указываем нужную версию ФФД.
— Поле передаваемое в description. Передавать код магазина в описание. Для активации данного функционала, необходимо запросить разрешение Сбербанка для использования поля описание.
— Чек-бокс: Передача состава корзины. При активации, при выставлении счета в Сбербанк передается состав заказа.
— Чек-бокс: Сокращать ссылку на платеж
После нажмите Сохранить.
ВАЖНО:
по юкассе. надо добавить в доку что надо на ключе право — чтение списка товаров

3.1. Настройка модуля — Шлюз Юкассы
Вкладка «Настройки Юкасса»
- Идентификатор магазина (shop_id) и Ключ API (secret_key) — логин и пароль от интеграционной записи Юкасса. Найти можно в настройках API интеграции в ЛК Юкассы.
- Подтверждение оплаты в RetailCRM — Настройка, позволяющая использовать Холдирование
- Система налогообложения магазина —
- Ссылка для перенаправления после успешного платежа и после ошибки — укажите ссылки, по которым будет совершена автоматическая переадресация в случае успеха/ошибки при оплате
- Сокращать ссылку на платеж — формирует сокращённую(короткую) ссылку для оплаты
- Передача состава корзины — передаёт в чеке перечень товаров из заказа Retail
- Подменять состав корзины — Вместо товаров корзины принудительно передаёт к чек указанное наименование. Тип расчёта в этом случае будет всегда «Предоплата 100%»
При активной подмене, она же действует и на закрывающий чек
ВАЖНО: С помощью подменяемого товара можно передавать в чек отображаемый номер заказа Retail. Для этого добавьте переменную {orderNumber} в поле «Название товара»
- URL для уведомлений (Обязательный для настройки в ЮKassa для всех событий) — указывается в соответствующем поле в настройках интеграции API в Юкассе. Без этого адреса Юкассе будет некуда присылать статусы оплаты.
- Нажимаем «Сохранить».

Вкладка «Чеки закрытия»
- URL триггера RetailCRM на изменение заказа, для отправить чека закрытия в ЮKassa — данный URL предназначен для встраивание в триггер(на изменения заказа/перехода в определенный статус)
- Статусы непередаваемых в чеке товаров — товары в заказе в этих статусах не будут передаваться в чеках закрытия
- Тип расчета — тип расчёта для чеков закрытия
- Нажимаем «Сохранить».
Образец триггера для отправки чека закрытия

Вкладка «Чеки платежей с сайта»
- Соответствие типов платежей RetailCRM аккаунтам ЮКасса — Настройте отдельные API доступы, для отправки чеков закрытия на кассы с сайта
Чеки возможно отправить только по платежам, переданным с сайта официальными модулями RetailCRM
Чеки формируются в соответствии с настройками предыдущей вкладки, по тому же URL
- Нажимаем «Сохранить».

4. Создание типов оплат
- Перейдите в RetailCRM/Администрирование/Справочники/Типы оплат. Нажмите кнопку «Добавить»;
- Введите название типа оплаты (Пример: Сбербанк-Эквайринг);
- Введите символьный код типа оплаты (Пример: sber-shop);
- Выберите из списка «Интегрировать с» нужный магазин, с которым будет работать указанный аккаунт в модуле;
- В поле «Статусы счетов» — нажмите на кнопку «Перейти к настройке». Соотнесите статусы платежей со статусами оплат из RetailCRM. Нажмите Сохранить.
Подсказка.
Не забудьте разрешить новые способы оплаты в настройках типов доставки, иначе оплаты будут недоступны.
ДЛЯ ИНТЕГРАЦИОННЫХ ТИПОВ ОПЛАТЫ НЕЛЬЗЯ ВЫБИРАТЬ НАЛОЖЕННЫЙ ПЛАТЁЖ!
Пояснение о доступах в Сбербанк-Эквайринг:
Доступы в Сбербанк-Эквайринг находится в письме от Сбербанка, которое приходит на почту после заключения договора на использование системы Сбербанк-Эквайринг.
Обратите внимание:
- Логин должен быть оканчиваться на слово «-API», т.е. вида ЛОГИН-API. Логин оканчивающийся на -operator НЕ МОЖЕТ БЫТЬ использован;
- Если ввести в настройки одновременно логин, пароль и token, модуль будет работать в режиме логина и пароля.
- Через поддержку Сбербанк возможно вносить индивидуальные ограничения на аккаунт, например, запретить возврат.
Callback-уведомления:
Способ 1. Написать со своей почты которая привязана к Сбербанку сообщение для подключения callback – так мы сможем принимать платежи по sberbank-pay и другим способам оплаты.
Адрес технической поддержки Сбербанка — support_ecomm@sberbank.ru
Текст: Здравствуйте установите callback, url — https://sberbank.imb-service.ru/payments/pay-callback.html для мерчанта ВАШ_МЕРЧАНТ.
Способ 2. Для самостоятельной настройки Callback-уведомлений нужно сделать следующие шаги:
1. Зайти в ЛК Сбербанк Эквайринг;
2. Настройки -> Основные -> Callback-уведомления: выбираем продавца и нажимаем «Включить Callback-уведомления»
3. Заполняем следующие поля:
1) Ссылки: https://sberbank.imb-service.ru/payments/pay-callback.html
2) HTTP-метод — GET
3) Тип коллбэка — Статический
4) Тип подписи — Симметричный
5) Операции — Успешное списание, Отмены, Возврат, Платёж отклонён по таймауту
Поля, которые не упоминались, НЕ ЗАПОЛНЯЮТСЯ.
4. Сохранить

Приложение №1
Необходимые методы API RetailCRM для работы модуля

ВАЖНО:
Обязательно должно быть так же активно чтение списка товаров
Вопросы
- Обратите внимание. Через систему RetailCRM возможен только полный возврат. Частичный не предусмотрен (только через ЛК Сбера). При этом подразумевается, что платежная система сама формирует и отправляет чек возврата
- Нумерация заказов должна быть уникальна. В случае если ранее выставлялись счета через ЛК сбербанка, и номер заказа уже такой существует, счет на заказ с таким же номером заказа создан не будет.
- Удаления выставленного счета возможно после отмены счета. При истечении времени ссылки счет также будет автоматически отменен. Если клиент выбрал иной способ оплаты, можно просто создать новый способ оплаты с нужной суммой.
- Если возврат сделать не через модуль, а через ЛК Сбербанк, статус на возврат не изменится
- Для возможности отмены счетов и возвратов, необходимо с Вашей почты написать в поддержку Сбербанка, для активации функционала отмены и возврата по API (reverse.do, decline.do и refund.do).
- Модуль позволяет создавать любое количество счетов в каждом заказе.
- Возможные ошибки при работе с модулем:
- Ошибка формирования счета — доступ запрещен. — Скорее всего аккаунт не переведен в боевой режим. Если установить галочку «тестовый шлюз» — выставление счета сработает, значит аккаунт еще находится в тестовом режиме.
- Невозможно выставить счет — не сходится сумма чека и товаров. — Такое возможно если в названии товаров встречается спецсимволы, например %. $,#, * Такие символы запрещены в чеке.
- Ответ Сбербанка — Пользователь не имеет разрешений на отклонение заказов — это значит, что в аккаунте были запрещены отмены. Необходимо активировать через тех. поддержку Сбербанка.