Настройка приложения для работы с ЕРИП
Настройка приложения для работы с Интернет-эквайрингом
Настройка приложения для работы с E-POS
1.Настройка платежного модуля для работы с ЕРИП
1.1 Загрузите архив платежного модуля, распакуйте его и загрузите его содержимое в папку / app/ code / Expresspay/ Erip / вашей установки Magento 2.
1.2 Включите платежный модуль выполнив команды
$ php bin/magento module:enable Expresspay_Erip
$ php bin/magento setup:upgrade
Установка модуля оплаты Magento 2 через Composer
Введите следующие команды для установки модуля
composer config repositories.expresspay_erip git https://github.com/express-pay/magento2_erip.git
composer require expresspay/erip:1.0.0
$ php bin/magento setup:upgrade
1.3 Перейти в вкладку «Администрирование» на сайте.
1.4 Перейти в раздел «Stores» => «Configuration»(Рисунок 1).
Рисунок 1 – раздел «Configuration»
1.5 Перейти в раздел «Sales» => «Payment Methods»(Рисунок 2).
Рисунок 2 – раздел «Payment Methods»
1.6 Раскрыть метод оплаты ЕРИП.
1.7 Настраиваем метод оплаты:
1.7.1 Настройка модуля, для работы в тестовом режиме:
1.7.1.1 Из выпадающего списка «Использовать тестовый режим» выберите пункт «Yes».
1.7.1.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги»введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox
1.7.1.3 Поле «Секретное слово для цифровой подписи» заполняется только в том случае, если был выбран API ключ с параметрами «Применять цифровую подпись» и «Секретное слово».
1.7.1.4 Оставшиеся поля можно оставить без изменений, поскольку на работу модуля в тестовом режиме они не влияют.
1.7.2 Настройка модуля, для работы:
1.7.2.1 Из выпадающего списка «Использовать тестовый режим» выберите пункт «No».
1.7.2.2 Поля «API-ключ (токен) доступа к API» и «Номер услуги» заполнить значениями, которые указаны в Личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «API» (Рисунок 3, Рисунок 4)
Рисунок 3 – раздел «API» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»
Рисунок 4 – значение для заполнения полей «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи»
1.7.2.3 В разделе «Настройка» -> «Услуги» -> «API» личного кабинета сервиса «Экспресс Платежи» включите опцию «Применять цифровую подпись» и укажите значения в поле «Секретное слово». Значение из поля «Секретное слово» также следует указать в поле «Секретное слово для цифровой подписи» настройки приложения на вашем сайте.
1.7.2.4 Значение из поля «Адрес для получения уведомлений» необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 5). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 5). Данная опция позволяет автоматически изменять статус заказа после оплаты.
Рисунок 5 – раздел «Уведомления» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»
Рисунок 6 – включение уведомлений об оплате на сайт
1.7.2.5 Поля «Использовать цифровую подпись при получении уведомлений» и «Секретное слово для цифровой подписи уведомлений» используются для формирования цифровой подписи. Формирование цифровой подписи для передаваемых данных обеспечивает целостность информации и гарантирует, что передаваемые данные не были изменены посторонними лицами в процессе передачи.
При включении данной опции, значения в полях «Секретное слово для полученных уведомлений» в настройках приложения и «Секретное слово» в личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «Уведомления» должны быть одинаковыми.
1.7.2.6 Значение из поля «Путь ветки ЕРИП услуги» будет отображаться клиенту после формирования заказа и выставления счета в системе «Расчет» (Рисунок 7).
Рисунок 7 - путь ветки ЕРИП услуги при формировании заказа
1.7.2.7 Включение опции «Разрешено изменять ФИО плательщика» позволяет плательщику изменять ФИО при оплате заказа в дереве ЕРИП.
1.7.2.8 Включение опции «Разрешено изменять адрес плательщика» позволяет плательщику изменять адрес при оплате заказа в дереве ЕРИП.
1.7.2.9 Включение опции «Разрешено изменять сумму оплаты» позволяет плательщику изменять сумму при оплате заказа в дереве ЕРИП.
1.7.2.10 Включение опции «Показывать Qr-код» позволяет отображать клиенту после формирования заказа Qr-код для оплаты в мобильных приложениях банка. (Рисунок 8)
Рисунок 8 - отображение Qr-кода для оплаты
1.7.4 После настройки модуля нажмите кнопку «Save Config».
2. Настройка приложения для работы с Интернет-эквайрингом
2.1 Загрузите архив платежного модуля, распакуйте его и загрузите его содержимое в папку / app/ code / Expresspay/ Card / вашей установки Magento 2.
2.2 Включите платежный модуль выполнив команды
$ php bin/magento module:enable Expresspay_Card
$ php bin/magento setup:upgrade
Установка модуля оплаты Magento 2 через Composer
Введите следующие команды для установки модуля
composer config repositories.expresspay_card git https://github.com/express-pay/magento2_card.git
composer require expresspay/card:1.0.0
$ php bin/magento setup:upgrade
2.3 Перейти в вкладку «Администрирование» на сайте.
2.4 Перейти в раздел «Stores» => «Configuration»(Рисунок 1).
Рисунок 1 – раздел «Configuration»
2.5 Перейти в раздел «Sales» => «Payment Methods»(Рисунок 2).
Рисунок 2 – раздел «Payment Methods»
2.6 Раскрыть метод оплаты Интернет-эквайринг.
2.7 Настраиваем метод оплаты:
2.7.1 Настройка модуля, для работы в тестовом режиме:
2.7.1.1 Из выпадающего списка «Использовать тестовый режим» выберите пункт «Yes».
2.7.1.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги»введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox
2.7.1.3 Поле «Секретное слово для цифровой подписи» заполняется только в том случае, если был выбран API ключ с параметрами «Применять цифровую подпись» и «Секретное слово».
2.7.1.4 Оставшиеся поля можно оставить без изменений, поскольку на работу модуля в тестовом режиме они не влияют.
2.7.2 Настройка модуля, для работы:
2.7.2.1 Из выпадающего списка «Использовать тестовый режим» выберите пункт «No».
2.7.2.2 Поля «API-ключ (токен) доступа к API» и «Номер услуги» заполнить значениями, которые указаны в Личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «API» (Рисунок 3, Рисунок 4)
Рисунок 3 – раздел «API» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»
Рисунок 4 – значение для заполнения полей «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи»
2.7.2.3 В разделе «Настройка» -> «Услуги» -> «API» личного кабинета сервиса «Экспресс Платежи» включите опцию «Применять цифровую подпись» и укажите значения в поле «Секретное слово». Значение из поля «Секретное слово» также следует указать в поле «Секретное слово для цифровой подписи» настройки приложения на вашем сайте.
2.7.2.4 Значение из поля «Адрес для получения уведомлений» необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 5). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 5). Данная опция позволяет автоматически изменять статус заказа после оплаты.
Рисунок 5 – раздел «Уведомления» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»
Рисунок 6 – включение уведомлений об оплате на сайт
2.7.2.5 Поля «Использовать цифровую подпись при получении уведомлений» и «Секретное слово для цифровой подписи уведомлений» используются для формирования цифровой подписи. Формирование цифровой подписи для передаваемых данных обеспечивает целостность информации и гарантирует, что передаваемые данные не были изменены посторонними лицами в процессе передачи.
При включении данной опции, значения в полях «Секретное слово для полученных уведомлений» в настройках приложения и «Секретное слово» в личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «Уведомления» должны быть одинаковыми.
2.7.4 После настройки модуля нажмите кнопку «Save Config».
3.Настройка платежного модуля для работы с E-POS
3.1 Загрузите архив платежного модуля, распакуйте его и загрузите его содержимое в папку / app/ code / Expresspay/ Epos / вашей установки Magento 2.
3.2 Включите платежный модуль выполнив команды
$ php bin/magento module:enable Expresspay_Epos
$ php bin/magento setup:upgrade
Установка модуля оплаты Magento 2 через Composer
Введите следующие команды для установки модуля
composer config repositories.express-pay_epos git https://github.com/express-pay/magento2_epos.git
composer require expresspay/epos:1.0.0
$ php bin/magento setup:upgrade
3.3 Перейти в вкладку «Администрирование» на сайте.
3.4 Перейти в раздел «Stores» => «Configuration»(Рисунок 1).
Рисунок 1 – раздел «Configuration»
3.5 Перейти в раздел «Sales» => «Payment Methods»(Рисунок 2).
Рисунок 2 – раздел «Payment Methods»
3.6 Раскрыть метод оплаты E-POS.
3.7 Настраиваем метод оплаты:
3.7.1 Настройка модуля, для работы в тестовом режиме:
3.7.1.1 Из выпадающего списка «Использовать тестовый режим» выберите пункт «Yes».
3.7.1.2 В полях «API-ключ (токен) доступа к API» и «Номер услуги»введите значения, которые доступны по следующей ссылке: https://express-pay.by/docs/api/v1#sandbox
3.7.1.3 Поле «Секретное слово для цифровой подписи» заполняется только в том случае, если был выбран API ключ с параметрами «Применять цифровую подпись» и «Секретное слово».
3.7.1.4 Оставшиеся поля можно оставить без изменений, поскольку на работу модуля в тестовом режиме они не влияют.
3.7.2 Настройка модуля, для работы:
3.7.2.1 Из выпадающего списка «Использовать тестовый режим» выберите пункт «No».
3.7.2.2 Поля «API-ключ (токен) доступа к API» и «Номер услуги» и «Номер услуги в E-POS» заполнить значениями, которые указаны в Личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «API» (Рисунок 3, Рисунок 4)
Рисунок 3 – раздел «API» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»
Рисунок 4 – значение для заполнения полей «API-ключ (токен) доступа к API» и «Номер услуги в сервисе «Экспресс Платежи»
3.7.2.3 В разделе «Настройка» -> «Услуги» -> «API» личного кабинета сервиса «Экспресс Платежи» включите опцию «Применять цифровую подпись» и укажите значения в поле «Секретное слово». Значение из поля «Секретное слово» также следует указать в поле «Секретное слово для цифровой подписи» настройки приложения на вашем сайте.
3.7.2.4 Значение из поля «Адрес для получения уведомлений» необходимо скопировать в личный кабинет сервиса «Экспресс Платежи» в раздел «Настройка» -> «Услуги» -> «Уведомления» (Рисунок 5). Значение необходимо поместить в поле «URL для уведомлений», предварительно включив опцию «Получать уведомления об оплате на URL» (Рисунок 5). Данная опция позволяет автоматически изменять статус заказа после оплаты.
Рисунок 5 – раздел «Уведомления» в настройках услуг в личном кабинете сервиса «Экспресс Платежи»
Рисунок 6 – включение уведомлений об оплате на сайт
3.7.2.5 Поля «Использовать цифровую подпись при получении уведомлений» и «Секретное слово для цифровой подписи уведомлений» используются для формирования цифровой подписи. Формирование цифровой подписи для передаваемых данных обеспечивает целостность информации и гарантирует, что передаваемые данные не были изменены посторонними лицами в процессе передачи.
При включении данной опции, значения в полях «Секретное слово для полученных уведомлений» в настройках приложения и «Секретное слово» в личном кабинете сервиса «Экспресс Платежи» в разделе «Настройка» -> «Услуги» -> «Уведомления» должны быть одинаковыми.
3.7.2.6 Включение опции «Разрешено изменять ФИО плательщика» позволяет плательщику изменять ФИО при оплате заказа в дереве E-POS.
3.7.2.7 Включение опции «Разрешено изменять адрес плательщика» позволяет плательщику изменять адрес при оплате заказа в дереве E-POS.
3.7.2.8 Включение опции «Разрешено изменять сумму оплаты» позволяет плательщику изменять сумму при оплате заказа в дереве E-POS.
3.7.4 После настройки модуля нажмите кнопку «Save Config».