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

Вимоги

PrestaShop: 8.0–9.x.

PHP: 8.0 або новіша версія. Модуль відмовляється встановлюватися на старіших версіях PHP.

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

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

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

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

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

1. У back office перейдіть до Modules > Module Manager і натисніть Upload a module. Оберіть ZIP-файл модуля.

2. Коли завантаження завершиться, натисніть Configure або пізніше знайдіть VibeFox Barion Gateway у списку модулів і натисніть Configure.

3. Введіть ліцензійний ключ VibeFox у поле License key у блоці ліцензії у верхній частині сторінки Configure та натисніть Activate (див. Ліцензійний ключ).

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

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

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

Під час встановлення модуль створює два статуси замовлень: Awaiting Barion payment і Barion payment on hold. PrestaShop пропонує новий платіжний модуль для всіх валют, країн і груп клієнтів. Обмежити їх можна в розділі Payment > Preferences.

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

Усі налаштування розташовані на сторінці модуля: Modules > Module Manager > VibeFox Barion Gateway > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Над полями сторінка попереджає, якщо для поточного режиму немає POSKey або e-mail отримувача (тоді спосіб оплати приховано на етапі оформлення замовлення), а також якщо основна валюта вашого магазину не підтримується Barion — із переліком підтримуваних валют. Поки тестовий режим увімкнено, показується повідомлення Тестовий режим увімкнено: платежі надсилаються в пісочницю Barion (api.test.barion.com), реальні кошти не списуються.

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, ваш магазин. Тестовий режим використовує лише тестові облікові дані, робочий — лише робочі.

Test Mode: використовує тестові облікові дані, зазначені нижче, і пісочницю 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, на який надходять платежі.

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

Clear saved POSKeys: позначте ключ і натисніть Save, щоб видалити його. Порожнє поле зберігає збережене значення.

Callback URL: адреса, яку Barion викликає після кожного платежу, наприклад https://your-shop/module/wcp_barion_gateway/callback за умови дружніх URL, можливо з кодом мови, як-от /en/. Вона надсилається в Barion з кожним платежем, тож нічого налаштовувати не потрібно. Вона має лише бути доступною з інтернету.

Замовлення

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

Платежі, які Barion ще обробляє, очікують у статусі Awaiting Barion payment. Розбіжності суми чи валюти завжди переводять замовлення в Barion payment on hold.

Додатково

Logging: записує запити та callback-сповіщення Barion у файл logs/barion_p_debug.log.php у папці модуля. Файл не можна відкрити з веб-браузера. Секретні ключі та e-mail гаманців не записуються. За замовчуванням: вимкнено. Поки журнал вимкнено, нічого не записується, включно з помилками.

Log: показує розмір і останні записи журналу. Натисніть Clear log, щоб очистити його.

Delete Data on Uninstall: якщо увімкнено, видалення модуля також видаляє його налаштування та журнал. Замовлення, їхні платіжні дані Barion і статуси замовлень завжди зберігаються. За замовчуванням: вимкнено.

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

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

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

Якщо платіж успішний, замовлення створюється, і покупець бачить стандартну сторінку підтвердження замовлення з повідомленням Ваш платіж через Barion отримано. Якщо платіж ще обробляється в Barion, замовлення створюється у статусі Awaiting Barion payment, а сторінка показує Ваш платіж підтверджується Barion. Ви отримаєте e-mail, щойно його буде підтверджено. Якщо такий платіж пізніше буде скасовано, він прострочиться або не пройде в Barion, сторінка показує Ваш платіж через Barion не було завершено. Будь ласка, зв'яжіться з нами щодо цього замовлення. Якщо Barion недоступний, коли покупець повертається, відображається сторінка Підтвердження платежу з тим самим текстом «підтверджується» та кнопкою Check again; callback створить замовлення, щойно Barion підтвердить платіж.

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

Якщо платіж не вдалося розпочати, покупець залишається на етапі оформлення замовлення з коротким повідомленням: Не вдалося розпочати платіж через Barion. Спробуйте ще раз або оберіть інший спосіб оплати., Barion не підтримує платежі у валюті кошика, або Barion не може обробити замовлення з нульовою сумою. Деталі записуються в журнал, якщо увімкнено Logging.

Callback працює, поки магазин перебуває в режимі обслуговування, і не блокується обмеженням за країнами вашого магазину.

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

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

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

