Использование плагина от ecommpay для CMS Magento

Введение

В этой статье представлена информация о работе с платёжным плагином от ecommpay версии 1.1.0. Плагин этой версии может использоваться в веб-сервисах, разработанных на базе CMS Magento версии 2.2 и выше, и позволяет открывать пользователям платёжную форму Payment Page от ecommpay, а также обеспечивать все необходимые действия для проведения платежей.

Плагин от ecommpay позволяет открывать пользователям платёжную форму Payment Page от ecommpay и обеспечивать все необходимые действия для проведения платежей, как в части взаимодействия с пользователями, так и в части взаимодействия с платёжной платформой ecommpay, с передачей и приёмом всей необходимой информации.

Общая информация

Возможности

При использовании плагина от ecommpay можно:

  • Встраивать в веб-сервис возможность вызова платёжной формы Payment Page от ecommpay.

    Для этого достаточно установить плагин от ecommpay и настроить его использование через интерфейс Magento.

  • Настраивать использование отдельных платёжных методов, подключённых в рамках проекта мерчанта.

    Это можно делать непосредственно через соответствующие раскрывающиеся блоки в интерфейсе Magento. Технически для подключения отдельных платёжных методов может быть достаточно минимальных действий в интерфейсе Magento либо не требоваться никаких действий вовсе, а все организационные вопросы можно решать через курирующего менеджера ecommpay.

  • Тестировать работу платёжной формы и возможности проведения платежей.

    При этом для начального тестирования достаточно тестового режима работы плагина (без каких-либо дополнительных действий), а для более глубокого тестирования можно оформить тестовый проект в платёжной платформе ecommpay (что можно сделать через заявку на основном сайте компании).

  • Проводить разовые одностадийные оплаты.

    Для этого можно использовать те методы, в рамках которых поддерживаются соответствующий тип платежа.

  • Выполнять частичные и полные возвраты средств по оплатам, проведённым с помощью плагина, в рамках тех методов, для которых поддерживается выполнение возвратов.

    Для этого можно использовать интерфейс Magento и, если актуально, интерфейсы платёжной платформы ecommpay (пользовательский интерфейс Dashboard и Gate API). Вместе с тем, при использовании интерфейсов платёжной платформы ecommpay информация о платежах в интерфейсе Magento обновляется, только если настроена отправка оповещений со стороны платёжной платформы (подробнее).

  • Контролировать информацию о платежах, проводимых с помощью плагина.

    Для этого можно использовать интерфейс Magento, и если актуально, — интерфейс Dashboard от ecommpay.

  • Управлять заказами, оплаты по которым проводятся с помощью плагина, через интерфейс Magento.

    При этом можно отменять такие заказы и корректировать их статусы вручную.

  • Настраивать параметры работы платёжной формы Payment Page, адаптируя её под специфику веб-сервиса, и применять различные возможности, обеспечиваемые со стороны ecommpay.

    В частности, можно применять процедуру подтверждения зачислений при работе с платёжными методами Open Banking и подключать отправку пользователям уведомлений о результатах оплат (подробнее). Для подключения этих возможностей следует обращаться к специалистам технической поддержки ecommpay.

Столь широкий спектр возможностей позволяет подстраиваться под различные особенности бизнеса, гибко настраивать пользовательские сценарии и обеспечивать высокий уровень конверсии платёжной формы и проходимости платежей. Для подключения и применения возможностей, предоставляемых ecommpay, следует обращаться к технической документации на этом портале и, по мере необходимости, к специалистам ecommpay.

Схема работы

В схеме проведения платежей с использованием плагина от ecommpay задействуются пользователь, веб-сервис со встроенным в него плагином, платёжная форма Payment Page, платёжная платформа и платёжная среда. При этом с помощью плагина от ecommpay на стороне веб-сервиса обеспечиваются автоматический вызов Payment Page и автоматическое взаимодействие с платёжной платформой в соответствии с заданными параметрами работы.

