Документация Сбер эквайринг

Лицензионный ключ отправляется автоматически на почту аккаунта покупателя, если письма Вы не нашли, проверьте папку спам, если письмо в спаме, то пожалуйста поставьте отметку не спам. При отсутствии ключа в папке спам напишите в поддержку.

Купить модуль можно по ссылке.
После этого вам выдадут логин и пароль api, эти данные используйте в модуле.

Магазины версии 3 Установка:

1) Установить модуль через Установщик модулей, в модификациях (менеджер дополнений) нажать обновить
2) Установить модуль в админ панель -> Дополнения -> Оплата -> Сбербанк Эквайринг-> Установить (если вы не видите модуль то файлы модуля не были записаны, выполните установку вручную)
3) Ввести настройки модуля: имя и пароль Api
4) Сообщить Сбербанку ссылку callback - указана в настройках модуля (не обязательно, но рекомендуется, опция в настройках делать запрос на страницы удачной оплаты уже включена по умолчанию, если вы включили callback на стороне банка, то отключите опцию Проверка платежа и смена статуса заказа на странице удачной оплаты) ВНИМАНИЕ если у вас был установлен стоковый модуль, то ссылка на уведомления может установлена на него, обязательно смените ссылку на новый адрес от данного модуля
5) Установить статус включено

Установка вручную
1) Скопируйте все из папки upload в корень сайта
3) обновите кеш модификаторов и кеш twig
4) вернитесь к основной установке пункт 2

Магазины версии 2.0, 2.1, 2.2, 2.3 Установка:
1) Установить модуль через Установщик модулей, в модификациях (менеджер дополнений) нажать обновить
2) Установить модуль в админ панель -> Дополнения -> Оплата -> Сбербанк Эквайринг-> Установить (если вы не видите модуль то файлы модуля не были записаны, воспользуйтесь фиксом по ссылке или выполните установку вручную)
3) Ввести настройки модуля: имя и пароль Api
4) Сообщить Сбербанку ссылку callback - указана в настройках модуля (не обязательно, но рекомендуется, опция в настройках делать запрос на страницы удачной оплаты уже включена по умолчанию, если вы включили callback на стороне банка, то отключите опцию Проверка платежа и смена статуса заказа на странице удачной оплаты) ВНИМАНИЕ если у вас был установлен стоковый модуль, то ссылка на уведомления может установлена на него, обязательно смените ссылку на новый адрес от данного модуля
5) Установить статус включено

Установка вручную
1) Скопируйте все из папки upload в корень сайта
2) переименуйте install.xml в sb.ocmod.xml и установите через установщик или положите в папку system
3) обновите кеш модификаторов
4) вернитесь к основной установке пункт 2

Магазины версии 1.5 Установка:

1) Скопировать все из папки Upload в корень сайта
2) Установить модуль в админ панель -> Дополнения -> Оплата -> Сбербанк Эквайринг-> Установить
3) Ввести настройки модуля: имя и пароль Api
4) Сообщить Сбербанку ссылку callback - указана в настройках модуля (не обязательно, но рекомендуется. Опция в настройках делать запрос на страницы удачной оплаты уже включена по умолчанию, если вы включили callback на стороне банка, то отключите опцию Проверка платежа и смена статуса заказа на странице удачной оплаты) ВНИМАНИЕ если у вас был установлен стоковый модуль, то ссылка на уведомления может установлена на него, обязательно смените ссылку на новый адрес от данного модуля
5) Установить статус включено

Обновление версии модуля

1) Сделайте резервную копию сайта (файлы и база)
2) Удалить модификатор модуля (только для магазинов 2.х)
3) Произвести стандартную установку из раздела установка для Вашей версии магазина с перезаписью файлов
4) Обязательно ввести повторно пароль api и пересохранить настройки, обязательно обновить кеш (для опенкарт 3 обновить еще кеш twig)
5) Если файлы template модуля корректировались под шаблон обязательно произвести повторную коррекцию.
6) Если вы сообщали банку ссылку callback и просили включить уведомления о оплате на данный адрес, убедитесь что у банка установлена корректная ссылка (через поддержку банка) и в модуле она не изменилась (указана в настройках модуля) , если вы не сообщали банку ссылку, то пропустите этот шаг.

