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

Введение

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

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

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

Возможности

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

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

    Для этого достаточно всего нескольких действий в интерфейсе CMS WordPress.

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

    Для этого можно использовать вкладки с параметрами использования платёжных методов, расположенные в карточке плагина интерфейса WordPress.

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

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

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

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

  • Регистрировать и проводить повторяемые оплаты (по подпискам) с прямым использованием платёжных карт и с применением методов Apple Pay и Google Pay — при использовании в веб-сервисе дополнения WooCommerce Subscriptions.

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

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

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

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

    Для этого можно использовать интерфейс WordPress, и если необходимо, — интерфейс Dashboard от ecommpay, с синхронизацией информации между этим интерфейсом и интерфейсом WordPress (кроме случаев, когда по оплатам были выполнены возвраты средств через Gate или Dashboard; в таких ситуациях статусы платежей могут не обновляться в интерфейсе WordPress).

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

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

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

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

  • Использовать различные возможности, обеспечиваемые со стороны разработчиков плагина WooCommerce.

    В частности, можно регулировать применение этого плагина (и связанного с ним плагина ecommpay Payments) в разных странах (подробнее).

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

Схема работы

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

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

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

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

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

Оплатам, проводимым по представленной схеме через платёжную платформу ecommpay, присваиваются статусы в соответствии с моделью проведения платежей ecommpay (подробнее), а заказам, формируемым на стороне веб-сервиса, — в соответствии с моделью выполнения заказов WooCommerce (подробнее). Контролировать такие статусы и другую информацию о платежах и заказах можно в разделах интерфейса WordPress: Orders (для разовых оплат) и Subscriptions (для повторяемых оплат). А с вопросами о соответствии статусов платежей и заказов можно обращаться к курирующему менеджеру ecommpay.

Установка

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

Чтобы начать работу с плагином ecommpay Payments версии 3.4, его необходимо установить. При этом, если ранее использовалась одна из предыдущих версий этого плагина, такую версию рекомендуется предварительно деактивировать (это можно сделать через список установленных плагинов в интерфейсе WordPress). Установить плагин можно через интерфейс WordPress двумя способами — непосредственно через магазин плагинов WordPress (без предварительного скачивания файла плагина) или с помощью функции загрузки плагинов в интерфейсе (предварительно скачав файл). Скачать файл плагина можно из каталога плагинов или на портале GitHub.

Внимание: Если до установки плагина использовалась и не была деактивирована одна из его предыдущих версий, то после установки в интерфейсе WordPress может отображаться уведомление о необходимости обновить параметры работы. В таком случае необходимо щёлкнуть кнопку Run the updater и дождаться обновления параметров, иначе ранее настроенные параметры могут не сохраниться.

Установка через каталог плагинов

Для установки через каталог плагинов следует перейти в интерфейс WordPress и выполнить следующие действия:

  1. Выбрать раздел Plugins на панели навигации и пункт Add New в появившемся меню.
  2. Выполнить поиск плагина ecommpay Payments от ecommpay, используя поисковую строку на открывшейся странице.

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

  3. Щёлкнуть кнопку Install now (или кнопку Update Now, если использовалась более ранняя версия плагина) на этой панели и дождаться завершения установки.

    Рис.: Использование страницы CMS WordPress для установки плагина через каталог

  4. Активировать плагин с помощью кнопки Activate, которая отображается вместо кнопки Install now (или кнопки Update Now) после установки.
  5. Если выполняется обновление плагина для уже работающего веб-сервиса и обновляемая или деактивированная ранее версия плагина была подключённой — убедиться, что плагин не был автоматически подключён к веб-сервису при активировании (во избежание доступности плагина пользователям до настройки параметров его работы).

    Для этого следует: убедиться, что для всех методов, настроенных для работы с плагином, переключатель Enable выключен.

    1. Перейти на вкладку Payments в подразделе Settings раздела WooCommerce.
    2. Найти в столбце Method платёжные методы для работы с ecommpay и убедиться, что в строках для всех методов переключатель Enable выключен (и выключить его, если это необходимо).
Прим.: Если ранее использовалась одна из предыдущих версий плагина, обновить плагин до новой версии можно также через список установленных плагинов в интерфейсе WordPress (в подразделе Installed Plugins раздела Plugins).

Установка с помощью функции загрузки

