VibeFox eWAY for WooCommerce — Помощь

Требования

WordPress: 6.0 или новее.

WooCommerce: 8.0 или новее, установлен и активен.

PHP: 8.0 или новее.

Валюта магазина: AUD, NZD, SGD, HKD или MYR. Для других валют способ оплаты скрывается при оформлении заказа. Заказ списывается в его собственной валюте.

Учётная запись eWAY: нужна учётная запись мерчанта eWAY с доступом к Rapid API, а также её ключ и пароль Rapid API, которые берутся в MyeWAY: Settings, API Key. Для тестов нужна учётная запись sandbox eWAY со своими ключом и паролем. Ключи sandbox и рабочей среды различаются. В eWAY ничего настраивать не нужно: адрес возврата передаётся с каждым платежом.

Лицензионный ключ VibeFox: покупается на vibefox.net. Один ключ работает на одном домене.

Установка

1. В WordPress перейдите в Plugins > Add New > Upload Plugin, выберите ZIP-архив плагина и нажмите Install Now. Также можно загрузить папку wcp_eway_payment_gateway в /wp-content/plugins/ по FTP.

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Payments > eWAY > Manage или нажмите Settings под названием плагина на странице Plugins.

4. Введите лицензионный ключ VibeFox в блоке лицензии в верхней части страницы и нажмите Activate.

5. Введите ключ и пароль API sandbox, оставьте включённым Sandbox Mode, включите Enable/Disable и сделайте тестовый заказ тестовой картой eWAY 4444333322221111.

6. Введите ключ и пароль API рабочей среды, снимите галочку с Sandbox Mode и сохраните.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > eWAY. Над полями бейдж показывает режим: SANDBOX (платежи уходят в sandbox eWAY, реальные деньги не списываются) или LIVE (реальные платежи проводятся с рабочим ключом API). Страница предупреждает, если не заполнены ключ и пароль API текущего режима (тогда шлюз не показывается при оформлении заказа), и если валюта магазина не поддерживается. В списке способов оплаты eWAY помечен как требующий настройки, пока для текущего режима нет учётных данных, а в режиме sandbox отображается бейдж тестового режима.

Общие

Enable/Disable: Enable eWAY Payment Gateway включает или выключает способ оплаты. По умолчанию: выключено.

Title: название способа оплаты, которое видят покупатели при оформлении заказа. По умолчанию: Credit Card (eWAY).

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.

Учётные данные API

Ключ и пароль Rapid API находятся в MyeWAY: Settings, API Key. eWAY публикует руководства по ключам рабочей среды и sandbox, ссылки на них есть в этом разделе. Sandbox и рабочая среда используют разные ключи.

Sandbox Mode: Enable sandbox (test) mode отправляет платежи в sandbox eWAY с ключом sandbox. Реальные деньги не списываются. По умолчанию: включено. Снимите галочку, чтобы принимать реальные платежи с рабочим ключом.

Live API Key: ключ Rapid API вашей рабочей учётной записи eWAY.

Live API Password: пароль Rapid API вашей рабочей учётной записи eWAY.

Sandbox API Key: ключ Rapid API вашей учётной записи sandbox (partner/developer) eWAY.

Sandbox API Password: пароль Rapid API вашей учётной записи sandbox eWAY.

Заказы

Order Status on Success: статус заказа после того, как eWAY подтвердит оплату.

Дополнительно

Debug log: Enable logging записывает вызовы API и результаты платежей в WooCommerce > Status > Logs, источник wcp_eway_payment_gateway. Данные карт и ключи не записываются. Ошибки записываются всегда. По умолчанию: выключено.

Uninstall: Delete all plugin data on uninstall. Если галочка стоит, при удалении плагина удаляются настройки шлюза и его журналы. Ссылки на платежи, сохранённые в заказах, остаются. По умолчанию: выключено.

Оформление заказа

Покупатель выбирает способ оплаты (по умолчанию Credit Card (eWAY)) и оформляет заказ. Плагин запрашивает у eWAY страницу оплаты на сумму заказа в его валюте, с номером заказа как ссылкой на счёт и платёжными данными покупателя, и отправляет покупателя на Responsive Shared Page eWAY. Там покупатель оплачивает картой. Платёж списывается сразу.