Рис.: Проведение оплаты с использованием плагина. Описание шагов

  1. Пользователь на стороне веб-сервиса открывает страницу перехода к оплате и выбирает один из методов оплаты, доступных через плагин от ecommpay.
  2. С помощью плагина автоматически формируется и отправляется в платёжную платформу ecommpay запрос на открытие платёжной формы Payment Page с учётом выбранного пользователем метода.
  3. Запрос на открытие Payment Page поступает в платёжную платформу.
  4. В платформе выполняется обработка запроса, с проверкой его корректности.
  5. В платформе обеспечивается подготовка к открытию Payment Page или к перенаправлению пользователя к стороннему сервису в соответствии с параметрами вызова.
  6. Пользователю отображается платёжная форма или выполняется его перенаправление к стороннему сервису — в соответствии с тем, что актуально для выбранного метода.
  7. Пользователь выполняет необходимые действия для оплаты и подтверждает готовность провести оплату.
  8. В платёжную платформу поступает итоговый запрос на оплату (со всеми необходимыми сведениями). При перенаправлениях к сторонним сервисам это может обеспечиваться ранее, на шаге 5.
  9. Запрос передаётся в платёжную среду.
  10. В платёжной среде выполняется обработка платежа. При этом, если необходимо, обеспечивается выполнение дополнительных действий со стороны платформы и пользователя (например, для аутентификации 3‑D Secure).
  11. Из платёжной среды к платёжной платформе направляется информация о результате оплаты.
  12. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты. Оно автоматически обрабатывается с помощью плагина, благодаря чему в интерфейсе Magento формируется счёт на оплату и обновляются базовые сведения о платеже.
  13. От платёжной платформы к Payment Page направляется информация о результате оплаты.
  14. Информация о результате оплаты отображается пользователю в платёжной форме Payment Page.

В рамках представленной общей схемы возможны два варианта работы:

  • со встраиванием платёжной формы непосредственно в интерфейс веб-сервиса (через элемент iframe);
  • с открытием платёжной формы в модальном окне или отдельной вкладке.

Первый из этих вариантов в описываемой версии плагина доступен только для оплат с прямым использованием платёжных карт и используется для них по умолчанию. В первомэтом варианте пользователь указывает данные платёжной карты и подтверждает формирование заказа в CMS Magento и инициирование платежа в платформе ecommpay непосредственно на странице перехода к оплате в веб-сервисе (с помощью кнопки Place Order).

Второй вариант в описываемой версии плагина используется для всех альтернативных платёжных методов и для оплат с прямым использованием платёжных карт, если для них был выбран способ открытия формы в модальном окне или отдельной вкладке. Во втором В этом варианте пользователь сначала подтверждает формирование заказа в CMS Magento на странице перехода к оплате веб-сервиса (с помощью кнопки Place Order) и уже после этого указывает необходимые данные в открывшейся платёжной форме и подтверждает инициирование платежа в платформе ecommpay (с помощью кнопки Оплатить).

Помимо прочего, при втором варианте возможны случаи, когда пользователь подтверждает формирование заказа, но не переходит к подтверждению оплаты. В таких случаях в веб-сервисе появляются заказы в статусе Pending Payment, при этом оплаты в рамках этих заказов не инициируются. В остальном работа с заказами и платежами по ним идентична для обоих вариантов.

Контролировать информацию о заказах и платежах по ним можно через интерфейс Magento: в подразделе Orders раздела Sales. При этом следует учитывать, что для заказов и платежей используются разные идентификаторы и статусы. Заказам на стороне веб-сервиса присваиваются девятизначные номера (например, 000001503) и статусы в соответствии с моделью выполнения заказов Magento (подробнее), платежам на стороне платёжной платформы — идентификаторы, включающие в себя префикс mag_ и тринадцатизначный код (например, mag_64ca3135cffd3), и статусы в соответствии с моделью проведения платежей ecommpay (подробнее). С вопросами о соответствии статусов заказов и платежей можно обращаться к курирующему менеджеру ecommpay.

Установка

Чтобы начать работу с плагином от ecommpay версии 1.1.0 для CMS Magento, его необходимо установить, предварительно скачав zip-архив плагина на портале GitHub.

Для установки плагина следует:

  1. Распаковать zip-архив и добавить папку с файлами плагина в папку с исходным кодом веб-сервиса, созданного на базе CMS Magento, — во вложенную папку app/code.
    Совет:

    Если до установки плагина использовалась и не была удалена одна из его предыдущих версий, папку с файлами этой версии следует удалить из папки с исходным кодом веб-сервиса перед добавлением папки с новой версией.

    Также стоит учитывать, что в зависимости от структуры файлов в папке с исходным кодом веб-сервиса для подключения к ней могут потребоваться дополнительные действия (например, подключение по протоколу SSH).

  2. Выполнить следующие команды из корневой папки с исходным кодом веб-сервиса и дождаться завершения установки.
    php bin/magento indexer:reindex 
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento cache:flush
    php bin/magento cache:clean
    php bin/magento setup:static-content:deploy

