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

Вимоги

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

WooCommerce: 8.0 або новіша версія, установлено й увімкнено.

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

Валюта магазину: чилійський песо (CLP) або долар США (USD). Для інших валют спосіб оплати приховується під час оформлення замовлення. Для магазинів із CLP установіть WooCommerce > Settings > General > Number of decimals на 0, оскільки Flow стягує цілі песо.

Обліковий запис Flow: потрібні API Key і Secret Key вашого облікового запису Flow, у Flow в розділі Mis datos, Datos técnicos. Для перевірок створіть окремий тестовий обліковий запис на sandbox.flow.cl і використовуйте його ключі. Тестові та робочі ключі різні. В обліковому записі Flow нічого налаштовувати не потрібно.

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

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

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

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

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

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

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

5. Введіть тестові API Key і Secret Key, увімкніть Enable / Disable, збережіть і оформіть тестове замовлення.

6. Для приймання реальних платежів заповніть робочі ключі та зніміть прапорець Sandbox mode.

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

Усі налаштування розміщено на одній сторінці: WooCommerce > Settings > Payments > Flow.cl. Над полями сторінка попереджає, коли ключі поточного режиму порожні (тоді Flow приховано при оформленні замовлення), валюта магазину не підтримується або магазин із CLP використовує десяткові знаки (Flow стягує цілі песо, тому встановіть Number of decimals на 0, щоб ціни, підсумки та повернення коштів точно збігалися). У тестовому режимі відображається Sandbox mode — платежі йдуть на sandbox.flow.cl, реальні гроші не стягуються. У списку способів оплати Flow позначено як такий, що потребує налаштування, доки немає ключів поточного режиму, а в тестовому режимі показано відповідну позначку.

Загальні налаштування

Enable / Disable: Enable Flow.cl payments вмикає або вимикає спосіб оплати. Типово: вимкнено.

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

Description: текст під способом оплати при оформленні замовлення. Типово: Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.

Облікові дані API Flow

Скопіюйте API Key і Secret Key з облікового запису Flow (Mis datos, Datos técnicos): робочі ключі на www.flow.cl, тестові — на sandbox.flow.cl (окремий тестовий обліковий запис).

Sandbox mode: Use the Flow sandbox (sandbox.flow.cl) and the sandbox keys. У тестовому режимі реальні гроші не стягуються. Типово: увімкнено. Вимкніть його й заповніть робочі ключі для приймання реальних платежів. Повернення коштів завжди використовують середовище, у якому оплачено замовлення.

Sandbox API Key: API Key вашого облікового запису sandbox.flow.cl.

Sandbox Secret Key: Secret Key вашого облікового запису sandbox.flow.cl. Використовується для підпису кожного запиту.

Live API Key: API Key вашого облікового запису www.flow.cl.

Live Secret Key: Secret Key вашого облікового запису www.flow.cl. Зберігайте його в таємниці.

Сповіщення

Плагін надсилає Flow три URL з кожним платежем і поверненням коштів, тому в обліковому записі Flow нічого налаштовувати не потрібно. Розділ перелічує їх:

Підтвердження містить лише платіжний токен. Потім плагін запитує у Flow статус платежу підписаним запитом у середовищі, де створено платіж, і застосовує лише відповідь Flow. Платіж, який цей магазин не створював для замовлення, відхиляється. Без підтвердження замовлення оновлюється, коли покупець повертається з Flow.

Розширені налаштування

Debug log: Log API calls and notifications у WooCommerce > Status > Logs, джерело wcp_flow_gateway, без ключів і даних покупців. Помилки записуються завжди. Типово: вимкнено.

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Flow data saved on orders is kept). Типово: вимкнено.

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

Покупець вибирає спосіб оплати (типово Flow) й оформлює замовлення. У тестовому режимі при оформленні показано SANDBOX MODE — платежі йдуть у тестове середовище Flow. Реальних списань немає. Потрібна дійсна платіжна електронна адреса. Плагін створює платіж Flow на загальну суму замовлення у його валюті з темою Order #, доповненою номером замовлення та назвою сайту, і спрямовує покупця на платіжну сторінку Flow. Там покупець вибирає спосіб оплати, увімкнений у вашому обліковому записі Flow.

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

