VibeFox EveryPay for WooCommerce — Допомога

Вимоги

WordPress: 6.0 або новіша версія.

WooCommerce: 7.0 або новіша версія, встановлено та активовано.

PHP: 8.0 або новіша версія.

Обліковий запис EveryPay: вам потрібні ім'я користувача API, API secret та назва процесингового облікового запису вашого інтернет-магазину. Їх можна знайти в EveryPay Merchant Portal у налаштуваннях магазину: демо-портал (mwt-demo.every-pay.com) для тестового режиму та робочий портал (portal.every-pay.eu) для реальних платежів. Тестове та робоче середовища мають окремі облікові дані. URL callback вашого магазину також потрібно вказати в обох порталах (див. розділ «Налаштування»).

Валюта магазину: процесинговий обліковий запис визначає валюту списання, наприклад EUR3D1 списує в EUR. Спосіб оплати пропонується лише для замовлень у цій валюті.

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

Встановлення

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

2. Натисніть Activate.

3. Відкрийте налаштування: WooCommerce > Settings > Payments > EveryPay > Manage або натисніть Settings під назвою плагіна на сторінці «Плагіни».

4. Введіть ліцензійний ключ VibeFox у блоці ліцензії у верхній частині сторінки та натисніть Activate.

5. Введіть ім'я користувача API для тесту, API secret для тесту та назву процесингового облікового запису з демо-версії Merchant Portal. Залиште увімкненим Test Mode.

6. Скопіюйте URL callback, показаний на сторінці налаштувань, у Callback notification URL вашого магазину в Merchant Portal.

7. Увімкніть Enable/Disable і зробіть тестове замовлення. Коли все працює, введіть робочі облікові дані, вкажіть URL callback також у робочому порталі та зніміть позначку з Test Mode.

Налаштування

Усі налаштування розташовані на одній сторінці: WooCommerce > Settings > Payments > EveryPay. Над полями сторінка показує Test mode is on: payments go to the EveryPay demo environment, no real money is charged., поки ввімкнено тестовий режим. Вона попереджає, коли шлюз увімкнено, але для поточного режиму не заповнено ім'я користувача API, API secret або процесинговий обліковий запис (тоді спосіб оплати приховано на сторінці оформлення замовлення), а також коли процесинговий обліковий запис списує кошти у валюті, відмінній від валюти магазину. У списку способів оплати EveryPay позначено як такий, що потребує налаштування, доки не налаштовано поточний режим. Пробіли та переноси рядків, вставлені разом із обліковими даними, видаляються під час збереження.

Загальні

Enable/Disable: Enable EveryPay payment gateway вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.

Title: назва способу оплати, яку бачать покупці на сторінці оформлення замовлення. За замовчуванням: EveryPay.

Description: текст під способом оплати на сторінці оформлення замовлення. За замовчуванням: Pay securely by card or bank link on the EveryPay payment page.

Обліковий запис EveryPay

Ім'я користувача API, API secret та назва процесингового облікового запису показані в EveryPay Merchant Portal (налаштування магазину): демо-портал для тестового режиму, робочий портал для реальних платежів.

Test Mode: Enable test mode надсилає платежі в демо-середовище EveryPay з тестовими обліковими даними. Реальні кошти не списуються. За замовчуванням: увімкнено.

Test API Username: ім'я користувача API демо-середовища.

Test API Secret: API secret демо-середовища.

Live API Username: ім'я користувача API робочого середовища.

Live API Secret: API secret робочого середовища.

Processing Account Name: процесинговий обліковий запис EveryPay, наприклад EUR3D1. Обліковий запис визначає валюту списання: шлюз пропонується лише для замовлень у цій валюті. Однакова назва облікового запису використовується в обох режимах.

Сповіщення про платежі (callback)

Callback повідомляє вашому магазину, що платіж завершено, тому замовлення оновлюються, навіть якщо покупець закрив браузер. Скопіюйте URL із цього розділу в Callback notification URL вашого магазину в EveryPay Merchant Portal — і в демо-, і в робочому порталі. URL має вигляд https://your-site/wc-api/wc_evp_payment/. Запит на оплату не містить URL callback, тому його треба вказати в порталі.

