Главная
Документация
API-методы
Портал разработчика
Интеграция через e-commerce платформы
Интеграция Битрикс

Интеграция Битрикс

1. Введение

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

Подготовка

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

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

Перейдите по ссылке и нажмите "Загрузить": {ваш домен}/bitrix/admin/update_system_partner.php?lang=ru&addmodule=a.revo

После успешной установки модуль появится в списке "Установленных решений" в разделе Marketplace - {ваш домен}/bitrix/admin/partner_modules.php?lang=ru

3. Настройка модуля Мокка

Откройте раздел "Настройки модуля": {ваш домен}/bitrix/admin/settings.php?lang=ru&mid=revotechnologies.01

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

  • "Минимальная цена товара для отображения виджета" - равно "0", если иного не было прописано в договоре (уточните у вашего менеджера);
  • "Код статуса, при котором отправлять отмену заказа" и "Код статуса, при котором отправлять финализацию заказа" – значения данных полей должны соответствовать вашим настройкам Битрикс (можете увидеть в разделе "Магазин" > "Настройки" > "Статусы", либо по ссылке {ваш домен}/bitrix/admin/sale_status.php?lang=ru. Например, если код статуса "Выполнен" – F, то и в настройках модуля в поле "Код статуса, при котором отправлять финализацию заказа" нужно поставить значение "F".

Настройки API

Значения полей для установки ID Магазина и Секретный ключ вам пришлёт проектный менеджер Mokka. После ввода значений обязательно установить флаг "Тестовый режим"

4. Размещение виджетов и маркетинговой коммуникации

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

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

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

5. Тестирование и активация модуля

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

  1. 5.1.1.
    Соберите корзину на минимальную сумму (минимальная сумма заказа зависит от вашего тарифа);
  2. 5.1.2.
    Перейдите в корзину;
  3. 5.1.3.
    В способах оплаты выберите "Мокка – оплата авансом";
  4. 5.1.4.
    Нажмите "Оформить заказ".
  5. 5.1.5.
    На экране откроется форма ввода данных. Заполните все поля формы. Номер телефона для одобрения на тестовой среде должен соответствовать маске +7 8881xxxxxx;
  6. 5.1.6.
    Нажмите "Оформить" и введите код подтверждения (на тестовой среде всегда 1111);
  7. 5.1.7.
    Выберите интересующий вас график платежей и нажмите кнопку “Оплатить авансом”;
  8. 5.1.8.
    Перейдите в раздел "Заказы" в административной панели Битрикс {ваш домен}/bitrix/admin/sale_order.php?lang=ru
  9. 5.1.9.
    Откройте оформленный ранее заказ нажатием на его ID;
  10. 5.1.10.
    Переведите заказ в статус "Выполнен" и нажмите кнопку "Сохранить".

В результате аванс будет выдан. Статус заказа должен измениться на «Оплачен».

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

  1. 5.2.1.
    Перейдите в раздел "Заказы" в административной панели Битрикс {ваш домен}/bitrix/admin/sale_order.php?lang=ru
  2. 5.2.2.
    Откройте оформленный ранее заказ нажатием на его ID;
  3. 5.2.3.
    Щелкните по статусу "Оплачено", расположенному ниже, в разделе "Оплата", и выберите пункт "Возврат" в открывшемся списке:
  4. 5.2.4.
    Заполните необходимые поля открывшейся формы и нажмите кнопку "Сохранить".

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

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

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

  1. 5.3.1.
    Перейдите в раздел "Магазин" > "Настройки" > "Платежные системы" или по ссылке: {ваш домен}/bitrix/admin/sale_pay_system.php?lang=ru;
  2. 5.3.2.
    Выберите пункт "Мокка - оплата авансом" и установите для него флажок;
  3. 5.3.3.
    Раскройте список "Действия" и выберите пункт "активировать";
  4. Нажмите кнопку "Применить".
  5. В результате способ оплаты "Мокка – оплата авансом" станет доступен для посетителей вашего сайта.
  6. Свяжитесь с командой интеграции Мокка в integration@mokka.ru или с вашим менджером. Для активации мы проверим все функции и размещенную коммуникацию на соответствие стандартам сервиса.

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

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

Лэндинг создается сотрудниками Мокка. Для размещения лэндинга на вашем сайте необходимо получить ссылку на него от сотрудников отдела интеграции Мокка. Лэндинг должен быть доступен по ссылке http://{ваш домен}/mokka.

Для реализации данного шага выполните следующие действия:

  1. 6.1.1.
    Перейдите раздел "Управления структурой" вашего сайта Битрикс - {ваш домен}/bitrix/admin/fileman_admin.php?lang=ru&path=%2F;
  2. 6.1.2.
    Создайте папку "mokka" в корневом каталоге.
  3. 6.1.3.
    Для этого нажмите кнопку "Добавить" и выберите пункт "Добавить папку", затем снимите флажок "Перейти к редактированию" и нажмите кнопку "Сохранить";
  4. 6.1.4.
    Откройте созданную папку выбрав ее из списка, либо перейдите по ссылке: {ваш домен}/bitrix/admin/fileman_admin.php?lang=ru&path=%2Fmokka&site=s1
  5. 6.1.5.
    Нажмите правой кнопкой на файл index.php и выберите пункт "Редактировать как PHP";
  6. 6.1.6.

    Удалите всё содержимое файла, и вставьте на его место следующий текст:

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

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

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

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

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

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

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

  1. 6.3.1.
    Скачать логотип Мокка по ссылке;
  2. 6.3.2.
    Выбрать подходящий шаблон отображения логотипов платежных систем;
  3. 6.3.3.

    Вставить в шаблон следующий код (может быть изменен в зависимости от реализации верстки):

    <img class="mokka" src="ПУТЬ К ЛОГОТИПУ">
  4. 6.3.4.
    В результате логотип Мокка будет отображен среди доступных платежных систем.

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

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