Введение
В документе описан процесс установки и настройки модуля Мокка для CMS CS-Cart, который значительно упрощает для партнёра процесс интеграции с сервисом Мокка. Модуль предназначен для установки CS-Cart RU 4.3.6 (с поддержкой PHP7.0) - 4.13.1 без значительных изменений.
Установка модуля
Модуль можно установить автоматически через панель администратора или вручную, с помощью переноса файлов модуля на сервер. Загрузи модуль Мокка для CS-Cart, перед началом выполнения инструкции.
Войдите в административный интерфейс вашего сайта.
-
Пройдите на страницу “Управление модулями” в панели администратора.
- Нажмите кнопку “+” для загрузки и установки нового модуля.
-
В открывшемся окне (“Загрузить и установить модуль”) выберите нажмите кнопку “Загрузить” и выберите архив с модулем, который вы скачали ранее с нашего сайта.
- После окончания выгрузки модуля нажмите “Загрузить и установить”
Создание способа оплаты.
-
Перейдите в меню “Администрирование –> Способы оплаты”.
-
Нажмите кнопку “+”.
-
Выберите процессор “Мокка – оплата авансом”.
-
На вкладке Настроить введите API параметры.
где:
store_id и Secret_key - выдаётся сотрудником Мокка
Тестовые данные - для отладки и настройки
BASE_URL (live) - необходимо указать базовый адрес для обмена с Мокка
BASE_URL (test) - по умолчанию выставлять https://backend.demo.revoup.ru
URL для возврата результатов от сервиса Мокка - по указанному в этом поле адресу, Мокка будет возвращать решение по клиенту
Префикс заказов - необходим для быстрой сортировки заказов, сделанных через тип оплаты Мокка, если требуется
Тестовый режим - активировать только на период тестирования и отладки. При боевом запуске снять;
Имитировать ошибку ответа сервиса - пункт для отладки, его можно пропустить. Если активировать эту галочку, то модуль будет игнорировать callback запросы от сервера Мокка
После тестирования выдаются боевые доступы
- Нажмите кнопку Сохранить.
Настройки модуля
Перейдите в меню “Модули –> Управление модулями –> Мокка — оплата авансом”
Там нажмите на название модуля ”Мокка - оплата авансом”
Основные
Значения ниже проставляются исходя из договора:
Минимальная цена заказа - минимальная цена заказа при котором доступен способ оплаты.
Минимальное количество месяцев займа - значение настройки отображается на информационном всплывающем окне в пояснительном тексте под заголовком.
Максимальное количество месяцев займа - значение настройки отображается на информационном всплывающем окне в пояснительном тексте под заголовком, а также используется для расчета “битой” цены.
Остальные поля:
Email отправки событий об ошибках - данная настройка позволяет указывать адрес электронной почты, на который отправляются сообщения об ошибках при попытке оформления заказа. Администратор может указать несколько email адресов, используя точку с запятой “;” в качестве разделителя.
Пароль для запуска команд по расписанию - пароль для запуска команд по расписанию для обнаружения заказов в статусе “Неудавшийся”. Например, если указать в поле значение “MY_PASSWORD”, то команда для отображения заказов будет иметь вид:
Пример:
php /srv/projects/dev.cart-power.com
/current/rnurislamov/mokka/admin.php
--dispatch=mokka.cron --cron_password=MY_PASSWORD
Статусы
Статус успешного заказа - статус применяемый к заказу после положительного ответа от платежной системы. Заказ уже совершён, но ещё не финализирован.
Статус неуспешного заказа - статус применяемый к заказу после отрицательного ответа от платежной системы.
Статус отмененного заказа - статус заказа, который отправляет в сервис Мокка информацию об отмене/возврате заказа.
Статус выполненного заказа - статус заказа при котором в сервис Мокка будет передана информация о финализации заказа. Обычно это статус, который проставляется после отгрузки или доставки заказа клиенту.
Внешний вид
ID блока с подсказкой - ID блока с подсказкой отображаемой при клике на соответствующую иконку виджета (Оставить значение по умолчанию)
Шаблон отображения виджета - настройка позволяет выбрать шаблон отображения виджета сервиса Mokka на детальной странице товара и на превью товара. Можно выбрать подходящий формат внешнего вида “битой” цены.
Показывать виджет - настройка определяет где именно показывать виджет (По умолчанию стоит указывать “Показывать виджет на странице товара и превью товара”), это повысит число продаж.
Тестирование модуля
Тестирование оформления заказа
- Соберите корзину на минимальную сумму (минимальная сумма заказа зависит от вашего тарифа);
- Перейдите в корзину;
- В способах оплаты выберите "Мокка – оплата авансом";
- Нажмите "Оформить заказ".
- На экране откроется форма ввода данных. Заполните все поля формы. Номер телефона для одобрения на тестовой среде должен соответствовать маске +7 8881xxxxxx;
- Нажмите "Оформить" и введите код подтверждения (на тестовой среде всегда 1111);
- Выберите интересующий вас график платежей и нажмите кнопку “Оплатить авансом”;
- Перейдите в раздел "Заказы" в административной панели OpenCart
- Откройте оформленный ранее заказ нажатием на его ID. Переведите заказ в статус "Выполнен" и нажмите кнопку "Сохранить". В результате аванс будет выдан. Статус заказа должен измениться на «Оплачен».
Тестирование отмены/возврата аванса/
- Перейдите в раздел "Заказы" в административной панели OpenCart
- Откройте оформленный ранее заказ нажатием на его ID;
- Переведите заказ в статус «Возврат»;
В результате возврат будет осуществлен.
Активация модуля
После успешной установки модуля и проведения тестирования и отладки на тестовых данных, активируйте модуль, чтобы команда Мокка могла протестировать работоспособность и активировать сервис. Для активации следуйте инструкции:
Перейдите в меню “Администрирование –> Способы оплаты”.
Нажмите кнопку “+”.
Выберите процессор “Мокка – оплата авансом”.
На вкладке Настроить введите API параметры.
- Снимите галочку «Тестовый режим»
- Замените значение ID Магазина и Секретный ключ на те, которые сообщит вам команда Мокка.
- Кликаем «Сохранить».
В результате способ оплаты "Мокка – оплата авансом" станет доступен для посетителей вашего сайта.
Свяжитесь с командой интеграции Мокка в integration@mokka.ru или с вашим менеджером. Для активации мы проверим все функции и размещенную коммуникацию на соответствие стандартам сервиса.