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

Вимоги

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

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

PHP: 8.0 або новіша.

Валюта магазину: євро (EUR). Eupago приймає платежі лише в євро, тож для інших валют спосіб оплати приховується на оформленні замовлення.

Обліковий запис Eupago: потрібні API-ключ вашого каналу Eupago і ключ Webhook 2.0, який ви створюєте в бекофісі Eupago (див. Налаштування). Бекофіс робочого середовища — clientes.eupago.pt, бекофіс тестового — sandbox.eupago.pt. Sandbox і live — окремі облікові записи з окремими ключами.

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

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

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

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

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

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

5. Введіть API-ключ вашого каналу Eupago, створіть Webhook 2.0 у бекофісі Eupago і вставте його ключ (див. Налаштування).

6. Оберіть Payment Method, увімкніть Enable/Disable, зробіть тестове замовлення в режимі sandbox, а потім зніміть позначку з Sandbox Mode.

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

Усі параметри розташовані на одній сторінці: WooCommerce > Settings > Payments > Eupago. Коли шлюз увімкнено, сторінка попереджає, якщо API-ключ поточного режиму порожній (тоді шлюз приховано на оформленні замовлення), або показує Sandbox mode: no real payments are taken., поки ввімкнено режим sandbox. У списку способів оплати Eupago позначено як такий, що потребує дії, доки не вказано API-ключ поточного режиму, а в режимі sandbox відображається позначка тестового режиму.

Загальні

Enable/Disable: Enable Eupago Gateway вмикає або вимикає спосіб оплати. За замовчуванням: off.

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

Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay securely via Eupago.

Payment Method: єдиний спосіб Eupago, який пропонується на оформленні замовлення.

Order Status After Payment: статус замовлення, який встановлюється після підтвердження оплати: Processing (за замовчуванням) або Completed. Статус встановлюється одразу, з однією зміною статусу та одним листом.

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

Отримайте API-ключ вашого каналу та ключ Webhook 2.0 у бекофісі Eupago: clientes.eupago.pt (live) або sandbox.eupago.pt (sandbox).

Sandbox Mode: Enable sandbox/test mode використовує sandbox.eupago.pt і ключі sandbox. Реальні платежі не приймаються. За замовчуванням: on. Зніміть позначку, щоб приймати реальні платежі з ключами live.

Live API Key: API-ключ вашого робочого каналу Eupago (clientes.eupago.pt).

Live Webhook Key: ключ шифрування вашого робочого Webhook 2.0. Обов'язковий: сповіщення без дійсного підпису відхиляються.

Sandbox API Key: API-ключ вашого тестового каналу (sandbox.eupago.pt).

Sandbox Webhook Key: ключ шифрування вашого тестового Webhook 2.0.

URL вебхука

Вебхук повідомляє магазин, що платіж здійснено. У бекофісі Eupago створіть Webhook 2.0 з URL, який показано в цьому розділі налаштувань, методом POST і увімкненим шифруванням. URL має такий вигляд: https://your-site/wc-api/eupago_payment_callback/. Створіть один вебхук у бекофісі sandbox і інший у бекофісі live.

Скопіюйте ключ кожного вебхука в Sandbox Webhook Key або Live Webhook Key. Вебхуки без дійсного підпису відхиляються. Незашифрований вебхук приймається лише якщо Eupago його підписує, тож тримайте шифрування увімкненим. Плагін реагує на такі статуси сповіщень:

Інші статуси не потребують дій. Застарілий GET-callback Eupago на той самий URL також приймається; він автентифікується API-ключем і завжди повідомляє про платіж. Без сповіщень замовлення ніколи не позначаються оплаченими: плагін не опитує Eupago, а повернення покупця не оплачує замовлення.

Додатково

Debug Log: Enable logging записує виклики API і сповіщення до WooCommerce > Status > Logs, джерело wcp_eupago_gateway. Ключі, листи та повні номери телефонів не записуються. Помилки записуються завжди. За замовчуванням: off.

