Bitrix

Введение

В документе описан процесс установки и настройки модуля Мокка для CMS-Битрикс, который значительно упрощает для партнёра процесс интеграции с сервисом Мокка.

Подготовка

Для открытия ссылок в этом документе, необходимо вместо {ваш домен} подставить домен вашего сайта, например: http://exampledomen/bitrix/admin/upload. Для корректной работы модуля требуется расширение php-curl, "Валюты" и "Интернет магазин".

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

Перейдите по ссылке и нажмите "Загрузить": {ваш домен}/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

Основные настройки

Максимальная доля заказа для оплаты частями, % - используется для ограничения процента стоимости заказа, который клиент может оплатить частями. По умолчанию 100%;
Страница с заказами - адрес, по которому располагается раздел личного кабинета пользователя, для управления заказами;
Код статуса, при котором отправлять отмену/финализацию заказа - необходимо прописать код статуса, при котором в Mokka будет отправляться отмена или(и) возврата заказа. Отмена необходима, чтобы разблокировать средства на балансе клиента в сервисе, для новых покупок. Статусы должны соответствовать вашим стандартным статусам, проставляемым для соответствующих состояний заказа.
*коды статусов, можете увидеть в разделе "Магазин" > "Настройки" > "Статусы", либо по ссылке {ваш домен}/bitrix/admin/sale_status.php?lang=ru.
Email администратора - используется для отправки сообщений об ошибках
Максимальное кол-во месяцев по тарифу - используется для расчёта минимальной стоимости заказа в месяц, отображаемой на битой цене
Служебные статусы, которые добавятся в битрикс после установки модуля
- MN -Заказ оформлен, решение по займу не принято
- MD - Заказ оформлен, в займе отказано
- MA -Заказ оформлен, займ одобрен

Настройки API

URL для возврата результатов от Мокка - по указанному адресу, Mokka будет возвращать результаты скоринга клиентов (callback). По умолчанию:
[ваш сайт]/ajax/a.revo/ajax.php
URL для возврата пользователя после регистрации или оформления заказа - после завершения авторизации или оформления займа, пользователь будет перенаправлен по этому адресу. По умолчанию:
[ваш сайт]/personal/cart/
ID Магазина и Секретный ключ - используются для авторизации запросов в сервисе. Предоставляются проектным менеджером со стороны Mokka.
Тестовый режим - заставляет модуль обращаться в тестовое окружение. Необходимо активировать на период интеграционных/отладочных работ

Виджет "битой цены" на странице товаров

Для размещения виджета в карточках товаров найдите шаблон отображения цены, и добавьте в него следующий код:

<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]

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

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

Соберите корзину на минимальную сумму (минимальная сумма заказа зависит от вашего тарифа);
Перейдите в корзину;
В способах оплаты выберите "Мокка – оплата авансом";
Нажмите "Оформить заказ".
На экране откроется форма ввода данных. Нажмите кнопку "Войти", в верхней части фрейма.
Укажите номера телефона и нажмите "Подтвердить". Номер телефона для одобрения на тестовой среде должен соответствовать маске +79261288714;
Введите код подтверждения (на тестовой среде всегда 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 или с вашим менджером. Для активации мы проверим все функции и размещенную коммуникацию на соответствие стандартам сервиса.

Размещение дополнительной маркетинговой коммуникации

Размещение лэндинга

Лэндинг создается сотрудниками Мокка. Для размещения лэндинга на вашем сайте необходимо получить ссылку на него от сотрудников отдела интеграции Мокка. Лэндинг должен быть доступен по ссылке 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>

Замените слово ССЫЛКА на ссылку, полученную от менеджера Мокка. В результате на вашем сайте отобразится лэндинг Мокка.

Размещение баннера Мокка на главной странице

Для размещения баннера Мокка на главной странице вашего сайта необходимо:

Выбрать из доступных шаблонов (допускается выбор любого из представленных в прототипе) баннер с максимальным сроком выплаты аванса по вашему тарифу. Например, если ваш тариф подразумевает авансы на 3 и 6 месяцев, то нужно выбрать баннер со значением 6 месяцев (максимальный срок можно уточнить у вашего менеджера).
Выделить выбранный баннер и нажать кнопку "Export" в правом верхнем углу экрана;
В открывшемся окне выбрать подходящий формат и размер баннера;
Нажать кнопку "Export".
Баннер должен быть размещен на главной странице вашего сайта. При щелчке на баннер необходимо реализовать переход по ссылке на лендинг.

Размещение логотипа Мокка в платежных системах

Для размещения логотипа Мокка среди доступных платежных систем, необходимо:

Скачать логотип Мокка по ссылке;
Выбрать подходящий шаблон отображения логотипов платежных систем;
Вставить в шаблон следующий код (может быть изменен в зависимости от реализации верстки):
```
<img class="mokka" src="ПУТЬ К ЛОГОТИПУ">
```
В результате логотип Мокка будет отображен среди доступных платежных систем.

Размещение описания Мокка в Способах оплаты

Описание сервиса Мокка должно присутствовать в разделе "Доставка и оплата" и "FAQ" (если такие разделы есть) для того, чтобы посетители сайта имели возможность ознакомиться с сервисом. Текст описания должен быть взят из прототипа.