После оплаты покупатель возвращается в ваш магазин. Плагин не доверяет браузеру: он запрашивает у eWAY по каналу сервер-сервер результат страницы оплаты, созданной для этого заказа. Заказ отмечается оплаченным только после подтверждения eWAY и совпадения подтверждённых суммы и валюты с заказом. Затем покупатель попадает на страницу «Заказ получен». Если в этот момент запросить eWAY не удалось, заказ остаётся в статусе «Ожидает оплаты», а страница показывает We have not received the confirmation of your payment from eWAY yet. If you completed the payment, this order will be updated shortly — please do not pay again. Платёж проверяется повторно при открытии страницы «Заказ получен» и до того, как WooCommerce автоматически отменит неоплаченный заказ.

Если платёж отклонён, покупатель возвращается к оформлению заказа (или на страницу Pay for order) и видит причину, например Your payment was declined: Insufficient funds. Please try again or use a different payment method. Если покупатель нажимает Cancel на странице eWAY, плагин сначала проверяет в eWAY, что ничего не оплачено. Заказ, созданный при оформлении, затем отменяется, а заказ, оплачиваемый со страницы Pay for order, остаётся неоплаченным. Покупатель видит You cancelled the payment on the eWAY page. Your order has not been paid — you can try again. Если оплата не завершилась, сообщение: The payment was not completed. Please try again.

Покупатель может повторно оплатить неоплаченный заказ. Отслеживается каждая страница оплаты заказа, поэтому оплата по более ранней странице тоже распознаётся. Если eWAY не может создать страницу оплаты, покупатель видит короткое сообщение, например Payment error: Unable to connect to eWAY. Please try again.

Способ оплаты работает в классическом оформлении заказа, в блоке «Оформление заказа» и на странице Pay for order. Он совместим с HPOS (хранилищем заказов высокой производительности) WooCommerce.

eWAY не отправляет уведомления по каналу сервер-сервер для Shared Page: результат получается при возвращении покупателя и при проверках, описанных выше. В плагине нет полей для карт на вашем сайте, нет сохранённых карт и подписок, нет авторизации без списания с последующим списанием, и он не оценивает фрод-баллы Beagle (транзакции, заблокированные правилами антифрода eWAY, отклоняет сам eWAY).

Заказы и возвраты

Статусы заказа

Pending payment: покупатель был отправлен в eWAY и ещё не оплатил, либо результат пока не удалось получить от eWAY (об этом говорит примечание к заказу).

Processing or Completed: платёж подтверждён. Статус соответствует Order Status on Success. Примечание к заказу показывает ID транзакции eWAY, код авторизации и ответ. ID транзакции заказа — это ID транзакции eWAY.

On hold after payment: eWAY подтвердил сумму или валюту, отличающиеся от заказа (например, Approved for partial amount, или заказ был изменён после того, как покупатель открыл страницу оплаты), либо платёж был подтверждён после отмены заказа. Примечание объясняет причину. На странице «Заказ получен» покупатель видит Your payment was received and is being reviewed by the store. We will contact you if anything is needed. Завершите заказ или верните платёж.

Failed: eWAY отклонил платёж. Примечание показывает код eWAY и его значение.

Cancelled: покупатель отменил платёж на странице eWAY после оформления заказа, либо заказ был отменён вами или по таймауту резервирования остатков WooCommerce после того, как eWAY подтвердил, что платёж не оплачен.

Если для уже оплаченного заказа подтверждается второй платёж, заказ не меняется. Примечание просит вас вернуть дубликат в MyeWAY.

Возвраты

Откройте заказ, нажмите Refund, укажите сумму и нажмите Refund via Credit Card (eWAY) (кнопка использует название способа оплаты). Поддерживаются полные и частичные возвраты. Возврат отправляется в той среде, где был проведён платёж (sandbox или рабочая), поэтому в ней должны быть заданы ключ и пароль API. Если eWAY отклонит возврат, WooCommerce покажет код eWAY, и возврат не будет записан. Успешный возврат добавляется в примечания к заказу с ID транзакции возврата eWAY.

