Интеграция Сбербанк эквайринг с RetailCRM

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

Вкладка «Дополнительные настройки«

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

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

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

3.1. Настройка модуля — Шлюз Юкассы

Вкладка «Настройки Юкасса»

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

Вкладка «Чеки закрытия»

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

Образец триггера для отправки чека закрытия

Вкладка «Чеки платежей с сайта»

1. Соответствие типов платежей RetailCRM аккаунтам ЮКасса — Настройте отдельные API доступы, для отправки чеков закрытия на кассы с сайта

   Чеки возможно отправить только по платежам, переданным с сайта официальными модулями RetailCRM

   Чеки формируются в соответствии с настройками предыдущей вкладки, по тому же URL

2. Нажимаем «Сохранить».

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

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

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

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

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 для работы модуля

ВАЖНО:
Обязательно должно быть так же активно чтение списка товаров

 Вопросы

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