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 нічого налаштовувати не потрібно: URL повернення передається з кожним платежем.

Ліцензійний ключ 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.

Спосіб оплати працює на класичному оформленні замовлення, у блоці Checkout та на сторінці 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.