Подключение онлайн-кассы

1. Для работы без дополнительных модулей зарегистрируйте кассу Атол-онлайн по ссылке (если вы выбрали урезанный тариф без офд, зарегистрируйте ОФД.РУ по ссылке), либо зарегисрируйте кассу FERMA в ОФД.РУ, зарегисрируйте кассу в фнс
2. В личином кабинете банка найдите раздел фискализация, если такой раздел не видите то обратитесь в поддержку банка для включения данного раздела
3. Выберете вашу кассу из списка доступных
4. Введите настройки от Вашей кассы
5. В настройках модуля активируйте Передача корзины - ДА (активен по умолчанию)

Стационарную кассу Эвотор вы можете подключить через модуль https://store.pe-art.ru/kkm/evotor

Маркировка

Для работы с маркированными товарами включите в настройках модуля опцию Маркировка - ДА
Установите признак сбособа расчета ПРЕДОПЛАТА
Второй чек ПОЛНЫЙ РАСЧЕТ проводится через кабинет банка, присвойте код маркировки товару в специальном поле.

Включение проверки сертификата сервера в настройках модуля
Обязательно положите файл sbcert.pem для реальных платежей, sbcert-test.pem (для тестовых платежей)  в папку system/art_extra вашего сайта (при необходимости создайте папку art_extra) в итоге путь к файлу выглядит system/art_extra/sbcert.pem

Внимание! папка system в версиях магазинов 3.х может располагатся не в корне сайта, актуальное местоположение ищите в файле config.php
Скачать актуальный файл сертификата можно через браузер (сертификат pem) для реальных https://securepayments.sberbank.ru/payment/rest/ для тестовых https://3dsec.sberbank.ru/payment/rest/

Работает только в режиме curl.

Внимание! На сервере необходима библиотека cURL 7.74.0 и выше, а также SSL с поддержкой FIPS  (не ниже SSL Version OpenSSL/1.0.2k-fips)
В противном случае если ваши требования сервера не подходят и\или вы получаете ошибку no data при включении проверки сертификата, необходимо отключить проверку в настройках модуля для возможности работы.

FAQ

1. При переходе на оплату пишет No Data или Произошла ошибка свжитесь с менеджером

Смотреть журнал ошибок - расшифровка ошибок пункт 2, 3, 4, ошибки с кодом Sbacuiring error: ТЕКСТ - не описанные в данном руководстве вы можете найти в документации банка

2. Кнопка для повторной оплаты не появляется в личном кабинете

Если шаблон личного кабинета далек от стандартного, то кнопка в личном кабинете может не появиться

Магазины 3.0 необходима корректировка файла catalog\view\theme\default\template\extension\payment\sbacquiring_aclink.twig по ваш шаблон.