Для установки с помощью функции загрузки плагинов следует перейти в интерфейс WordPress и выполнить следующие действия:

  1. Выбрать раздел Plugins на панели навигации и пункт Add New в появившемся меню.
  2. Щёлкнуть кнопку Выберите файл на открывшейся странице.

    Рис.: Использование страницы CMS WordPress для установки плагина через функцию загрузки

  3. Выбрать предварительно скачанный zip-архив плагина.
  4. Щёлкнуть кнопку Install Now и дождаться завершения установки.
  5. Щёлкнуть кнопку Activate Plugin для активации плагина (если плагин ещё не был установлен в веб-сервисе) или кнопку Replace current with uploaded для обновления его версии (если плагин уже был установлен).
    Прим.: При попытке обновить плагин в интерфейсе WordPress может отображаться уведомление о невозможности обновления и в списке установленных плагинов могут отображаться обе версии — предыдущая и новая. Это может быть вызвано тем, что названия zip-архивов с предыдущей и новой версиями отличаются. В таком случае для корректной работы плагина следует деактивировать и удалить предыдущую версию и активировать новую.
  6. Если выполняется обновление плагина для уже работающего веб-сервиса и обновляемая или деактивированная ранее версия плагина была подключённой — убедиться, что плагин не был автоматически подключён к веб-сервису при активировании (во избежание доступности плагина пользователям до настройки параметров его работы).

    Для этого следует: убедиться, что для всех методов, настроенных для работы с плагином, переключатель Enable выключен.

    1. Перейти на вкладку Payments в подразделе Settings раздела WooCommerce.
    2. Найти в столбце Method платёжные методы для работы с ecommpay и убедиться, что в строках для всех методов переключатель Enable выключен (и выключить его, если это необходимо).
  7. Если в интерфейсе WordPress отображается уведомление о необходимости обновить параметры работы плагина, щёлкнуть кнопку Run the updater и дождаться обновления параметров.

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

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

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

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

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

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

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

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

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

  1. Открыть карточку плагина в интерфейсе WordPress.

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

    1. Перейти на вкладку Payments в подразделе Settings раздела WooCommerce.
    2. Найти в столбце Method один из настроенных платёжных методов для работы с ecommpay и щёлкнуть кнопку General settings в соответствующей строке.
  2. Установить необходимый режим работы плагина на вкладке General и задать основные параметры его работы:
    • Demo mode — возможность установить тестовый режим работы плагина.;

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

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

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

  3. При необходимости задать дополнительные параметры работы плагина.:

    Для этого на вкладке General необходимо щёлкнуть ссылку Advanced settings и задать параметры в секциях Transaction Cache и Shop Admin Setup:

    • Enable Caching — возможность кеширования данных о платежах для оптимизации работы плагина в веб-сервисе.;
    • Cache Expiration — время хранения кешированных данных в секундах.;
    • Log Level — уровень протоколирования работы плагина.;

      Информацию о созданных протоколах можно найти на вкладке Logs в подразделе Status раздела WooCommerce.

    • Fetch Payment Info — возможность отображения статусов платежей в разделе Orders.;

      Если необходимо, чтобы статусы платежей отображались в разделе Orders, необходимо установить флажок Enable, иначе — снять. По умолчанию флажок установлен.

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

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

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

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

    При работе в тестовом режиме плагина достаточно задать параметры для карточных платежей на вкладке Card settings.

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

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

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

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

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

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

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

После проведения тестовых оплат можно тестировать выполнение возвратов. Для этого можно использовать интерфейсы Gate и Dashboard от ecommpay, а также интерфейс WordPress., но рекомендуется использовать последний, поскольку при выполнении возвратов через Gate или Dashboard статусы платежей в интерфейсе WordPress могут не обновляться. Следует учитывать, что для выполнения возвратов заказы должны быть в статусах Processing или Completed, а платежи — в статусах success или partially refunded.

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

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

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

  2. Выбрать заказ, по которому необходимо выполнить возврат средств, и щёлкнуть кнопку Refund в открывшейся карточке заказа.
  3. Указать количество товаров, которые необходимо вернуть (сумма возврата при этом рассчитывается автоматически), либо сумму возврата, не изменяя количество товаров в заказе.
  4. При необходимости указать причину возврата в поле Reason for refund.
  5. Подтвердить выполнение возврата.

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

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

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

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

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

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

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

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

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

Настройка параметров работы с разовыми оплатами

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

  1. Открыть карточку плагина в интерфейсе WordPress.

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

    1. Перейти на вкладку Payments в подразделе Settings раздела WooCommerce.
    2. Найти в столбце Method один из настроенных платёжных методов для работы с ecommpay и щёлкнуть кнопку General settings в соответствующей строке.
  2. Установить рабочий режим плагина и задать основные параметры его работы на вкладке General:
    • Demo mode — возможность установить тестовый режим работы плагина.

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

    • Project ID — идентификатор рабочего проекта;
    • Secret Key — ключ рабочего проекта для взаимодействия с платформой;
    • Language — язык отображения платёжной формы.

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

  3. При необходимости задать дополнительные параметры работы плагина.:

    Для этого на вкладке General необходимо щёлкнуть ссылку Advanced settings и задать параметры в секциях Transaction Cache и Shop Admin Setup:

    • Enable Caching — возможность кеширования данных о платежах для оптимизации работы плагина в веб-сервисе.;
    • Cache Expiration — время хранения кешированных данных в секундах.;
    • Log Level — уровень протоколирования работы плагина.;

      Информацию о созданных протоколах можно найти на вкладке Logs в подразделе Status раздела WooCommerce.

    • Fetch Payment Info — возможность отображения статусов платежей в разделе Orders.;

      Если необходимо, чтобы статусы платежей отображались в разделе Orders, необходимо установить флажок Enable, иначе — снять. По умолчанию флажок установлен.

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

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

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

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