Callback містить лише ідентифікатори платежів. Коли він надходить, плагін запитує в API EveryPay статус платежу в тому середовищі, де платіж створено, і перевіряє, що відповідь стосується цього замовлення. Callback для платежу, який це замовлення не створювало, відхиляється. Без callback замовлення підтверджується, коли покупець повертається до магазину після оплати, або коли ви запускаєте Check EveryPay payment status у замовленні.

Додатково

Debug log: Log payment events записує події платежів у WooCommerce > Status > Logs, джерело wcp_everypay_payment. Помилки завжди записуються в журнал. API secret і дані картки ніколи не записуються. За замовчуванням: вимкнено.

Uninstall: Delete the gateway settings and logs when the plugin is deleted. За замовчуванням: вимкнено.

Оформлення замовлення

Покупець обирає спосіб оплати (за замовчуванням EveryPay) і оформляє замовлення. У тестовому режимі на сторінці оформлення замовлення показується TEST MODE: EveryPay demo environment, no real money is charged. Плагін створює разовий платіж EveryPay на суму замовлення з e-mail і платіжними даними покупця та перенаправляє покупця на сторінку оплати EveryPay. Мова сторінки відповідає мові сайту (англійська, естонська, російська, латвійська, литовська, фінська або німецька; інакше англійська). Там покупець платить одним із способів, увімкнених для вашого облікового запису EveryPay.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після підтвердження EveryPay: плагін запитує в API EveryPay статус платежу під час повернення покупця та під час callback. Оплачене замовлення, замовлення на розгляді або платіж, що ще обробляється, веде на сторінку «Замовлення отримано».

Якщо платіж не пройшов, покупець повертається до оформлення замовлення (або на сторінку Pay for order) з повідомленням Your EveryPay payment was not successful. Please try again or choose another payment method. Якщо покупець залишив сторінку оплати, не оплативши, виводиться повідомлення The EveryPay payment was not completed. You can try again or choose another payment method. Кожна нова спроба створює новий платіж EveryPay; попередні спроби враховуються, тож платіж, зроблений за старішим посиланням, усе одно розпізнається.

Якщо EveryPay не може розпочати платіж, покупець бачить коротке повідомлення, наприклад EveryPay is temporarily unavailable. Please try again in a moment or choose another payment method. Деталі записані в журнал.

Спосіб оплати працює в класичному оформленні замовлення, у блоці Checkout і на сторінці Pay for order. Він сумісний із WooCommerce High-Performance Order Storage (HPOS). Тексти для покупців перекладено естонською мовою.

Плагін приймає лише разові платежі. У ньому немає повернень і списання авторизованих коштів із WooCommerce, збережених карток або оплати в один клік, підписок чи регулярних платежів, вбудованих полів картки та підтримки кількох валют.

Замовлення

Статуси замовлення

Pending payment: покупця перенаправлено до EveryPay, і він ще не оплатив, або платіж ще обробляється.

Processing: EveryPay повідомив, що платіж проведено або авторизовано (замовлення лише з віртуальними товарами для завантаження переходять у статус «Виконано», як у WooCommerce за замовчуванням). Примітка до замовлення показує суму, валюту та ідентифікатор платежу. ID транзакції замовлення — це ідентифікатор платежу EveryPay. Для авторизованого платежу примітка повідомляє, що кошти зарезервовано: якщо ваш обліковий запис не списує кошти автоматично, спишіть їх в EveryPay Merchant Portal. Коли він пізніше буде проведений, з'явиться одна примітка про це.

On hold after payment: платіж потребує ручного перегляду. Оплачені сума або валюта відрізняються від замовлення, замовлення було скасовано до надходження платежу, або замовлення тепер використовує інший спосіб оплати. Примітка пояснює це й повідомляє, що замовлення не позначено оплаченим. Перевірте платіж у Merchant Portal і вручну завершіть його або поверніть кошти. Наступні callback для цього платежу не завершують замовлення автоматично.

Failed: остання спроба оплати неоплаченого замовлення не вдалася, була перервана або анульована. Примітка показує причину від EveryPay. Покупець може повторити спробу.