Якщо платіж відхилено, покупець повертається на сторінку Pay for order (або оформлення замовлення) з повідомленням Your Flow payment was rejected. Please try again or choose another payment method. Якщо покупець залишив сторінку Flow без оплати, повідомлення — The Flow payment was not completed. You can try again or choose another payment method. Якщо результат не вдалося перевірити, повідомлення — We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. Кожна нова спроба створює новий платіж Flow, прив'язаний до замовлення.

Якщо Flow не може почати оплату, покупець бачить коротке повідомлення, наприклад Could not connect to Flow. Please try again in a moment. Подробиці містяться в журналі.

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

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

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

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

Pending payment: покупця спрямовано до Flow, і він ще не заплатив. Примітка замовлення показує суму та номер замовлення Flow для цієї спроби.

On hold, awaiting coupon payment: покупець створив платіжний купон Servipag або Multicaja. Замовлення змінюється, коли Flow підтверджує оплату.

Processing: Flow повідомив про оплату, сума та валюта збігаються (замовлення лише з віртуальними завантажуваними товарами переходять у статус «Виконано» — типова поведінка WooCommerce). Примітка замовлення показує суму та номер замовлення Flow. Ідентифікатор транзакції замовлення — номер замовлення Flow.

On hold, amount/currency mismatch: Flow повідомив іншу суму чи валюту, ніж у замовленні. Замовлення не позначено оплаченим; перевірте його вручну.

On hold, payment for a cancelled order: надійшов платіж за замовлення, скасоване без оплати. Перевірте замовлення й відправте його або поверніть платіж у Flow.

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

Cancelled: останню спробу оплати анульовано у Flow.

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

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

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

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

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

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

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

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

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

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

Flow не з'являється при оформленні замовлення: перевірте, що ліцензія активна, Enable / Disable увімкнено, ключі поточного режиму заповнені (тестові в тестовому режимі, робочі в робочому), а валюта магазину — CLP або USD. На сторінці Pay for order перевіряється валюта замовлення.

Платіж пройшов, але замовлення залишається в статусі Pending payment: підтвердження Flow не доходить до магазину, а покупець не повернувся. Перевірте, що показаний у налаштуваннях URL підтвердження доступний з інтернету й не заблокований обслуговуванням, паролем чи брандмауером. Увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело wcp_flow_gateway.

Підтвердження відповідає Payment does not belong to the order або Unknown order: платіж не створено цим магазином для цього замовлення або створено в іншому середовищі. Замовлення не змінюється.

Підтвердження відповідає Gateway not configured: ключі середовища платежу порожні. Введіть їх знову.

Підтвердження відповідає Flow API unavailable: запит статусу до Flow не вдався. Flow повторює підтвердження.

Покупець бачить Flow payments are not available at the moment: ключі відсутні або Flow їх відхилив. Перевірте API Key і Secret Key поточного режиму.

Покупець бачить A valid billing email is required for Flow payments: Flow потрібна електронна адреса покупця.

Покупець заплатив, але замовлення має статус On hold: прочитайте примітку замовлення. Покупець створив ще не оплачений купон для готівки або сума чи валюта від Flow не відповідають замовленню. Підсумки CLP із десятковими знаками округлюються до цілих песо, тому встановіть Number of decimals на 0.

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

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

Для розробників у readme вказано фільтр wc_flw_supported_currencies (валюти, для яких пропонується шлюз).

Видалення

Після вимкнення плагіна всі дані зберігаються. Щоб видалити його, вимкніть і видаліть його на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна видаляються завжди. Налаштування шлюзу та журнали видаляються лише за ввімкненого Delete data on uninstall. Інакше вони залишаються для подальшого встановлення. Дані Flow, збережені в замовленнях, залишаються завжди. Наявні замовлення зберігають платіжні примітки та ідентифікатори транзакцій.

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