Тестирование

Общая информация

Для проверки работы плагина и проведения тестовых платежей без реального списания средств можно использовать два варианта:

  • Тестирование через тестовый режим работы плагина. Это вариант с локальным базовым тестированием работы платёжной формы и отдельных сценариев проведения карточных платежей, без подключения к платёжной платформе ecommpay. Он позволяет оперативно проверять работу платёжной формы и отдельные сценарии проведения карточных платежей. При этом в идентификаторах таких платежей, условно проводимых в таком варианте тестирования, используются кодовое слово test и доменное имя веб-сервиса (например, test_mysite_mag_64ca3135cffd3), что может быть удобным при контроле проведения платежей.
  • Тестирование через тестовую среду платёжной платформы ecommpay. Это вариант с комплексным тестированием, с подключением к платёжной платформе ecommpay и задействованием её компонентов. Подключиться к платформе можно в течение нескольких минут, используя соответствующую форму на основном сайте компании и полученные идентификатор и ключ тестового проекта. В таком случае плагин переводится в рабочий режим и позволяет тестировать большее число платёжных сценариев, в том числе с использованием альтернативных методов, для которых поддерживается работа с эмуляторами (подробнее). При этом все платежи остаются тестовыми (хотя в их идентификаторах уже и не используются кодовое слово test и доменное имя веб-сервиса).

Для сопоставления этих вариантов тестирования можно использовать следующую таблицу.

Возможности тестирования через тестовый режим плагина через тестовую среду платформы
Открытие платёжной формы с применением различных способов и параметров работы + +
Проведение разовых оплат + +
Использование альтернативных платёжных методов (при обращении к специалистам ecommpay) +
Использование дополнительных возможностей платёжной формы Payment Page (при обращении к специалистам ecommpay) +
Выполнение возвратов + +
Контроль информации о платежах + +
Управление заказами + +

Независимо от выбранного варианта тестирования (в тестовом режиме или с тестовой средой платёжной платформы ecommpay), плагин подключается к веб-сервису и становится доступен пользователям как вариант оплаты. Поэтому вНезависимо от выбранного варианта тестирования, в тех случаях, когда плагин подключается к работающему веб-сервису, рекомендуется выполнять тестирование в период низкой нагрузки и предупреждать пользователей о проводимых работах.

Настройка параметров

Чтобы подготовить плагин к тестированию, необходимо определить предпочтительный вариант тестирования и настроить плагин в интерфейсе Magento следующим образом:

  1. Перейти к параметрам работы плагина в интерфейсе Magento.

    Для этого следует:

    1. Выбрать раздел Stores на панели навигации и пункт Configuration в появившемся меню.
    2. Выбрать раздел Sales и пункт Payment Methods в левом меню подраздела Configuration.
    3. Найти секцию с параметрами работы плагина от ecommpay на открывшейся странице и щёлкнуть кнопку Configure.
  2. Задать основные параметры работы плагина в раскрывающемся блоке General settings:
    • Plugin Enabled — возможность подключить плагин к веб-сервису.;

      Если для этого параметра задано значение Yes, то все платёжные методы, ранее подключённые для работы через плагин, становятся доступными в веб-сервисе. Если задано значение No, то все платёжные методы отключаются от веб-сервиса и становятся недоступными для проведения платежей.

    • Demo mode — возможность установить тестовый режим работы плагина.;

      Для использования тестового режима работы плагина необходимо задать значение Yes, для использования тестовой среды платформы — задать значение No и параметры подключения, полученные от ecommpay, в полях Project ID и Secret Key.

      Прим.: При работе в тестовом режиме плагина значения, заданные в полях Project ID и Secret Key, игнорируются. Поэтому для использования тестового проекта в платёжной платформе ecommpay необходимо отключить тестовый режим плагина.
    • Project ID — идентификатор тестового проекта.;
    • Secret Key — ключ тестового проекта для взаимодействия с платформой.;
    • Language — язык отображения платёжной формы.;
    • Additional parameters — дополнительные параметры вызова платёжной формы. При указании в этом поле нескольких параметров в качестве разделителя необходимо использовать символ &.

    Рис.: Блок General settings с основными параметрами подключения

  3. Задать параметры использования платёжных методов (подробнее).

    При работе в тестовом режиме плагина достаточно задать параметры для карточных платежей в раскрывающемся блоке Card payments или More payment methods via ecommpay.

  4. Сохранить параметры работы плагина.

    Для этого следует щёлкнуть кнопку Save Config.

