Модуль приема платежей для CMS Modx Shopkeeper3

Модуль приема платежей для CMS Modx Shopkeeper3

MODX — бесплатная профессиональная система управления содержимым (CMS) и фреймворк для веб-приложений, предназначенная для обеспечения и организации совместного процесса создания, редактирования и управления контентом (то есть содержимым) сайтов.

Версия CMS: от 2.4.2
Версия модуля: 3.2.3 - 3.2.4

Для корректной работы модуля требуется версия php не меньше 5.4.

Доступные языки модуля: ru/en

Самую актуальную версию плагина можно взять из репозитория.

Где посмотреть версии CMS и модуля?

Для определения версии CMS необходимо зайти в административную панель сайта по адресу http://ваш_сайт/manager/ (https://ваш_сайт/manager/). На любой странице в левом верхнем углу написана версия:

Для определения версии модуля нужно перейти на страницу «Установщик». Для этого в верхнем меню ищем пункт «Приложения», подводим курсор к нему. В появившемся меню ищем пункт «Установщик» и нажимаем на него. В появившемся списке установленных пакетов ищем Shopkeeper3. И на найденной строке указа версия этого модуля:

Установка и настройка

  1. Зарегистрируйтесь на сайте www.walletone.com в Единой кассе.
  2. Скачайте архив с плагином.

    Для этого необходимо перейти по ссылке:

  3. Скачайте архив на свой компьютер и распакуйте его.

  4. Файл с расширением zip (название может отличаться, те есть зависит от версии модуля) w1-1.0.0-pl.transport.zip нужно будет загрузить на сайт. Для этого нажимаем загрузить приложение и выбираем пункт «Загрузить пакет».

  5. В появившимся окне нажимаем кнопку «Выберите файлы» и в новом окне указываем файл из пункта 5. И нажимает кнопку Загрузить.

    После загрузки файла нажмите «Отменить».

  6. Затем найдите модуль в списке пакетов и нажмите «Установить»:

    В новом блоке нажмите «Продолжить»:

  7. Затем появится всплывающее окно и начнется установка модуля. После установки модуля нажмите ОК.

  8. Очистите кэш:

    и перезагрузите страницу. После этого в меню «Приложения» появится пункт «Платежный модуль Wallet One»:

    Нажмите на этот пункт.

  9. Теперь осталось настроить модуль на нормальную работу. Для этого необходимо заполнить все необходимые поля.
  10. Часть из них заполнена по умолчанию. Все обязательные поля выделены.

  11. Расшифровка полей

    • Идентификатор интернет-магазина, полученный при регистрации на сайте Wallet One, найти его можно по адресу www.walletone.com/merchant/client в правом верхнем углу:

    • Метод формирования ЭЦП — метод, выбранным для формирование секретного ключа в личном кабинете кассы.

    • Код магазина, который получен от Wallet One. Для этого перейдите в личный кабинет Единой кассы на вкладку Интеграция, выбрать метод MD5 и нажать кнопку Сгенерировать ключ. Полученный таким образом набор и будет секретным ключом (URL скрипта для личного кабинета заполнится позже). Не забудьте после генерации нажать кнопку Сохранить, иначе полученный секретный ключ не будет действителен:

    • Идентификатор валюты по умолчанию — необходимо из выпадающего списка выбрать валюту, которая будет использоваться по умолчанию. То есть, если плагин не определит валюту или она не будет совпадать ни с одной из данного списка, то валюта будет сменена на указанную здесь. При смене валют конвертация суммы заказа не идет.
    • Всегда использовать валюту по умолчанию — это значит, что независимо от текущей валюты в магазине, при платеже будет подставляться выбранная валюта по умолчанию.
    • Статус заказа после успешной оплаты — статус, в который будет переведен заказ после ответа платежной системы об успешной оплате.
    • Статус заказа при ожидании off-line оплаты — статус, в который будет переведен заказ после возврата покупателя с сайта платежной системы при выборе им off-line метода оплаты.
    • Статус заказа после неуспешной оплаты — статус, в который будет переведен заказ после ответа платежной системы об не успешной оплате.
    • Разрешенные и запрещенные платежные системы. После передачи платежной формы в Единую кассу покупатель может выбрать удобный для него способ оплаты. Интернет-магазин может ограничить список доступных способов оплаты или явно определить один из них. Если не выбран ни один вариант для разрешенной системы, то значит выбраны все. Не забудьте, что список актуальных систем может отличаться от приведенного в плагине. Он так же зависит от включенного набора в вашей кассе.

    • Создать набор иконок для вывода на странице оформления заказа. Если вы установите галочку на этом параметре, то автоматом будет сгенерирован набор иконок и добавлен в описание. В итоге при оформлении заказа можно будет увидеть:

    • Название метода оплаты — выберите созданный вами метод в Shopkeeper для данного способа.
    • Адрес страницы об оплате — полный url к созданной странице с результатом оплаты.
  12. После заполнения полей нажмите кнопку Cохранить в конце страницы.
  13. Теперь переходим к страницам оплаты. На страницы успешной оплаты заказа нужно разместить код вызова сниппета:

    [[!WalletOnePayment? &type=payment]]

  14. Теперь нужно создать страницу с результатом оплаты и разместить там код вызова сниппета:

    [[!WalletOnePayment? &type=result_payment]]

  15. Далее, в личном кабинете Единой кассы, перейдите на вкладку «Интеграция» и заполните поле «URL скрипта». Указываем ссылку, ведущую на страницу с результатом оплаты.

  16. Нужные чанки вызываются по умолчанию. Но вы можете подправить их вид. Точнее, вид при успешной и неуспешной оплате.