Наверх

Установка модуля с маркетплейса Bitrix

  1. В Административной панели перейдите "Marketplace";
  2. Установите Платежное решение от компании Platon;
  3. Проверить установку в разделе "Marketplace" => "Установленные решения". Статус должен быть "Установлен".

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

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

  1. В Административной панели передите "Контент" => "Файлы и папки" => и перейдите в дирректорию /bitrix/modules/.
  2. Загрузите в эту папку средствами Битрикса архив platon.paysystem.tar.gz;
  3. Средствами Битрикса распакуйте содержимое архива, переписав его (в случае обновления) и заново установите модуль в разделе "Marketplace" => "Установленные решения". При этом, данные по настройкам должны сохраниться (если вы выполняли обновление модуля).

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

В Административной панели перейдите "Магазин" => "Настройки" => "Платежные системы" => "Добавить платежную систему":

  1. Запомнить или сохранить себе на время ID платежной системы - информация необходима для обработчика.
  2. Выбрать обработчик платежной системы из выпадающего списка - "platon_paysystem";
  3. Заполнить "Заголовок" - "Platon";
  4. Заполнить "Название" - "Оплата картой Visa/MasterCard";
  5. Установить отметку "Активность";
  6. Заполнить "Описание" - "Оплата картой Visa/MasterCard";
  7. Логотип для модуля 1СБитрикса находится в папке "Контент" => "Файлы и папки" => и перейдите в дирректорию /bitrix/images/platon.paysystem с именем logo-platon.png (245px*115px).
  8. Установить кодировку из выпадающего списка - UTF-8;

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

Ниже в разделе "Настройка обработчика ПС" устанавливаем параметры:

  1. Номер платежа - "Заказ" => "Код заказа (ID)"
  2. Валюта - "Оплата" => "Валюта"
  3. Код покупателя - "Пользователь" => "Код пользователя (ID)"
  4. Сумма счета - "Оплата" => "Цена"
  5. Cancel URL - "Указываем страницу, куда будет перенаправлен покупатель после 5-ти неуспешных попыток оплаты. Обычно такая страница есть уже в самом битриксе - проверить можно в административной панеле выберите "Контент" => "Файлы и папки" => и перейдите в дирректорию /personal/order/payment/error.php."
  6. Success URL - "Указываем страницу, куда будет перенаправлен клиент после успешной оплаты. Обычно такая страница есть уже в самом битриксе - проверить можно в административной панеле выберите "Контент" => "Файлы и папки" => и перейдите в дирректорию /personal/order/payment/ - файл index.php."
  7. Адрес Platon, на который передается (POST) оплата - "https://secure.platononline.com/payment/auth"
  8. Ключ для идентификации клиента - Вам его направляет ответственный сотрудник Platon (merchant id).
  9. Пароль идентификации клиента - Вам его направляет ответственный сотрудник Platon (password).

Настройка обработчика ПС

Настройка обработчика

  1. Файл обработчика можно найти в Административной панели передите "Контент" => "Файлы и папки" => bitrix/personal/order/payment в файле result.php. Необходимо в параметре "PAY_SYSTEM_ID_NEW" => "11" - указать ID платежной системы Platon.
  2. Если же обработчика нет, его можно создать воспользовавшись стандартным функционалом битрикса и подключить обработчик.
    Создать файл "имя.php" => редактировать его как HTML и из выпадающего меню вибираем "Магазин" => "Процедура оформления заказа" => "Подключение обработчика результата платежной системы", дважды кликнув на нем.
Создание обработчика ПС
В появившемся окне, справа в выпадающем списке выбираем Платежную систему (дважды кликнув на ней или перетащить мышью на белую часть формы).
Настройка созданного обработчика ПС
Ссылка на этот файл - это и есть callback url, на который будет обращатся платежная система с результатами оплтаты (важно: не забудьте сообщить его в тех.поддержку компании Platon).

На этом базовая настройка модуля завершена



Дополнительная настройка модуля

Дополнительная настройка модуля необходима в случаях:

  1. Если есть проблемы с настройкой статического IP адреса (используется для операций списаний в один клик);
  2. Используется функционал холдирования средств (авторизация без списания);
  3. Выполняется частичное списание (CAPTURE) средств при условии использования операции HOLD;
  4. Выполняется частичный или полный возврат (CREDITVOID) по API. Обязательно наличие статического IP.

Использование данного функционала возможно совместно с настройками на стороне платежной системы.


Для выполнения необходимых настроек, перейдите в Административной панели в меню "Настройки" => "Настройки продукта" => "Настройки модулей" => "Платежная система Platon"

Настройка модуля
Установите необходимый функционал и проверьте/установите необходимые статусы заказов.

Как работать с холдированием, частичным списанием, частичным возвратом?

Если Вам подключили функционал резервирования средств (без списания) на карте клиента (холдирование), и Вы верно настроили функционал в дополнительных настройках модуля:
- в списке заказов статус заказов, оплачиваемых через Platon будет "Удержание оплаты (HOLD)" а в графе "Оплачен" - "нет". Это означает, что денежные средства с клиента списаны, но оплата не подтверждена сотрудником магазина/компании, следовательно, заказ не оплачен.

Панель инструментов
- и при просмотре заказа на верхней панели инструментов вы увидите кнопку Platon.
Панель инструментов

Списание/частичное списание средств с карты. Подтверждение оплаты.

Чтобы выполнить списание/частичное списание средств по ранее заблокированной сумме, необходимо нажать кнопку "Platon" => "Подтвердить".
В появившемся pop-up окне указать сумму фактического списания и нажать кнопку "Подтвердить оплату". Ответ от системы будет синхронным и будет показан на этой же форме.

Списание

Возврат/частичный возврат средств. Возврат заблокированной суммы.

Чтобы выполнить возврат/частичный возврат средств по ранее списанной сумме, необходимо нажать кнопку "Platon" => "Вернуть".
В появившемся pop-up окне указывать сумму возврата (не может превышать сумму списания), и нажать кнопку "Вернуть на счет покупателю". Ответ от системы будет синхронным и будет показан на этой же форме.

Возврат

Внимание! Данная операция не означает, что средства возвращаются на карту клиента сразу же. Средства будут зачислены клиенту после фактической обработки запроса банком-эмитентом.