Проведение тестовых оплат

В рамках работы с плагином можно проводить тестовые оплаты в веб-сервисе и получать базовые сведения о них через интерфейс Magento — в подразделе Orders раздела Sales. При этом можно использовать специальные платёжные реквизиты, позволяющие тестировать заданные сценарии работы.

Чтобы тестировать проведение карточных платежей, можно использовать номера тестовых карт. При этом для тестирования по заданным кратчайшим сценариям (без эмулирования аутентификации 3‑D Secure) можно использовать следующие номера карт:

  • 4000 0000 0000 0077 — для проведения оплаты;
  • 4111 1111 1111 1111 — для отклонения оплаты.

Для более масштабного тестирования можно использовать расширенный набор тестовых данных для карточных платежей (подробнее). (в том числе с аутентификацией 3‑D Secure), представленных в статье Тестовые карты.

Чтобы тестировать проведение платежей с использованием альтернативных методов (при подключении соответствующих методов через курирующего менеджера или техническую поддержку и при использовании тестовой среды платёжной платформы), можно использовать информацию, представленную в статье Возможности тестирования, а также в разделах о тестировании отдельных методов.

Выполнение тестовых возвратов

После проведения тестовых оплат можно тестировать выполнение возвратов. Для этого можно использовать интерфейс Magento, а также, если актуально, интерфейсы Gate и Dashboard от ecommpay. При этом выполнение возвратов доступно для всех платёжных методов в рамках проекта мерчанта, кроме методов, для которых на стороне платёжной платформы не поддерживаются возвраты (например, метод Sofort или методы группы Open Banking). Можно учитывать, что информация, представленная в этом подразделе, актуальна и для выполнения возвратов в рабочем режиме.

При выполнении возвратов через интерфейсы платёжной платформы, чтобы информация о платежах и заказах обновлялась автоматически в интерфейсе Magento, необходимо убедиться, что для используемого проекта была настроена отправка оповещений от платёжной платформы на URL веб-сервиса в формате https://<merchant domain>/ecommpay/endpayment/index. Вместе с тем важно, чтобы для одного типа платежа не было настроено насколько правил отправки оповещений с одинаковыми значениями типа события и кода платёжного метода, иначе в протоколах работы плагина появляются сообщения об ошибках, связанных с обработкой оповещений от платёжной платформы. Информация о работе с правилами отправки оповещений представлена в соответствующей статье документации.

При выполнении возвратов через интерфейс Magento в этом интерфейсе формируются записи с информацией о таких возвратах — credit memos. Просматривать такие записи можно через раздел Credit Memos в карточках отдельных заказов, а более детальную информацию о возвратах можно получать через интерфейсы платформы ecommpay (например, Dashboard и Data API).

Совет: Когда из платформы ecommpay в веб-сервис поступает информации о платеже, проведённом в рамках заказа, для этого заказа в интерфейсе Magento автоматически формируется счёт на оплату — invoice (информацию о таком счёте можно получить в разделе Invoices в карточке заказа). До формирования счёта на оплату выполнить возврат в рамках соответствующего заказа через интерфейс Magento нельзя.

Следует учитывать, что для выполнения возвратов заказы в интерфейсе Magento должны быть в статусах Processing или Complete, а платежи в платформе ecommpay — в статусах success, partially reversed или partially refunded.

Чтобы выполнить возврат через интерфейс Magento, следует:

  1. Перейти к реестру заказов.

    Для этого следует перейти в раздел Sales и выбрать пункт Orders в появившемся меню.

  2. Выбрать заказ, по которому необходимо выполнить возврат средств, выбрать пункт Invoices в левом меню карточки заказа и щёлкнуть кнопку Credit Memo в верхнем меню страницы счёта на оплату.
  3. Указать количество товаров, которые необходимо вернуть, и при необходимости щёлкнуть кнопку Update Qty's для обновления суммы возврата на странице выполнения возвратов New Memo.
  4. При необходимости указать комментарий для возврата в поле Credit Memo Comments.
  5. Подтвердить выполнение возврата.

    Для этого следует щёлкнуть кнопку Refund.

  6. Убедиться в том, что в истории заказа отображается информация о выполненном возврате.

    При выполнении частичного возврата заказу присваивается статус Processing, при выполнении полного возврата заказу присваивается статус Closed.

