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

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

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

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

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

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

   1. Перейти на вкладку Payments в подразделе Settings раздела WooCommerce.
   2. Найти в столбце Method один из настроенных платёжных методов для работы с ecommpay и щёлкнуть кнопку General settings в соответствующей строке.
2. Задать основные параметры работы плагина на вкладке General:
   • Project ID — идентификатор тестового проекта.;
   • Secret Key — ключ тестового проекта для взаимодействия с платформой.;
   • Purchase type — вариант проведения оплат: Sale (one-step purchase) (для проведения одностадийных оплат) или Auth (two-step purchase) (для проведения двухстадийных оплат);
     • Sale (one-step purchase) — в одну стадию (с незамедлительным списанием средств);
     • Auth (two-step purchase) — в две стадии (с предварительной блокировкой и последующим списанием средств).
   • Automatic cancellation of payments — автоматическая отмена блокировки средств в рамках двухстадийных оплат при отмене соответствующих заказов.;

     Для подключения этой возможности, следует установить флажок Enable. В таком случае при переводе заказа в статус Cancelled двухстадийная оплата в рамках этого заказа автоматически отклоняется.

   • Language — язык отображения платёжной формы.

   

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

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

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

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

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

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

   • Complete order automatically — возможность автоматического завершения заказов при проведении платежей.;

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

   

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

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

5. При необходимости подключить возможность незамедлительного списания средств в рамках заказов с определёнными типами товаров (на вкладке Products в параметрах работы плагина) и сохранить изменения (с помощью кнопки Save changes).

   Использование этой возможности может быть актуально при работе с двухстадийными оплатами и осуществляется через проведение одностадийных оплат.

   Чтобы подключить возможность незамедлительного списания средств, следует перейти на вкладку Products в параметрах работы плагина и установить флажки Enable automatic confirmation of payments в следующих параметрах:

   • Virtual products — для заказов с виртуальными товарами;
   • Downloadable products — для заказов со скачиваемыми товарами.

   При этом необходимо учитывать следующие условия:

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

   Информация о работе с типами товаров virtual и downloadable представлена в документации WooCommerce.

6. Сохранить изменения.

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

   

7. Если используется дополнение WooCommerce Subscriptions, при необходимости подключить возможность незамедлительного списания средств для регистрации оплат по подпискам в рамках заказов с определёнными типами товаров (на вкладке Subscriptions в параметрах работы плагина) и сохранить изменения (с помощью кнопки Save changes).

   Использование этой возможности может быть актуально при работе с двухстадийными оплатами и осуществляется через проведение одностадийных оплат.

   Чтобы подключить возможность незамедлительного списания средств, следует перейти на вкладку Subscriptions в параметрах работы плагина и установить флажки Enable automatic confirmation of payments в следующих параметрах:

   • Virtual subscriptions — для заказов с виртуальными товарами;
   • Downloadable subscriptions — для заказов со скачиваемыми товарами;
   • Other subscriptions — для заказов с товарами любого типа, кроме виртуальных и скачиваемых.

   При этом необходимо учитывать следующие условия:

   • Если флажок установлен для одного из параметров, то незамедлительное списание средств осуществляется, только если в заказе присутствуют товары соответствующего типа (например, virtual или downloadable). Если же в заказе присутствуют товары разных типов или типов, для которых флажок не установлен, выполняется блокировка средств в рамках двухстадийной оплаты.
   • Если флажок установлен для нескольких параметров, то незамедлительное списание средств происходит, если в заказе присутствуют товары одного из указанных типов или всех типов, для которых установлен флажок.
8. Сохранить изменения.

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

   

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

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

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

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

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

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

   1. Перейти на вкладку Payments в подразделе Settings раздела WooCommerce.
   2. Найти в столбце Method один из настроенных платёжных методов для работы с ecommpay и щёлкнуть кнопку General settings в соответствующей строке.
2. Задать основные параметры работы плагина на вкладке General:
   • Project ID — идентификатор рабочего проекта;
   • Secret Key — ключ рабочего проекта для взаимодействия с платформой;
   • Purchase type — вариант проведения оплат: Sale (one-step purchase) (для проведения одностадийных оплат) или Auth (two-step purchase) (для проведения двухстадийных оплат);
     • Sale (one-step purchase) — в одну стадию (с незамедлительным списанием средств);
     • Auth (two-step purchase) — в две стадии (с предварительной блокировкой и последующим списанием средств).
   • Automatic cancellation of payments — автоматическая отмена списаний в рамках двухстадийных оплат при отмене соответствующих заказов.;

     Для подключения этой возможности, следует установить флажок Enable. В таком случае при переводе заказа в статус Cancelled двухстадийная оплата в рамках этого заказа автоматически отклоняется.

   • Language — язык отображения платёжной формы.

   

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

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

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

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

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

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

   • Complete order automatically — возможность автоматического завершения заказов при проведении платежей.;

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

   

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

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

5. При необходимости подключить возможность незамедлительного списания средств в рамках заказов с определёнными типами товаров (на вкладке Products в параметрах работы плагина) и сохранить изменения (с помощью кнопки Save changes).

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

   Чтобы подключить возможность незамедлительного списания средств, следует перейти на вкладку Products в параметрах работы плагина и установить флажки Enable automatic confirmation of payments в следующих параметрах:

   • Virtual products — для заказов с виртуальными товарами;
   • Downloadable products — для заказов со скачиваемыми товарами.

   При этом необходимо учитывать следующие условия:

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

   Информация о работе с типами товаров virtual и downloadable представлена в документации WooCommerce.

6. Сохранить изменения.

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

   

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

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

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

Чтобы настроить возможность незамедлительного списания средств при регистрации оплат по подпискам, следует перейти на вкладку Subscriptions в параметрах работы плагина ecommpay Payments и установить флажки Enable automatic confirmation of payments в следующих параметрах:

• Virtual subscriptions — для заказов с виртуальными товарами;
• Downloadable subscriptions — для заказов со скачиваемыми товарами;
• Other subscriptions — для заказов с товарами любого типа, кроме виртуальных и скачиваемых.

При этом необходимо учитывать следующие условия:

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

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

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

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

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

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

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

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

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