Введение
В документе описан процесс установки и настройки модуля Мокка для CMS-Битрикс, который значительно упрощает для партнёра процесс интеграции с сервисом Мокка.
Подготовка
Для открытия ссылок в этом документе, необходимо вместо {ваш домен}
подставить домен вашего сайта, например: http://exampledomen/bitrix/admin/upload
. Для корректной работы модуля требуется расширение php-curl, "Валюты" и "Интернет магазин".
Установка
Плагин можно установить через панель администратора. Загрузите плагин Мокка для Bitrix перед началом выполнения инструкции.
Войдите в административный интерфейс вашего сайта.
Перейдите по ссылке и нажмите "Загрузить": {ваш домен}/bitrix/admin/update_system_partner.php?lang=ru&addmodule=a.revo
После успешной установки модуль появится в списке "Установленных решений" в разделе "Marketplace" - {ваш домен}/bitrix/admin/partner_modules.php?lang=ru
Настройка
- Откройте раздел "Настройки модуля":
{ваш домен}/bitrix/admin/settings.php?lang=ru&mid=a.revo&mid_menu=1
- Перейдите в меню “ Основные настройки"
- URL для возврата результатов от Мокка - по указанному адресу Mokka будет возвращать результаты скоринга клиентов (callback). По умолчанию:
[ваш сайт]/ajax/a.revo/ajax.php
- URL для возврата пользователя после регистрации или оформления заказа - после завершения регистрации или оформления займа, пользователь будет перенаправлен по этому адресу. По умолчанию:
[ваш сайт]/personal/cart/
- ID Магазина и Секретный ключ - выдаётся сотрудником Мокка.
- Тестовый режим - активировать только на период тестирования и отладки. При боевом запуске снять.
- URL для возврата результатов от Мокка - по указанному адресу Mokka будет возвращать результаты скоринга клиентов (callback). По умолчанию:
- Перейдите в меню “Настройки API"
- Максимальная доля заказа для оплаты частями, % - процент суммы, которую клиент сможет оплатить с помощью Мокка (по умолчанию, 100%).
-
Страница с заказами - адрес, по которому располагается раздел личного кабинета пользователя для управления заказами.
- Код статуса, при котором отправлять отмену/финализацию заказа - необходимо прописать код статуса, при котором в Mokka будет отправляться отмена или(и) возврат заказа. Отмена необходима, чтобы разблокировать средства на балансе клиента в сервисе для новых покупок. Статусы должны соответствовать вашим стандартным статусам, проставляемым для соответствующих состояний заказа.
*коды статусов можете увидеть в разделе "Магазин" > "Настройки" > "Статусы" либо по ссылке{ваш домен}/bitrix/admin/sale_status.php?lang=ru
. - Email администратора - используется для отправки сообщений об ошибках.
- Максимальное кол-во месяцев по тарифу - проставляется в соответствии с вашим тарифом.
- Служебные статусы, которые добавятся в битрикс после установки модуля.
- MN -Заказ оформлен, решение по займу не принято.
- MD - Заказ оформлен, в займе отказано.
- MA -Заказ оформлен, займ одобрен.
- Далее следует разместить "Виджет битой цены".
Для размещения виджета в карточках товаров найдите шаблон отображения цены и добавьте в него следующий код:
<div class="bite_price">
<?
$APPLICATION->IncludeComponent(
"revo:buy.link",
"",
Array(
// Элемент отображения цены
"PRICE" => $arResult[PRICES][Базовая][DISCOUNT_VALUE],
"BUY_BTN_SELECTOR" => '#'
)
);
?>
</div>
Завершив размещение элемента, зайдите на страницу любого товара и проверьте корректность отображения виджета на странице товаров. Значение "Битой цены" должно отображать результат деления стоимости товара на максимально доступное значение месяцев погашения аванса.
Если вы используете решение АСПРО, шаблон отображения цены может находиться в одной из директорий:
/bitrix/templates/aspro_next/components/bitrix/catalog.element/main/templates.php
/bitrix/templates/aspro_next/components/bitrix/catalog.element/main2/templates.php
/bitrix/templates/aspro_next/components/bitrix/catalog.element/main3/templates.php
/bitrix/templates/aspro_next/components/bitrix/catalog.element/main4/templates.php
/bitrix/templates/aspro_next/components/bitrix/catalog.element/main5/templates.php
/local/templates/aspro_next/components/bitrix/catalog.element/main/templates.php
/local/templates/aspro_next/components/bitrix/catalog.element/main2/templates.php
/local/templates/aspro_next/components/bitrix/catalog.element/main3/templates.php
/local/templates/aspro_next/components/bitrix/catalog.element/main4/templates.php
/local/templates/aspro_next/components/bitrix/catalog.element/main5/templates.php
Элемент массива отображения цены:
$arResult['MIN_PRICE']['DISCOUNT_VALUE']
$arResult[PRICES][Базовая][DISCOUNT_VALUE]
Тестирование
Оформление заказа
- Соберите корзину на минимальную сумму.
- Перейдите в корзину.
- В способах оплаты выберите "Мокка – оплата авансом".
- Нажмите "Оформить заказ".
- На экране откроется форма ввода данных. Заполните все поля формы. Номер телефона для одобрения на тестовой среде должен соответствовать маске +7 8881xxxxxx.
- Нажмите "Оформить" и введите код подтверждения (на тестовой среде всегда 1111).
- Выберите интересующий вас график платежей и нажмите кнопку “Оплатить авансом”.
Выполнен
-
Перейдите в раздел "Заказы" в административной панели Битрикс
{ваш домен}/bitrix/admin/sale_order.php?lang=ru
-
Откройте оформленный ранее заказ нажатием на его ID. Статус оплаты заказа должен быть "Оплачен", а статус заказа - "Заказ оформлен, займ одобрен"
- Переведите заказ в статус "Выполнен" и нажмите кнопку "Сохранить".
*статус может быть другой, если изменялись настройки по умолчанию.
В результате заказ будет выполнен.
Отмена/Возврат
-
Перейдите в раздел "Заказы" в административной панели Битрикс
{ваш домен}/bitrix/admin/sale_order.php?lang=ru
-
Откройте оформленный ранее заказ нажатием на его ID.
-
Щелкните по статусу "Оплачено", расположенному ниже, в разделе "Оплата", и выберите пункт "Возврат" в открывшемся списке:
-
Заполните необходимые поля открывшейся формы и нажмите кнопку "Сохранить".
- Измените статус заказа на "Отменён".
В результате возврат/отмена будет осуществлена.
Активация
После успешной установки модуля и отладки на тестовых данных, активируйте плагин, чтобы команда Мокка могла протестировать работоспособность и активировать сервис. Для активации следуйте инструкции:
-
Перейдите в раздел "Магазин" -> "Настройки" -> "Платежные системы" или по ссылке:
{ваш домен}/bitrix/admin/sale_pay_system.php?lang=ru;
-
Выберите пункт "Мокка - оплата авансом" и установите для него флажок.
-
Раскройте список "Действия" и выберите пункт "активировать".
- Нажмите кнопку "Применить".
В результате способ оплаты "Мокка – оплата авансом" станет доступен для посетителей вашего сайта.
Свяжитесь с командой интеграции Мокка в integration@mokka.ru или с вашим менеджером. Для активации мы проверим все функции и размещенную коммуникацию на соответствие стандартам сервиса.
Маркетинговые коммуникации
Размещение баннера Мокка на главной странице
Для размещения баннера Мокка на главной странице вашего сайта необходимо:
-
Выбрать из доступных шаблонов баннер с максимальным сроком выплаты аванса по вашему тарифу. Например, если ваш тариф подразумевает авансы на 3 и 6 месяцев, то нужно выбрать баннер со значением 6 месяцев (максимальный срок можно уточнить у вашего менеджера).
-
Выделить выбранный баннер и нажать кнопку "Export" в правом верхнем углу экрана;
-
В открывшемся окне выбрать подходящий формат и размер баннера;
-
Нажать кнопку "Export".
-
Баннер должен быть размещен на главной странице вашего сайта. При щелчке на баннер необходимо реализовать переход по ссылке на лендинг.
Размещение логотипа Мокка в платежных системах
Для размещения логотипа Мокка среди доступных платежных систем, необходимо:
-
Скачать логотип Мокка по ссылке.
-
Выбрать подходящий шаблон отображения логотипов платежных систем.
-
Вставить в шаблон следующий код (может быть изменен в зависимости от реализации верстки):
<img class="mokka" src="ПУТЬ К ЛОГОТИПУ">
-
В результате логотип Мокка будет отображен среди доступных платежных систем.
Размещение описания Мокка в Способах оплаты
Описание сервиса Мокка должно присутствовать в разделе "Доставка и оплата" и "FAQ" (если такие разделы есть) для того, чтобы посетители сайта имели возможность ознакомиться с сервисом. Текст описания должен быть взят из прототипа.
Размещение лэндинга
Лэндинг создается сотрудниками Мокка. Для размещения лэндинга на вашем сайте необходимо получить ссылку на него от сотрудников отдела интеграции Мокка. Лэндинг должен быть доступен по ссылке http://{ваш домен}/mokka
.
Для реализации данного шага выполните следующие действия:
-
Перейдите раздел "Управления структурой" вашего сайта Битрикс -
{ваш домен}/bitrix/admin/fileman_admin.php?lang=ru&path=%2F
. -
Создайте папку "mokka" в корневом каталоге. Для этого нажмите кнопку "Добавить" и выберите пункт "Добавить папку", затем снимите флажок "Перейти к редактированию" и нажмите кнопку "Сохранить".
-
Откройте созданную папку выбрав ее из списка, либо перейдите по ссылке:
{ваш домен}/bitrix/admin/fileman_admin.php?lang=ru&path=%2Fmokka&site=s1
-
Нажмите правой кнопкой на файл index.php и выберите пункт "Редактировать как PHP".
-
Удалите всё содержимое файла и вставьте на его место следующий текст:
<html> <head> <title>Мокка — аванс на твой вкус</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width" /> <meta name="description" content="Мокка — оплачивай покупки авансом. Более 1000 магазинов-партнёров. Переводи аванс на карту. Покупай сейчас, плати потом." /> </head> <body> <iframe allow="fullscreen" src="ССЫЛКА" frameborder="0" allowfullscreen></iframe> </body> </html> <style> body { margin:0px; padding:0px; overflow:hidden; color: #fff; } iframe { overflow:hidden; overflow-x:hidden; overflow-y:hidden; height:100%; width:100%; position:absolute; top:0px; left:0px; right:0px; bottom:0px; height:100%; width: 100%; } </style>
Замените слово ССЫЛКА
на ссылку, полученную от менеджера Мокка. В результате на вашем сайте отобразится лэндинг Мокка.