# Безопасная покупка с Наложкой в магазине OpenCart
Предварительно нужно:
- Подать заявку на сотрудничество, заполнив форму на сайте https://b2c.nalogka.ru ;
- Заключить договор, получить ключи доступа;
# Совместимость с различными версиями CMS OpenCart
Модуль разрабатывался и был протестирован OpenCart версии 2.3, 2.1. Версия модуля для OpenCart 3+ находится в разработке.
# Установка модуля
Модуль представляет собой архив [name].ocmod.zip Установка выполняется через административную панель интернет-магазина. Путь в меню Модули / Расширения » Установка расширений.
В форме на странице Установка расширений необходимо нажать на кнопку «Загрузить» и в появившемся окне найти архив с модулем в файловой системе компьютера.
Внимание!
Во время установки может возникнуть ошибка «FTP должен быть включен в настройках». Избавиться от этой ошибки можно установив модификатор, который можно скачать на официальном сайте OpenCart (opens new window).
После установки модуля необходимо перейти на страницу Модули / Расширения » Модификаторы, найти в списке модификатор с названием «Безопасная покупка с Наложкой», выбрать модификатор установкой галочки рядом с названием и в правом верхнем углу нажать на кнопку «Обновить».
После этого в меню административной панели должен появиться новый пункт меню – «Безопасная покупка с Наложкой».
На этом процесс установки модуля можно считать завершенным.
# Включение модуля
Включение модуля осуществляется на странице Модули / Расширения » Модули / Расширения. В фильтре необходимо выбрать тип модулей «Оплата», найти в списке модуль с названием «Безопасная покупка с Наложкой» и нажать на кнопку активации, как показано на скриншоте ниже.
# Обновление модуля
В случае обнаружения неполадок в работе модуля, можно сообщить о них на почту clients@nalogka.ru. После исправления вам будет доступна для скачивания новая версия модуля, которую нужно будет установить через административную панель.
Перед установкой новой версии модуля нужно удалить модификатор старого модуля. Для этого перейдите на страницу Модули / Расширения » Модификаторы, выберите модификатор с названием «Безопасная покупка с Наложкой» и нажмите на кнопку удалить в правом верхнем углу.
Затем необходимо воспроизвести действия описанные в шаге установка.
# Настройка модуля
# Основные настройки
- Название способа оплаты. Данный текст будет размещен на кнопке оплаты на странице оформления заказа. Рекомендуемое значение – «Внести депозит».
- Минимальная сумма заказа. Сумма, на которую нужно набрать товаров, чтобы стала возможна оплата заказа через модуль. Если не указывать значение, то возможность оплатить будет всегда.
- Статус заказа после оплаты. Статус, в который будет переведен заказ после получения уведомление о том, что сделка, созданная на основе заказа, была оплачена.
- Географическая зона. Географические зоны в которых будет доступна оплата через модуль.
- Способы доставки. Способы доставки, при выборе которых будет возможна оплата через модуль, на случай если интернет-магазин осуществляет доставку неподдерживаемым Сервисом Наложка способом.
- Логгирование запросов к API. Активация/деактивация записи логов. В логи записываются запросы к Сервису Наложка.
- Статус. Включение/отключение модуля.
- Порядок сортировки. Порядок сортировки относительно других способов оплаты.
# Авторизация
- Боевой API Токен. Ключ доступа к Сервису Наложка в рабочем режиме. Выдается при заключении договора, используется для выполнения реальных платежей.
- Тестовый API Токен. Ключ доступа к Сервису Наложка в тестовом режиме. Выдается при заключении договора, используется для проверки работоспособности модуля.
Важно!
В тестовом режиме допускается использование только тестовых карт (предоставляются поддержкой Сервиса, можно посмотреть здесь). Сделки в сервисе Наложка создаются в тестовой среде и удаляются каждые сутки. Заказы в интернет-магазине создаются без каких-либо признаков того, что они тестовые.
- Тестовый режим. Включение/Отключение тестового режима.
# Настройка смены статусов
При смене статусов безопасной сделки сервис Наложка отправляет в сторону интернет-магазина уведомление, на основе которого можно настроить изменение статусов заказа. Для настройки необходимо перейти во вкладку «Настройка уведомлений» и нажать на кнопку «Добавить правило».
Далее, в колонке «Статус сделки в системе Наложка», необходимо выбрать статус сделки и выставить ему в соответствие статус заказа в колонке «Новый статус заказа».
Также вы можете настроить отправку писем покупателю при смене статусов. В письмо будет добавлен текст из поля комментарий.
Не забудьте сохранить изменения.
# Передача изображений
Изображения товаров входящих в заказ должны передаваться интернет-магазином в сервис Наложка. Изображения используются в качестве аргументов при решения споров.
Отправка изображений происходит в фоновом режиме после создания заказа.
Чтобы активировать отправку, необходимо добавить cron задание:
- Подключитесь к серверу с сайтом по ssh
- Определите адрес директории сайта, например
/var/www/opencart - Выполните команду
crontab -e - В открывшемся окне, добавьте строчку
*/1 * * * * cd {адрес директории сайта}/system/library/; php nalogka_file_uploader_cron.php; - Сохраните изменения (для редактора vi(m)
:wq) и закройте окно.
В результате, раз в минуту будет запускаться скрипт. Он будет оправлять изображения по вновь созданным и оплаченным через модуль заказам в сервис Наложка.
Скрипт работает быстро и не добавляет нагрузки на сервер.
# Оформление заказа и создание сделки
После установки модуля на каждый заказ, оплаченный через способ оплаты «Безопасная покупка», будет создана безопасная сделка в сервисе Наложка. Список безопасных сделок можно посмотреть на странице Безопасная покупка с Наложкой / Расширения » Модификаторы.