Delete Data on Uninstall: Delete all plugin data when uninstalling. Якщо позначено, налаштування шлюзу та журнали видаляються під час видалення плагіна. Замовлення та їхні платіжні дані зберігаються. За замовчуванням: off.

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

Покупець обирає спосіб оплати (за замовчуванням Eupago) і оформлює замовлення. У режимі sandbox оформлення замовлення показує SANDBOX / TEST MODE. Що відбувається далі, залежить від Payment Method.

Multibanco: на оформленні замовлення покупець бачить You will receive Multibanco payment details after placing the order. Плагін створює референс Multibanco на суму замовлення. Замовлення переходить у статус «Очікується», залишки на складі зменшуються, кошик очищається. Сторінка «Замовлення отримано» показує Multibanco Payment Details з кодом організації, референсом і сумою. Ті самі дані додаються до листа про замовлення, поки воно очікує оплати. Покупець сплачує в банкоматі або інтернет-банкінгу.

MB WAY: на оформленні замовлення покупець вводить MB WAY Phone Number, поле заповнюється телефоном з платіжних даних. Португальські номери можна вводити без +351. Неправильний номер виводить Please enter a valid MB WAY phone number (e.g. 912 345 678 or +351 912 345 678). Плагін надсилає запит на оплату в застосунок MB WAY. Замовлення переходить у статус «Очікується», залишки зменшуються, кошик очищається. На сторінці «Замовлення отримано» покупцю пропонується відкрити застосунок MB WAY і підтвердити запит протягом 5 хвилин.

Credit Card: на оформленні замовлення покупець бачить You will be redirected to a secure payment page to enter your card details. Покупця надсилають на сторінку оплати карткою Eupago португальською, іспанською або англійською мовою залежно від мови сайту. Замовлення лишається у статусі «Очікує оплати», кошик зберігається. Після оплати покупець повертається на сторінку «Замовлення отримано», яка показує Your card payment is being confirmed by Eupago. You will receive an e-mail as soon as it is confirmed. до надходження сповіщення. Якщо оплата карткою не вдалася або її перервано, покупець потрапляє на сторінку Pay for order з повідомленням The card payment was not completed. You can try again or choose another payment method. або The card payment was cancelled. You can try again or choose another payment method.

Для кожного способу замовлення позначається оплаченим лише після підтвердження Eupago перевіреним сповіщенням. Покупець може знову оплатити неоплачене замовлення зі сторінки Pay for order; кожен платіжний референс, створений для замовлення, залишається дійсним для перевірки.

Якщо Eupago не може розпочати платіж, покупець бачить коротке повідомлення, наприклад The payment could not be started because Eupago is temporarily unavailable. Please try again in a few minutes or choose another payment method. Замовлення не змінюється, а подробиці є в журналі.

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

Плагін пропонує один спосіб оплати Eupago на інсталяцію. Немає повернень із WooCommerce, збережених карток, підписок чи попередньої авторизації, немає PayShop, Cofidis Pay, Bizum та інших способів Eupago, немає SMS-нагадувань, терміну дії Multibanco та опитування статусу.

Замовлення

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

Pending payment: розпочато платіж карткою, але Eupago його ще не підтвердив.

On hold, awaiting payment: створено референс Multibanco або запит MB WAY. У примітці до замовлення показано код організації та референс або замаскований номер телефону.

Processing or Completed: оплату підтверджено. Статус відповідає Order Status After Payment. У примітці до замовлення показано спосіб оплати, ID транзакції Eupago і референс. ID транзакції замовлення — це ID транзакції Eupago.

On hold, manual review: Eupago повідомив про платіж з іншою сумою або валютою, з референсом, який не було створено для цього замовлення, або для замовлення, яке тим часом було скасовано чи завершилося невдачею (наприклад, референс Multibanco оплачено із запізненням). Примітка це пояснює. Перевірте платіж і залишки, потім завершіть замовлення вручну або оформіть повернення покупцю. Наступні сповіщення про цей платіж не завершують замовлення без вашого відома.