Якщо для вже оплаченого замовлення завершується друга оплата, замовлення не змінюється. Примітка просить вас повернути дубльований платіж в EveryPay Merchant Portal.

Check EveryPay payment status

На екрані замовлення оберіть дію Check EveryPay payment status. Плагін перевіряє через API кожен платіж EveryPay у замовленні, застосовує результат, як описано вище, і додає примітку зі статусом кожного платежу. Використовуйте її для замовлень, для яких callback так і не надійшов.

Повернення коштів

Повернення з WooCommerce не підтримуються. Оформіть повернення в EveryPay Merchant Portal, потім змініть статус замовлення в WooCommerce. Коли EveryPay повідомляє, що платіж повернуто або оскаржено (chargeback), плагін лише додає примітку до замовлення; статус замовлення не змінюється.

Ліцензійний ключ

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

Один ключ працює на одному домені. Видалення ключа з сайту не звільняє слот домену. Звільніть слот в обліковому записі vibefox.net.

Без активного ключа EveryPay не показується покупцям на сторінці оформлення замовлення. Якщо платіж все ж розпочато, покупець бачить This payment method is not available. Please choose another one. Адміністратори магазину, які ввійшли в систему, як і раніше бачать спосіб оплати, позначений як (unlicensed — visible to admins only), щоб ви могли налаштувати й протестувати плагін до купівлі ключа. Нагадування з'являється на сторінці «Плагіни» та на сторінках WooCommerce. Існуючі замовлення не зачіпаються: вже розпочаті платежі й далі підтверджуються, а перевірка статусу працює.

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

Вирішення проблем

EveryPay не з'являється на сторінці оформлення замовлення: перевірте, що ліцензія активна, увімкнено Enable/Disable, задано ім'я користувача API, API secret і Processing Account Name поточного режиму, а валюта магазину (на сторінці Pay for order — валюта замовлення) збігається з валютою процесингового облікового запису. У цих випадках на сторінці налаштувань показується попередження.

Платіж пройшов, але замовлення залишається в статусі Pending payment: callback не працює. Перевірте, що URL callback із налаштувань вказано як Callback notification URL у Merchant Portal того режиму, який ви використовуєте (демо або робочий). Також можна відкрити замовлення та запустити Check EveryPay payment status. Увімкніть Debug log і подивіться в WooCommerce > Status > Logs, джерело wcp_everypay_payment.

Callback відповідає Unknown payment reference або Payment does not belong to this order: платіж створено не цим замовленням, або відповідь EveryPay з ним не збігається. Замовлення не змінюється.

Callback відповідає Not configured: відсутні облікові дані середовища, в якому створено платіж, наприклад для тестового платежу після видалення тестових облікових даних. Введіть їх знову; EveryPay повторить callback.

Callback відповідає Payment status unavailable або Busy, please retry: API EveryPay був недоступний, або замовлення в цей момент оновлював інший запит. EveryPay повторить callback.

Покупець бачить EveryPay is temporarily unavailable: EveryPay відхилив облікові дані або був недоступний. Перевірте ім'я користувача API та API secret поточного режиму.

Покупець бачить This payment method does not support the order currency: валюта замовлення відрізняється від валюти процесингового облікового запису.

Замовлення має статус On hold after payment: прочитайте примітку до замовлення. Сума або валюта не збігалися, або замовлення було скасовано до надходження платежу. Перевірте платіж у Merchant Portal і вручну завершіть його або поверніть кошти.

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

Для розробників у документації плагіна перелічено фільтри wc_evp_icon, wc_evp_locale, wc_evp_currency_decimals і wc_evp_oneoff_request.

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте та видаліть його на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються. Налаштування шлюзу та журнали видаляються, лише якщо була увімкнена опція Uninstall (Delete the gateway settings and logs when the plugin is deleted). Інакше вони зберігаються для повторного встановлення. Ідентифікатори платежів EveryPay, збережені в замовленнях, завжди зберігаються. Існуючі замовлення зберігають свої примітки про оплату та ID транзакцій.

EveryPay — торгова марка її власника. Цей плагін не афілійований з EveryPay і не схвалений EveryPay.