About This File
Модуль добавляет возможность оплаты заказов через eCommerce Connect (https://ecommerce.upc.ua/)
Установка модуля:
Скопируйте содержимое папки upload через ftp в корень сайта
Перейдите в раздел "Дополнения->Платежи" и включите модуль ECommerceConnect;
Для добавления на сайт возможности оплаты заказов через eCommerce Connect необходимо заполнить "Заявка на регистрацию интернет-магазина"
(бланк брать в разделе Документация https://ecommerce.upc.ua/documentation.html) и отправить заполненную заявку по адресу [email protected].
В случае успешной регистрации Вам будут предоставлены тестовые адрес шлюза, MerchantID, TerminalID, сертификат тестового шлюза, а также логин и пароль для входа в тестовый интерфейс торговца.
Для начала работы с тестовым шлюзом нужно создать тестовый сертификат.
Инструкция по созданию сертификата
0. Заходим к каталог cert
1. Правим файл config.dat
2. запускаем run_me.bat с ключом MerchantId (7 цифр, возможно со временем станет 8)
3. Получаем три файла (crt, pem, pub). Файл crt - это и есть сертификат торговца, который нужно отправить в техподдержку UPC.
4. Файл pem - это и есть приватный ключ, который нужно вставить в админке модуля в поле Приватный ключ торговца
5. В поле Сертификат шлюза нужно вставить сертификат тестового шлюза
Настройки модуля:
MerchantID - Необходимо получить от техподдержки UPC при заключении договора (см. выше в инструкции)
TerminalID - Необходимо получить от техподдержки UPC при заключении договора (см. выше в инструкции)
URL шлюза ECommerce - Необходимо получить от техподдержки UPC при заключении договора (см. выше в инструкции)
Приватный ключ торговца - вставляем содержимое pem-файла, полученного при создании сертификата (п.4)
Сертификат шлюза - вставляем содержимое файла сертификата тестового шлюза
Total - минимальная сумма заказа, при которой становится доступен этот метод оплаты
Order Status - статус, который получит заказ в случае успешной оплаты (см. дополнительно про статусы в разделе Дополнительная информация)
Еще одна настройка производится в интерфейсе торговца (адреса см. в разделе Дополнительная информация). Необходимо залогинится в интерфейс торговца,
зайти в раздел "Термінали", выбрать используемый номер терминала и в поле "Адреса URL для сповіщення торговця ( NOTIFY_URL )" прописать:
https://mydomain.com/index.php?route=extension/payment/ecommerce_connect/notify
(Замените mydomain.com на Ваш домен)
Список поддерживаемых шаблонов:
Проверено на четырех шаблонах (default, storeset, luxury и techstore) - работает.
В принципе использован стандартный шаблон оплаты, так что не должно конфликтовать и с другими шаблонами
После настройки на тестовый шлюз и получения ответа от техподдержки UPC о том, что Ваш сертификат закачан в систему - производим тестовый заказ.
Для "оплаты" используем номера карточек, которые Вам будут также предоставлены техподдержкой UPC. Это тестовые номера карт, реальные деньги на них отсутствуют
Убеждаемся что заказ оплатился (в админке OpenCart видим что заказу присвоился выбранный Вами статус). Также проверяем что в интерфейсе торговца в
разделе "Транзакції" появился этот заказ в статусе "000 / Транзакція завершена успішно"
После этого техподдержка UPC подтвердит успешность прохождения транзакции и предоставит уже не тестовые, а реальные адрес шлюза,
MerchantID, TerminalID, сертификат шлюза, а также логин и пароль для входа в интерфейс торговца. И все настройки (создание сертификата и настройки модуля)
необходимо произвести еще раз.
Также от техподдержки прилитет еще и browser personal certificate - его устанавливаете на ПК, с которого будете заходить в Интерфейс торговца.
На этом настройка модуля закончена.
Дополнительная информация:
1. На момент написания инструкции:
адрес тестового интерфейса торговца был https://ecg.test.upc.ua/go/merchant/
адрес тестового шлюза был https://ecg.test.upc.ua/ecgtest/enter
адрес основного интерфейса торговца https://secure.upc.ua/go/merchant/
адрес основного шлюза https://secure.upc.ua/go/enter
2. Статус заказа после оплаты.
Возможно я не совсем понял логику OpenCart, но среди доступных "из коробки" статусов заказа я не вижу статус "Оплачен". Хотя мне кажется
было бы разумным чтобы такой статус был. Если кто-то думает так же - в разделе Локализация -> Статусы заказов добавляем статус "Оплачен".
Хотя можно использовать и любой другой удобный и понятный Вам статус заказа
3. Оплата происходит в гривне - Данное ограничение действует для торговцев на уровне НБУ.