Cancelled: Eupago повідомив, що платіж скасовано або він минув, для поточної спроби оплати неоплаченого замовлення.

Failed: Eupago повідомив про помилку для поточної спроби оплати неоплаченого замовлення.

Якщо Eupago повідомляє про інший платіж за вже оплачене замовлення (наприклад, було оплачено і попередній референс Multibanco), замовлення не змінюється. Примітка просить перевірити дубльований платіж і повернути його в бекофісі Eupago. Сповіщення про платіж ніколи не відкриває знову замовлення, яке було оплачене, а потім скасоване або повернене.

Повернення: повернення з WooCommerce не підтримуються. Поверніть кошти покупцю в бекофісі Eupago і зафіксуйте повернення в WooCommerce кнопкою Refund manually.

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

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

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

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

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

Усунення несправностей

Eupago не з'являється на оформленні замовлення: перевірте, що ліцензія активна, увімкнено Enable/Disable, задано API-ключ поточного режиму (Sandbox API Key у режимі sandbox, Live API Key у робочому режимі) і валюта магазину — EUR. За Multibanco сума замовлення має бути від 1 € до 999 999,99 €.

Платіж пройшов, але замовлення залишається Pending payment або On hold: сповіщення Eupago не надходить або відхиляється. У бекофісі Eupago потрібного режиму перевірте, що Webhook 2.0 існує, що його URL точно збігається з показаним у налаштуваннях, що метод POST і шифрування увімкнено. Перевірте, що його ключ стоїть у потрібному полі (Sandbox Webhook Key або Live Webhook Key). Увімкніть Debug Log і подивіться WooCommerce > Status > Logs, джерело wcp_eupago_gateway. Якщо сповіщення так і не надходить, перевірте платіж у бекофісі Eupago.

Вебхук відповідає Invalid signature або Missing signature: ключ вебхука в плагіні не збігається з ключем вебхука, або вебхук не зашифрований і не підписаний. Скопіюйте ключ знову і залиште шифрування увімкненим.

Вебхук відповідає Webhook key not configured: жоден із ключів вебхука не задано. Eupago повторює сповіщення після того, як ви вставите ключ.

Вебхук відповідає Decryption failed: підпис дійсний, але тіло запиту не вдалося розшифрувати. Перевірте налаштування Webhook 2.0 у бекофісі Eupago.

Вебхук відповідає Environment mismatch: сповіщення підписано ключем іншого режиму, ніж той, у якому було оформлено замовлення. Сповіщення з sandbox ніколи не оплачує замовлення з live і навпаки.

Застарілий callback відповідає Invalid API key: API-ключ, надісланий Eupago, не збігається з Live API Key або Sandbox API Key.

Покупець бачить The MB WAY payment could not be started: перевірте, що номер телефону прив'язано до MB WAY, і спробуйте ще раз.

Замовлення в статусі On hold після оплати: прочитайте примітку до замовлення. Сума або валюта відрізнялися, референс був невідомим або платіж надійшов після скасування замовлення. Перевірте платіж у бекофісі Eupago, потім завершіть замовлення або оформіть повернення покупцю.

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

Для розробників документація плагіна описує фільтри eupago_p_icon (іконка на оформленні замовлення) і eupago_p_card_language (мова сторінки оплати карткою Eupago: PT, EN або ES).

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити плагін, деактивуйте його і видаліть на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна видаляються завжди. Налаштування шлюзу та журнали видаляються, лише якщо була увімкнена опція Delete Data on Uninstall. Інакше вони зберігаються для повторного встановлення. Замовлення та їхні референси Eupago зберігаються завжди. Наявні замовлення зберігають примітки про оплату та ID транзакцій.

Eupago — товарний знак його власника. Цей плагін не пов'язаний з Eupago і не схвалений Eupago.