Настройка параметров работы с повторяемыми оплатами

Чтобы настроить регистрацию и проведение повторяемых оплат (по подпискам) с использованием плагина ecommpay Payments и дополнения WooCommerce Subscriptions, следует настроить рабочие параметры плагина ecommpay Payments (как и для разовых оплат) и использовать инструменты, расположенные в карточке плагина WooCommerce на вкладке Subscriptions. Среди прочего, на этой вкладке можно задавать названия кнопок, используемых для добавления в корзину и оплаты товаров по подписке, варианты возобновления повторяемых оплат после их приостановки и другие параметры. Информацию о работе с повторяемыми оплатами через дополнение WooCommerce Subscriptions можно найти в документации WooCommerce.

Рис.: Вкладка Subscriptions с параметрами настройки повторяемых оплат

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

По оплатам, проведённым с помощью плагина ecommpay Payments, можно выполнять частичные и полные возвраты — для заказов в статусах Processing или Completed и для платежей в статусах success или partially refunded. Это можно делать через интерфейс WordPress (в рамках карточных платежей) и через интерфейсы платёжной платформы ecommpay (в рамках всех платёжных методов, используемых в проекте): программный интерфейс Gate и пользовательский интерфейс Dashboard (с инструментами единичной и пакетной отправки запросов). При возвратах через интерфейс WordPress всю актуальную информацию о платежах можно получать через него, а также через интерфейсы платформы (например, Dashboard и Data API), поскольку в таких случаях вся информация синхронизируется. Вместе с тем, стоит учитывать, что при возвратах через интерфейсы платформы статусы платежей и заказов могут не обновляться в интерфейсе WordPress, но статусы заказов можно изменять вручную.

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

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

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

  2. Выбрать заказ, по которому необходимо выполнить возврат средств, и щёлкнуть кнопку Refund в открывшейся карточке заказа.
  3. Указать количество товаров, которые необходимо вернуть (сумма возврата при этом рассчитывается автоматически), либо сумму возврата, не изменяя количество товаров в заказе.
  4. При необходимости указать причину возврата в поле Reason for refund.
  5. Подтвердить выполнение возврата.

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

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

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

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

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

Контролировать информацию о платежах (в том числе о списаниях в рамках повторяемых оплат), проводимых с помощью плагина ecommpay Payments, а также о соответствующих заказах можно можно через интерфейс WordPress, используя инструменты подраздела Orders в разделе WooCommerce.

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

Прим.: Стоит учитывать, что в некоторых случаях в интерфейсе WordPress может отсутствовать актуальная информация, в частности когда по оплатам были выполнены возвраты средств через Gate или Dashboard или когда информация была удалена из интерфейса WordPress. В таких ситуациях получать информацию о платежах можно с помощью инструментов платёжной платформы ecommpay (таких как Dashboard и Data API).

В подразделе Orders отображается реестр заказов с основными сведениями о каждом из них, а также с возможностями поиска, фильтрации, перехода к карточкам отдельных заказов и выполнения различных действий. (Вместе со статусами заказов в этом реестре могут отображаться и статусы платежей — если в параметрах работы плагина установлен флажок Fetch Payment Info.)

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

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

  • ecommpay Payment — с информацией о платеже и возможностью обновлять эту информацию вручную с помощью кнопки Refresh;
  • Order actions — с инструментами для выполнения различных действий, доступных в рамках заказа;
  • Order notes — с уведомлениями о различных событиях, касающихся заказа и платежа.

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

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

Контроль повторяемых оплат

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

Рис.: Реестр подписок в интерфейсе WordPress

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

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

При работе с плагином ecommpay Payments в интерфейсе WordPress можно настраивать использование различных платёжных методов, подключённых в рамках проекта мерчанта. Это можно делать через отдельные вкладки в карточке плагина, задавая следующие параметры: — такие как Card settings (с параметрами для карточных платежей), Pay by Bank (с параметрами для использования методов группы Open Banking в странах Европы) или More methods (с параметрами для использования полной группы методов, подключённых в проекте).

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

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

  • Общие параметры:
    • Enable/Disable — возможность подключения платёжного метода для работы через плагин.;
    • Title — название платёжного метода, отображаемое на странице перехода к оплате в интерфейсе WooCommerce.;
    • Show Description — возможность отображения текста из параметра Description.;
    • Description — текст, отображаемый пользователям при выборе конкретного платёжного метода.;
    • Order button text — название кнопки для перехода к оплате (например, «Оплатить заказ»).
  • Параметры, актуальные только для вкладки Card settings:
    • Display mode — способ открытия платёжной формы Payment Page.

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

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

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

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

    • Close on misclick — возможность закрытия платёжной формы, отображаемой в модальном окне, по щелчку вне этого окна.

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

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

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

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