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

Вимоги

WordPress: 6.0 або новіша.

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

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

Магазин Barion: потрібні POSKey (секретний ключ) вашого магазину та e-mail адреса гаманця Barion, на який надходять платежі. Обидва показані в порталі Barion: secure.barion.com для робочого режиму, secure.test.barion.com для тестового, у розділі My stores і вашому магазині. Тестові та робочі облікові дані різні.

Валюта: валюта магазину має бути HUF, EUR, USD або CZK. Для інших валют спосіб оплати приховується під час оформлення замовлення.

Доступний магазин: Barion звертається до вашого магазину після кожного платежу, тож сайт має бути доступний з інтернету без режиму обслуговування, брандмауера чи базової автентифікації перед /wc-api/.

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

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

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

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

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

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

5. Введіть тестовий POSKey і тестовий e-mail гаманця, залиште Test Mode увімкненим і увімкніть Enable/Disable. Зробіть тестове замовлення.

6. Коли все працює, введіть робочі облікові дані та зніміть позначку з Test Mode.

Callback-адреса надсилається в Barion автоматично з кожним платежем. Нічого не потрібно налаштовувати в порталі Barion.

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

Усі параметри розміщені на одній сторінці: WooCommerce > Settings > Payments > Barion. Якщо валюта магазину не підтримується, сторінка повідомляє про це червоним шрифтом у розділі Облікові дані магазину Barion і перелічує підтримувані валюти; спосіб оплати тоді приховується під час оформлення замовлення.

Загальні

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

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

Description: текст під способом оплати під час оформлення замовлення. За замовчуванням: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.

Облікові дані магазину Barion

POSKey і e-mail гаманця отримайте в порталі Barion: secure.barion.com (робочий) або secure.test.barion.com (тестовий), My stores, ваш магазин. Тут також показано callback-адресу, наприклад https://your-site/wc-api/barion_payment_callback/. Вона надсилається в Barion з кожним платежем; достатньо, щоб вона була доступна з інтернету.

Test Mode: Enable Barion test/sandbox mode. Тестовий режим використовує тестові облікові дані нижче та sandbox Barion (api.test.barion.com); справжні гроші не списуються. За замовчуванням: увімкнено. Зніміть позначку, щоб приймати справжні платежі.

Test POSKey: секретний ключ (POSKey) вашого магазину в тестовій системі Barion (secure.test.barion.com, My stores).

Test Payee Email: e-mail адреса вашого тестового гаманця Barion, на який надходять тестові платежі.

Live POSKey: секретний ключ (POSKey) вашого магазину в робочій системі Barion (secure.barion.com, My stores).

Live Payee Email: e-mail адреса вашого гаманця Barion, на який надходять платежі.

Замовлення

Order Status After Payment: статус замовлення, який встановлюється після успішного перевіреного платежу.

Додатково

Logging: Enable debug logging. Журнали зберігаються в WooCommerce > Status > Logs, джерело wcp_barion_gateway. Секретні ключі ніколи не записуються. За замовчуванням: вимкнено.

Delete Data on Uninstall: Remove the plugin settings when the plugin is deleted. Замовлення та їхні дані платежів Barion завжди зберігаються. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Barion) і оформлює замовлення. Плагін запускає платіж Barion на суму замовлення у валюті замовлення і надсилає покупця на платіжну сторінку Barion. Товари замовлення, доставка, комісії та податок перелічуються в платежі, e-mail для рахунку покупця передається як підказка, а мова сторінки відповідає мові магазину там, де Barion її підтримує.

Після оплати покупець повертається до вашого магазину. Barion також викликає callback-адресу. Жоден із цих запитів сам по собі не позначає замовлення оплаченим: плагін запитує в Barion стан платежу за вашим POSKey, і замовлення позначається оплаченим лише після того, як Barion підтвердить його і сума та валюта збігаються із замовленням. Посилання для повернення містить ключ замовлення, і перевіряються лише платежі, розпочаті для цього замовлення.

Якщо платіж успішний або ще триває в Barion, покупець потрапляє на сторінку підтвердження замовлення. Інакше покупець повертається до оформлення замовлення і бачить Payment was not completed. Please try again. Покупець може спробувати знову; кожна спроба запам'ятовується, тож пізній платіж за попередньою спробою все одно завершує замовлення.

Якщо платіж не вдалося розпочати, покупець бачить The Barion payment could not be started. Please try again or choose another payment method. Менеджери магазину, які ввійшли в систему, бачать також технічну причину. Подробиці потрапляють до журналу.

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

Плагін працює лише з негайними платежами. Він не підтримує платежі з резервуванням чи відкладеним захопленням, підписки або регулярні платежі WooCommerce, не зберігає картки, не містить Barion Pixel і не передає додаткових даних 3-D Secure; 3-D Secure обробляє Barion на своїй платіжній сторінці.

Замовлення та повернення коштів

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

Pending payment: платіж Barion розпочато, а Barion ще не підтвердив його. Примітка до замовлення показує Barion PaymentId, суму та, у тестовому режимі, (test mode).

Processing or Completed: Barion підтвердив платіж. Статус відповідає налаштуванню Order Status After Payment. Примітка до замовлення показує суму, PaymentId і транзакцію. ID транзакції — це ID транзакції Barion.

On hold: Barion повідомив іншу суму або валюту, ніж сума замовлення, наприклад тому, що замовлення змінили після розпочатого платежу. Перевірте платіж у порталі Barion і завершіть або поверніть замовлення вручну.

Cancelled: остання спроба платежу була скасована або прострочена в Barion.

Failed: остання спроба платежу не вдалася.

Оплачене або повернене замовлення ніколи не змінюється пізнішим callback. Якщо для оплаченого замовлення успішно проходить інший платіж, примітка просить перевірити його в порталі Barion і повернути, якщо це дублікат.

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

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via Barion. Підтримуються повне та часткове повернення. Причина повернення надсилається в Barion як коментар. Повернення в HUF мають бути цілими сумами. Повернення надсилається в той режим (тестовий або робочий), у якому було оплачено замовлення, тож POSKey цього режиму має бути заданий. Якщо Barion не приймає або не підтверджує повернення, WooCommerce показує помилку, і повернення не записується. Успішне повернення додається до приміток замовлення разом з транзакцією та статусом Barion.

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

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

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

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

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

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

Barion не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, для поточного режиму є POSKey і e-mail отримувача, а валюта магазину — HUF, EUR, USD або CZK.

Платіж пройшов, але замовлення залишається Pending payment: замовлення завершується, коли Barion викликає callback-адресу або коли покупець повертається до вашого магазину. Переконайтеся, що сайт доступний з інтернету (без режиму обслуговування, брандмауера чи базової автентифікації перед /wc-api/). Перевірте, що POSKey того режиму, в якому було оплачено замовлення, правильний, адже плагін запитує в Barion стан платежу саме з ним. Увімкніть Logging, щоб побачити callback.

Callback відповідає Busy, retry: замовлення в цей момент обробляло повернення покупця. Barion викликає знову.

Callback відповідає API error: магазин не зміг зчитати стан платежу з Barion. Перевірте POSKey того режиму, в якому було оплачено замовлення.

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

Чому не вдається повернути 10,50 HUF: Barion обробляє HUF без десяткових знаків. Введіть ціле значення.

Повернення повідомляє, що POSKey для режиму цього замовлення не налаштовано: замовлення було оплачено в тестовому або робочому режимі, а POSKey цього режиму порожній. Введіть його і повторіть спробу.

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

Видалення

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

Barion є товарним знаком відповідного власника. Цей плагін не пов'язаний із компанією Barion і не схвалений нею.