Магазины 2.0, 2.1, 2.2 , 2.3 провести изменения в install.xml

     $(\'a.btn-info

     заменить на $(\'a

     или btn-info заменить на класс кнопки просмотра заказа

переименовать в install.ocmod.xml и установить через установщик (перед этим удалив старый модификатор)

не забыть обновить кэш

Магазины 1.5 , для вывода кнопки необходимо провести изменения описанные выше в файле vqmod/xml/sbacuiring.xml
 

3. На тестовых платежах при вводе данных реальной карты не проходит оплата

8. Доступные переменные:

Некоторые переменные могут не работать в зависимости от версии магазина или места вывода

$href$ - ссылка на оплату
$orderlist$ - список заказа
$itogo$ - итого заказа в валюте магазина
$itogobez$ - итого заказа в валюте магазина без вывода валюты
$itogozakaz$ - итого заказа в валюте заказа без вывода валюты
$totals$ - итого заказа в валюте заказа
$komis$ - комиссия в процентах из настроек
$total-komis$ - подсчитанная комиссия
$plus-komis$ - сумма с комиссией
$order_id$ - номер заказа
$invoice_no$ - номер счета
$invoice_prefix$ - префикс счета
$store_id$ - id магазина
$store_name$ - название магазина
$store_url$ - url магазина
$customer_id$ - id покупателя
$customer_group_id$ - id группы покупателя
$firstname$ - имя
$lastname$ - фамилия
$telephone$ - телефон
$fax$ - факс
$email$ - почта
$payment_firstname$ - имя плательщика
$payment_lastname$ - фамилия плательщика
$payment_company$ - компания плательщика
$payment_address_1$ - адрес плательщика
$payment_address_2$ - адрес2 плательщика
$payment_postcode$ - индекс плательщика
$payment_city$ - город плательщика
$payment_zone_id$ - id гео зоны плательщика
$payment_zone$ - гео зона плательщика
$payment_zone_code$ - код зоны плательщика
$payment_country_id$ - id страны плательщика
$payment_country$ - страна плательщика
$payment_iso_code_2$ - iso код плательщика
$payment_iso_code_3$ - iso код плательщика
$payment_address_format$ - формат адреса плательщика
$payment_method$ - метод оплаты
$payment_code$ - код оплаты    
$shipping_firstname$ - имя для доставки
$shipping_lastname$ - фамилия для доставки
$shipping_company$ - компания для доставки
$shipping_address_1$ - адрес доставки
$shipping_address_2$ - адрес2 доставки
$shipping_postcode$ - индекс для доставки
$shipping_city$ - город доставки
$shipping_zone_id$ - id гео зоны доставки
$shipping_zone$ - гео зона доставки
$shipping_zone_code$ - код зоны доставки
$shipping_country_id$ - id страны доставки
$shipping_country$ - страна доставки
$shipping_iso_code_2$ - iso код доставки
$shipping_iso_code_3$ - iso код доставки
$shipping_address_format$ - формат адреса доставки
$shipping_method$ - метод доставки
$shipping_code$ - код метода доставки
$comment$ - комментарий
$total$ - итого (в валюте по умолчанию)
$order_status_id$ - id статуса заказа
$order_status$ - статус заказа
$language_id$ - id языка
$language_code$ - код языка
$language_filename$ - файл языка
$language_directory$ - дирректория языка
$currency_id$ - id валюты
$currency_code$ - код валюты
$currency_value$ - курс валюты
$ip$ - ip
$forwarded_ip$ - переадресованный ip
$user_agent$ - юзер агент
$accept_language$ - язык
$date_modified$ - дата изменения заказа
$date_added$ - дата создания заказа

Переменные и использование полей из Simple:
Название берется из вкладки "Настройка полей" строка ID

Для Simple 4.x
$paymentsimple4_имяполя$ - поле привязанное к адресу оплаты
$shippingsimple4_имяполя$ - поле привязанное к адресу доставки
$simple4_имяполя$ - поле привязанное к учетной записи покупателя или поле привязанное к методу

Выбор отображения отчества покупателя
Пример:
Отчество: $simple4_otchestvo$
 

9. в просмотре заказа админ панели в заголовке отображается название метода оплаты

проблема не поправима , сам опенкарт 3ей версии грузит дефолтный язык и заголовок метода оплаты при обращению к методу оплаты для активации вкладки. 

10. Страница выглядит не корректно (поехали стили, текст и тд)

необходима правка шаблона страницы модуля под вашу тему
все шаблоны в папке catalog\view\theme\default\template\extension\payment\sbacquiring*.tpl(twig)
за пример можно взять catalog\view\theme\ВАШАТЕМА\template\common\success.twig(tpl)
для магазинов 3.х не забывайте чистить кеш шаблонов на главной админ панели шестеренка вверху справа