Рис.: Карточка заказа в интерфейсе Magento

Использование

Общая информация

Для проведения платежей с реальным списанием средств, прежде всего, необходимо решить все организационные вопросы по взаимодействию с ecommpay (подать заявку на подключение, предоставить всю необходимую информацию и получить от ecommpay уведомление о возможности проводить платежи, а также идентификатор и секретный ключ рабочего проекта). Также необходимо и сообщить специалистам технической поддержи ecommpay название и адрес веб-сервиса, для которого актуально использование плагина от ecommpay, и а также валюту проведения платежей.

После этого можно перевести плагин в рабочий режим, указать в параметрах его работы полученные идентификатор и ключ рабочего проекта, полученные от ecommpay, и задать другие необходимые параметры (или проверить их актуальность для рабочего применения). Если после этого потребуется приостановить работу плагина, например для тестирования при подключении дополнительных функций, его можно перевести в тестовый режим или отключить от веб-сервиса.

Внимание: С 12 августа 2024 года в связи с вступлением в силу новых требований платёжной системы Visa расширяется набор сведений, необходимых для аутентификации 3‑D Secure при проведении оплат с использованием карт этой платёжной системы. Для сбора и передачи таких сведений на странице перехода к оплате должны использоваться поля для указания пользователем номера его телефона или адреса электронной почты.

Настройка параметров

Чтобы настроить параметры работы плагина, следует:

  1. Перейти к параметрам работы плагина в интерфейсе Magento.

    Для этого следует:

    1. Выбрать раздел Stores на панели навигации и пункт Configuration в появившемся меню.
    2. Выбрать раздел Sales и пункт Payment Methods в левом меню подраздела Configuration.
    3. Найти секцию с параметрами работы плагина от ecommpay на открывшейся странице и щёлкнуть кнопку Configure.
  2. Задать основные параметры работы плагина в раскрывающемся блоке General settings:
    • Plugin Enabled — возможность подключить плагин к веб-сервису.

      Если для этого параметра задано значение Yes, то все платёжные методы, ранее подключённые для работы через плагин, становятся доступными в веб-сервисе. Если задано значение No, то все платёжные методы отключаются от веб-сервиса и становятся недоступными для проведения платежей.

    • Demo mode — возможность установить тестовый режим работы плагина.

      Для использования рабочей среды платформы следует задать значение No и параметры подключения, полученные от ecommpay, в полях Project ID и Secret Key.

    • Project ID — идентификатор рабочего проекта.
    • Secret Key — ключ рабочего проекта для взаимодействия с платформой.
    • Language — язык отображения платёжной формы.
    • Additional parameters — дополнительные параметры вызова платёжной формы. При указании в этом поле нескольких параметров в качестве разделителя необходимо использовать символ &.

    Рис.: Блок General settings с основными параметрами подключения

  3. Задать параметры использования платёжных методов (подробнее).
  4. Сохранить параметры работы плагина.

    Для этого следует щёлкнуть кнопку Save Config.

Выполнение возвратов

После проведения оплат можно выполнять возвраты по ним. Для этого можно использовать интерфейс Magento, а также, если актуально, интерфейсы Gate и Dashboard от ecommpay. При этом выполнение возвратов доступно для всех платёжных методов в рамках проекта мерчанта, кроме методов, для которых на стороне платёжной платформы не поддерживаются возвраты (например, метод Sofort или методы группы Open Banking). Все возможности и процедуры по работе с возвратами в рабочем режиме соответствуют тем, которые доступны в режиме тестирования.

При выполнении возвратов через интерфейсы платёжной платформы, чтобы информация о платежах и заказах обновлялась автоматически в интерфейсе Magento, необходимо убедиться, что для используемого проекта была настроена отправка оповещений от платёжной платформы на URL веб-сервиса в формате https://<merchant domain>/ecommpay/endpayment/index. Вместе с тем важно, чтобы для одного типа платежа не было настроено насколько правил отправки оповещений с одинаковыми значениями типа события и кода платёжного метода, иначе в протоколах работы плагина появляются сообщения об ошибках, связанных с обработкой оповещений от платёжной платформы. Информация о работе с правилами отправки оповещений представлена в соответствующей статье документации.