No order yet: покупця перенаправлено в Barion, і він не оплатив, або Barion ще не підтвердив платіж. Існує лише кошик.

Awaiting Barion payment: Barion повідомляє, що платіж ще обробляється. Примітка показує PaymentId Barion, суму і, у тестовому режимі, (test mode). Замовлення переходить у статус «Оплату прийнято», коли Barion підтверджує платіж.

Payment accepted or Delivered: Barion підтвердив платіж. Статус відповідає Order Status After Payment. Платіж фіксується з ідентифікатором транзакції Barion, а примітка показує суму, PaymentId і транзакцію.

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

Canceled: остання спроба оплати замовлення, що очікує, була скасована або прострочена в Barion.

Payment error: остання спроба оплати замовлення, що очікує, не вдалася.

Refunded: платіж повністю повернено через модуль.

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

Блок оплати Barion

На сторінці замовлення відображається блок Barion payment з PaymentId, транзакцією Barion, статусом платежу, сплаченою та поверненою сумою, позначкою Test mode для тестових платежів та історією повернень.

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

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

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

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

Модуль працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Barion Gateway є першим блоком на сторінці Modules > Module Manager > VibeFox Barion Gateway > Configure, над налаштуваннями. Вставте ключ у поле License key і натисніть Activate. Після цього блок показує ключ із прихованими символами, статус (наприклад, дату, до якої ліцензія активна, і ваш домен), а також кнопки Check now, щоб перевірити статус ще раз, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ із цього магазину. Нижче розташовані рядок Product: presta-payment-barion і посилання Manage licenses and domains in your account, що відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише співробітники з дозволом Configure для цього модуля. Тексти блоку відповідають мові back office (включено англійську та російську).

Якщо ключ не прийнято, блок пояснює причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on із датою. Після зміни адреси магазину або після звільнення місця для домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, модуль продовжує працювати за останнім відомим статусом.

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

Без активного ключа Barion не показується покупцям на етапі оформлення замовлення. Якщо платіж усе ж розпочато, покупець бачить This payment method is not available. Please choose another one. Вітрина PrestaShop не знає, що ви увійшли до back office, тому спосіб оплати приховано і для вас: ви можете налаштувати модуль до купівлі ключа, але не можете протестувати його на етапі оформлення замовлення. Нагадування з'являється в Modules > Module Manager на вкладці Alerts. Наявні замовлення не зачіпаються: платежі, які вже розпочато, і далі підтверджуються, а повернення працюють.

Коли ліцензія закінчується, модуль продовжує працювати, але оновлення та підтримка потребують продовження. Статус автоматично перевіряється знову, поки ви працюєте в back office: раз на день протягом перших 14 днів після введення ключа, далі — раз на тиждень. Cron-завдання не потрібне. Видалення або скидання модуля завжди видаляє ліцензійний ключ і статус ліцензії.

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

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

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

Callback відповідає Busy, retry: замовлення в цей момент оброблялося під час повернення покупця, або замовлення не вдалося створити (наприклад, модуль вимкнено). Barion викличе знову. Увімкніть Logging, щоб побачити причину.

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

Callback відповідає Order not found: PaymentId не був розпочатий цим магазином. Виклики Barion для інших магазинів або тестових систем ігноруються.

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

Покупець бачить помилку під час вибору Barion: увімкніть Logging і перегляньте поле Log на сторінці модуля. Невірний POSKey або e-mail отримувача призводить до повідомлення Не вдалося розпочати платіж через Barion.

Замовлення в статусі Barion payment on hold: прочитайте примітку про розбіжність у замовленні, перевірте платіж у порталі Barion, а потім виконайте замовлення або поверніть його в порталі Barion.

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

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

Видалення

Перейдіть до Modules > Module Manager, відкрийте меню поруч із VibeFox Barion Gateway і виберіть Uninstall. Ліцензійний ключ і статус ліцензії цього модуля завжди видаляються. Якщо Delete Data on Uninstall увімкнено, налаштування модуля та журнал видаляються. Якщо вимкнено, усі налаштування зберігаються для повторного встановлення. Платіжні дані Barion для замовлень і статуси замовлень Awaiting Barion payment та Barion payment on hold завжди зберігаються, тож замовлення, оплачені раніше, можна буде повернути після повторного встановлення. Наявні замовлення зберігають свої примітки про оплату та ідентифікатори транзакцій.

Barion є торговельною маркою її власника. Цей модуль не є афілійованим із Barion і не схвалений Barion.