Возвраты, оформленные в MyeWAY, не синхронизируются с WooCommerce. При необходимости создайте ручной возврат в WooCommerce, не используя кнопку возврата eWAY.

Лицензионный ключ

Плагин работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии находится в верхней части страницы WooCommerce > Settings > Payments > eWAY. Вставьте ключ в поле License key и нажмите Activate. В блоке отображается статус, например дата, до которой лицензия активна, и ваш домен. Кнопка Check now проверяет статус ещё раз, Change key позволяет ввести другой ключ, а Remove key удаляет ключ с этого сайта. Ссылка Manage licenses and domains in your account открывает вашу учётную запись на vibefox.net.

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает занятый им домен. Освободите место в своей учётной записи на vibefox.net.

Без активного ключа eWAY не показывается покупателям при оформлении заказа. Если оплата всё же начата, покупатель видит This payment method is not available. Please choose another one. Вошедшие администраторы магазина по-прежнему видят способ оплаты, помеченный (unlicensed — visible to admins only), чтобы вы могли настроить и протестировать плагин до покупки ключа. Напоминание появляется на странице Plugins и на страницах WooCommerce. Существующие заказы не затрагиваются: уже начатые платежи по-прежнему подтверждаются, возвраты работают.

Когда срок лицензии истекает, плагин продолжает работать, но для обновлений и поддержки нужно продление. Статус автоматически проверяется в фоновом режиме.

Устранение неполадок

eWAY does not appear at checkout: проверьте, что лицензия активна, Enable/Disable включён, заданы ключ и пароль API текущего режима (поля sandbox в режиме sandbox, поля рабочей среды в рабочем режиме), и что валюта магазина — AUD, NZD, SGD, HKD или MYR. На странице Pay for order проверяется валюта заказа.

The payment went through, but the order stays Pending payment: покупатель не вернулся из eWAY, либо в этот момент не удалось запросить eWAY. eWAY не отправляет уведомлений для Shared Page. Платёж проверяется повторно при открытии страницы «Заказ получен» и до того, как WooCommerce отменит неоплаченный заказ. Проверьте транзакцию в MyeWAY и посмотрите WooCommerce > Status > Logs, источник wcp_eway_payment_gateway.

Покупатель видит сообщение This payment method is temporarily unavailable: ключ или пароль API текущего режима не заданы, либо eWAY их отклонил. Проверьте учётные данные текущего режима.

Покупатель видит сообщение eWAY could not start the payment: eWAY вернул коды ошибок, которые показаны в сообщении. Часто причина в некорректных платёжных данных.

Покупатель видит сообщение We could not match this payment to an order: ссылка возврата не относится ни к одному заказу этого магазина. Если с покупателя списали деньги, найдите платёж в MyeWAY.

Покупатель видит сообщение We could not confirm your payment with eWAY: результат платежа не удалось проверить. Заказ обновится, когда результат будет получен; покупателю не нужно платить повторно.

Order is On hold after payment: прочитайте примечание к заказу. Подтверждённые сумма или валюта отличались от заказа, либо платёж поступил после отмены заказа. Завершите заказ или верните платёж.

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

Блок лицензии показывает ошибку: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите место в учётной записи на vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать по последнему известному статусу.

Для разработчиков: в readme перечислен фильтр eway_p_supported_currencies — на случай, если ваша учётная запись eWAY подключена к большему числу валют.

Удаление

Деактивация плагина сохраняет все данные. Чтобы удалить плагин, деактивируйте его и удалите на странице Plugins. Лицензионный ключ и статус лицензии этого плагина удаляются всегда. Настройки шлюза и журналы удаляются, только если была включена опция Uninstall (Delete all plugin data on uninstall). Иначе они сохраняются для повторной установки. Ссылки на платежи, сохранённые в заказах, остаются всегда. Существующие заказы сохраняют свои примечания об оплате и ID транзакций.

eWAY — товарный знак его правообладателя. Этот плагин не аффилирован с eWAY и не одобрен компанией eWAY.