При выполнении возвратов через интерфейс Magento в этом интерфейсе формируются записи с информацией о таких возвратах — credit memos. Просматривать такие записи можно через раздел Credit Memos в карточках отдельных заказов, а более детальную информацию о возвратах можно получать через интерфейсы платформы ecommpay (например, Dashboard и Data API). Вместе с тем, стоит учитывать, что при выполнении возвратов вручную (наличными или иными способами, без фиксирования соответствующей информации в платёжной платформе ecommpay) статусы заказов не обновляются в интерфейсе Magento. В этих случаях рекомендуется фиксировать информацию о таких возвратах в интерфейсе Magento с помощью кнопки Refund Offline (на странице выполнения возвратов New Memo).

Совет: Когда из платформы ecommpay в веб-сервис поступает информации о платеже, проведённом в рамках заказа, для этого заказа в интерфейсе Magento автоматически формируется счёт на оплату — invoice (информацию о таком счёте можно получить в разделе Invoices в карточке заказа). До формирования счёта на оплату выполнить возврат в рамках соответствующего заказа через интерфейс Magento нельзя.

Следует учитывать, что для выполнения возвратов заказы в интерфейсе Magento должны быть в статусах Processing или Complete, а платежи в платформе ecommpay — в статусах success, partially reversed или partially refunded.

Чтобы выполнить возврат через интерфейс Magento, следует:

  1. Перейти к реестру заказов.

    Для этого следует перейти в раздел Sales и выбрать пункт Orders в появившемся меню.

  2. Выбрать заказ, по которому необходимо выполнить возврат средств, выбрать пункт Invoices в левом меню карточки заказа и щёлкнуть кнопку Credit Memo в верхнем меню страницы счёта на оплату.
  3. Указать количество товаров, которые необходимо вернуть, и при необходимости щёлкнуть кнопку Update Qty's для обновления суммы возврата на странице выполнения возвратов New Memo.
  4. При необходимости указать комментарий для возврата в поле Credit Memo Comments.
  5. Подтвердить выполнение возврата.

    Для этого следует щёлкнуть кнопку Refund.

  6. Убедиться в том, что в истории заказа отображается информация о выполненном возврате.

    При выполнении частичного возврата заказу присваивается статус Processing, при выполнении полного возврата заказу присваивается статус Closed.

Контроль платежей и заказов

Контролировать информацию о заказах, включая базовые сведения о платежах, проводимых с помощью плагина от ecommpay, можно через интерфейс Magento, используя инструменты подраздела Orders в разделе Sales. Для получения более детальных сведений о платежах и возвратах можно использовать интерфейс Dashboard от ecommpay (но в нём не отображается информация о заказах).

В подразделе Orders отображается реестр заказов с основными сведениями о каждом из них, а также с возможностями поиска, фильтрации, перехода к карточкам отдельных заказов и выполнения различных действий.

Рис.: Реестр заказов в интерфейсе Magento

Щёлкнув строку отдельного заказа в реестре, можно перейти в его карточку, где Для перехода к карточке конкретного заказа можно щёлкнуть его строку в реестре. В карточках отображаются развёрнутые сведения о заказах (включая дату создания, статус, сумму заказа и адрес доставки), а также базовые сведения о платежах и другая информация. Карточки заказов состоят из следующих секций:

  • Order & Account Information — с информацией о заказе и пользователе;
  • Address Information — с информацией о расчётном адресе и адресе доставки пользователя;
  • Payment & Shipping Method — с базовыми сведениями о платеже и способе доставки;
  • Items Ordered — с информацией о приобретённых товарах.

Рис.: Карточка заказа в интерфейсе Magento

Более подробная информация о работе с заказами в интерфейсе Magento представлена в документации Magento.

Параметры использования платёжных методов

