CS-Cart

Введение

В документе описан процесс установки и настройки модуля Мокка для CMS CS-Cart, который значительно упрощает для партнёра процесс интеграции с сервисом Мокка. Модуль предназначен для установки CS-Cart RU 4.3.6 (с поддержкой PHP7.0) - 4.13.1 без значительных изменений.

Установка модуля

Общий процесс установки модулей для CS-Cart подробно описан в официальной документации на сайте CS-Cart.

Модуль можно установить автоматически через панель администратора или вручную, с помощью переноса файлов модуля на сервер. Загрузи модуль модуль Мокка для CS-Cart, перед началом выполнения инструкции.

Войдите в административный интерфейс вашего сайта.

  1. Пройдите на страницу “Управление модулями” в панели администратора.

  2. Нажмите кнопку “+” для загрузки и установки нового модуля.

  3. В открывшемся окне (“Загрузить и установить модуль”) выберите нажмите кнопку “Загрузить” и выберите архив с модулем, который вы скачали ранее с нашего сайта.

  4. После окончания выгрузки модуля нажмите “Загрузить и установить”

Создание способа оплаты.

  1. Перейдите в меню “Администрирование –> Способы оплаты”.

  2. Нажмите кнопку “+”.

  3. Выберите процессор “Мокка – оплата авансом”.

  4. На вкладке Настроить введите API параметры.

    где:

    store_id и Secret_key - выдаётся сотрудником Мокка

    Тестовые данные - для отладки и настройки

    BASE_URL (live) - необходимо указать базовый адрес для обмена с Мокка

    BASE_URL (test) - по умолчанию выставлять https://backend.demo.revoup.ru

    URL для возврата результатов от сервиса Мокка - по указанному в этом поле адресу, Мокка будет возвращать решение по клиенту

    Префикс заказов - необходим для быстрой сортировки заказов, сделанных через тип оплаты Мокка, если требуется

    Тестовый режим - активировать только на период тестирования и отладки. При боевом запуске снять;

    Имитировать ошибку ответа сервиса - пункт для отладки, его можно пропустить. Если активировать эту галочку, то модуль будет игнорировать callback запросы от сервера Мокка

    После тестирования выдаются боевые доступы

  5. Нажмите кнопку Сохранить.

Настройки модуля

Перейдите в меню “Модули –> Управление модулями –> Мокка — оплата авансом”

Там нажмите на название модуля ”Мокка - оплата авансом”

Основные

Значения ниже проставляются исходя из договора:

Минимальная цена заказа - минимальная цена заказа при котором доступен способ оплаты.

Минимальное количество месяцев займа - значение настройки отображается на информационном всплывающем окне в пояснительном тексте под заголовком.

Максимальное количество месяцев займа - значение настройки отображается на информационном всплывающем окне в пояснительном тексте под заголовком, а также используется для расчета “битой” цены.

Остальные поля:

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 на детальной странице товара и на превью товара. Можно выбрать подходящий формат внешнего вида “битой” цены.

Показывать виджет - настройка определяет где именно показывать виджет (По умолчанию стоит указывать “Показывать виджет на странице товара и превью товара”), это повысит число продаж.

Тестирование модуля

Тестирование оформления заказа

  1. Соберите корзину на минимальную сумму (минимальная сумма заказа зависит от вашего тарифа);
  2. Перейдите в корзину;
  3. В способах оплаты выберите "Мокка – оплата авансом";
  4. Нажмите "Оформить заказ".
  5. На экране откроется форма ввода данных. Заполните все поля формы. Номер телефона для одобрения на тестовой среде должен соответствовать маске +7 8881xxxxxx;
  6. Нажмите "Оформить" и введите код подтверждения (на тестовой среде всегда 1111);
  7. Выберите интересующий вас график платежей и нажмите кнопку “Оплатить авансом”;
  8. Перейдите в раздел "Заказы" в административной панели OpenCart
  9. Откройте оформленный ранее заказ нажатием на его ID. Переведите заказ в статус "Выполнен" и нажмите кнопку "Сохранить". В результате аванс будет выдан. Статус заказа должен измениться на «Оплачен».

Тестирование отмены/возврата аванса/

  1. Перейдите в раздел "Заказы" в административной панели OpenCart
  2. Откройте оформленный ранее заказ нажатием на его ID;
  3. Переведите заказ в статус «Возврат»;

В результате возврат будет осуществлен.

Активация модуля

После успешной установки модуля и проведения тестирования и отладки на тестовых данных, активируйте модуль, чтобы команда Мокка могла протестировать работоспособность и активировать сервис. Для активации следуйте инструкции:

Перейдите в меню “Администрирование –> Способы оплаты”.

Нажмите кнопку “+”.

Выберите процессор “Мокка – оплата авансом”.

На вкладке Настроить введите API параметры.

Для активации модуля:

  1. Снимите галочку «Тестовый режим»
  2. Замените значение ID Магазина и Секретный ключ на те, которые сообщит вам команда Мокка.
  3. Кликаем «Сохранить».

В результате способ оплаты "Мокка – оплата авансом" станет доступен для посетителей вашего сайта.

Свяжитесь с командой интеграции Мокка в integration@mokka.ru или с вашим менеджером. Для активации мы проверим все функции и размещенную коммуникацию на соответствие стандартам сервиса.