При работе с плагином от ecommpay в интерфейсе Magento можно настраивать использование различных платёжных методов, подключённых в рамках проекта мерчанта. Это можно делать через отдельные раскрывающиеся блоки на странице с параметрами работы плагина, задавая следующие параметры:Card payments (с параметрами для карточных платежей) и Alternative payment settings (с параметрами использования альтернативных методов). Последний блок в частности содержит блок More payment methods via ecommpay, в котором можно настраивать использование полной группы методов, подключённых в проекте, — это может быть актуально, например, когда используются методы, для которых не выделены отдельные блоки в параметрах работы плагина.

Совет: Раскрывающиеся блоки, отображаемые по умолчанию, исключить из параметров работы плагина нельзя, даже если соответствующие методы не используются в проекте. Если актуально работать с другими методами, их использование в плагине можно настраивать только в блоке More payment methods via ecommpay, предварительно обратившись к специалистам технической поддержки ecommpay для подключения методов в проекте.

В раскрывающихся блоках для настройки использования платёжных методов можно задавать следующие параметры:

  • Общие параметры:
    • Enabled — возможность подключить платёжный метод для работы через плагин.;

      Для подключения метода следует установить значение Yes, для отключения метода — значение No.

    • Title — название платёжного метода, отображаемое на странице перехода к оплате в веб-сервисе.;
    • Show Description — возможность отображения текста из параметра Description.;
    • Description — текст, отображаемый пользователям при выборе конкретного платёжного метода.;
    • Sort Order — порядковый номер отображения названия платёжного метода, доступного через плагин от ecommpay, на странице перехода к оплате в веб-сервисе.;

      Чтобы название метода отображалось первым в списке методов, следует задать значение 0 или оставить поле пустым. При этом, если платёжный метод отключён от веб-сервиса, то вместо него отображается название метода под следующим номером. Если задать значение 0 или оставить поле пустым для нескольких методов, то названия этих методов отображаются в порядке расположения блоков с параметрами использования методов.

  • Параметры, актуальные только для блока Card payments:
    • Display mode — способ открытия платёжной формы Payment Page.

      Можно выбрать один из следующих способов:

      • Redirect — открытие в виде отдельной HTML-страницы;
      • Popup — открытие в модальном окне;
      • Embedded — открытие в элементе iframe.
        Прим.: При установке плагина или обновлении его версии этот способ настроен по умолчанию.

      В случае, если платёжная форма открыта в элементе iframe (способ Embedded), при выборе пользователем оплаты с использованием платёжной карты в списке вариантов для оплаты ему отображается платёжная форма Payment Page, с адаптацией под стандартное оформление страницы перехода к оплате в веб-сервисе и без кнопки для подтверждения согласия на оплату. В открывшейся форме пользователь может выбрать реквизиты платёжной карты (если они были сохранены ранее) или указать их, а затем — подтвердить готовность провести оплату с помощью кнопки для перехода к оплате на странице веб-сервиса. При выборе других платёжных методов пользователь перенаправляется на последующие страницы.

      Рис.: Пример открытия платёжной формы Payment Page на странице перехода к оплате

    Рис.: Блок Card payments с параметрами для карточных платежей

  • Параметр, актуальный только для блока More payment methods via ecommpay:
    • Payment method code — код платёжного метода, используемого как единственный дополнительный (по отношению к методам, для настройки работы с которыми применяются отдельные раскрывающиеся блоки).
      • Если не применять этот параметр, то при выборе метода оплаты в интерфейсе веб-сервиса пользователь может выбрать вариант More payment methods и перейти к платёжной форме с возможностью выбрать там один из методов, доступных для инициируемого платежа через платформу ecommpay. При этом все методы от ecommpay, доступные для выбора непосредственно в веб-сервисе (наряду с вариантом More payment methods), оказываются доступными и в платёжной форме.
      • Если указать в значении этого параметра код одного из доступных методов (в соответствии со справочником), то при выборе методов оплаты в интерфейсе веб-сервиса наряду с другими доступными там для выбора методами пользователь может выбрать указанный и перейти к работе с ним, минуя выбор каких-либо других методов в платёжной форме. Чтобы не допускать коллизий с таким выбором, при указании кода какого-либо метода в этом разделе также следует указывать название этого метода для отображения в веб-сервисе (в поле Title).
      Прим.: Поскольку в тестовом режиме работы плагина доступны оплаты только с прямым использованием платёжных карт, тестировать работу блока More payment methods via ecommpay в таком случае можно только для метода card.

    Рис.: Блок More payment methods via ecommpay с параметрами использования полной группы методов