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

Вимоги

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

WooCommerce: 8.0 або новіша версія, встановлений і активний. Плагін не активується без нього.

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

Валюта: південноафриканський ранд (ZAR). Спосіб оплати приховується для інших валют. Ozow списує цілі копійки, тому WooCommerce має використовувати 2 десяткові знаки.

Обліковий запис Ozow: обліковий запис мерчанта Ozow із Site Code і Private Key вашого сайту Ozow, які беруться в обліковому записі мерчанта Ozow. API Key необов'язковий, але рекомендований. Ozow використовує той самий Site Code і ті самі ключі для тестових і реальних платежів.

Доступний сайт: ваш сайт має бути доступним з інтернету: без режиму обслуговування, парольного захисту та брандмауера, що блокує Ozow, щоб сповіщення від Ozow надходили.

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

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

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

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

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

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

5. Введіть Site Code і Private Key, а бажано також API Key з облікового запису мерчанта Ozow.

6. Увімкніть Enable/Disable. Здійсніть тестовий платіж із увімкненим Test mode, а потім вимкніть тестовий режим, щоб приймати реальні платежі.

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

Усі налаштування розміщені на одній сторінці: WooCommerce > Settings > Payments > Ozow. Над полями сторінка попереджає, якщо немає Site Code або Private Key (тоді Ozow приховано на оформленні замовлення), якщо валюта магазину не ZAR, і якщо WooCommerce використовує більше 2 десяткових знаків, а також показує Test mode is on: no real payments are accepted. Do not ship orders paid in test mode. поки тестовий режим увімкнено. У списку способів оплати Ozow позначено як такий, що потребує налаштування, доки не заповнені Site Code і Private Key.

Загальні

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

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

Description: текст під способом оплати на сторінці оформлення замовлення. За замовчуванням: Pay instantly and securely from your South African bank account. You will be redirected to Ozow to choose your bank and approve the payment. У тестовому режимі під ним додається рядок TEST MODE: no money will be charged.

Облікові дані Ozow

Скопіюйте Site Code, Private Key і API Key з облікового запису мерчанта Ozow (Merchant details / Sites). Розділ містить посилання на документацію з інтеграції Ozow на hub.ozow.com.

Site Code: Site Code сайту Ozow, який отримує платежі. Відповіді для іншого Site Code відхиляються.

Private Key: підписує кожен запит на оплату і перевіряє кожну відповідь Ozow. Зберігайте його в таємниці. Без нього спосіб оплати приховується і жодна відповідь Ozow не приймається.

API Key (recommended): необов'язковий. З API Key кожен успішний платіж додатково підтверджується через Ozow GetTransaction API, перш ніж замовлення буде позначено оплаченим. API має повідомити, що платіж завершено, для цього замовлення, з тією самою сумою, валютою і Site Code.

Test mode: Enable Ozow test mode. Ozow використовує той самий Site Code і ті самі ключі для тестів: платежі створюються з IsTest=true, і жодні кошти не переказуються. Замовлення, оплачені в тестовому режимі, отримують примітку; не відправляйте їх. Вимкніть тестовий режим, щоб приймати реальні платежі. Тестовий платіж ніколи не оплачує замовлення в робочому режимі. За замовчуванням: увімкнено.

Сповіщення про оплату

URL сповіщення, успіху, скасування та помилки передаються Ozow з кожним платежем, тому в обліковому записі Ozow нічого налаштовувати не потрібно, якщо тільки ваш сайт Ozow не налаштований на фіксовані URL. У розділі показано URL сповіщення. Він має такий вигляд: https://your-site/wc-api/ozow_pay/?ozow_notify=1. Якщо ваш сайт Ozow використовує фіксовані URL, скопіюйте його точно так, як показують налаштування.

Додатково

Debug log: Log payment requests and Ozow responses записує деталі до WooCommerce > Status > Logs, джерело wcp_ozow_pay. Помилки та попередження завжди записуються. Ключі, хеші та дані покупців ніколи не записуються. За замовчуванням: вимкнено.

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Ozow data saved on orders is kept). За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Instant EFT (Ozow)) і оформлює замовлення. Плагін надсилає покупця на розміщену сторінку оплати Ozow із підписаним запитом на суму замовлення в ZAR. Посилання у банківській виписці: Order і номер замовлення (до 20 латинських літер, цифр, пробілів і дефісів). Ім'я покупця передається в Ozow. На сторінці Ozow покупець обирає південноафриканський банк і підтверджує платіж у банківському застосунку.

Далі Ozow повідомляє магазин і повертає покупця. Обидва запити містять однакову підписану відповідь і обробляються однаково, тож замовлення оновлюється, навіть якщо один із них загубився. Замовлення позначається оплаченим лише після підтвердження Ozow: хеш має бути перевірений вашим Private Key, Site Code має бути вашим, відповідь має містити ключ цього замовлення, а сума й валюта мають збігатися із замовленням. З API Key платіж додатково перевіряється через GetTransaction API.

Після успішної оплати покупець потрапляє на сторінку отримання замовлення. Якщо Ozow ще не підтвердив платіж, сторінка показує We are waiting for Ozow to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Якщо замовлення на утриманні, там буде Your Ozow payment was received and is being reviewed by the store. We will contact you if anything is needed.

Якщо покупець скасовує платіж на сторінці Ozow або платіж не вдається, замовлення переходить у статус Failed, а покупець повертається на сторінку Pay for order з повідомленням The Ozow payment was cancelled. You can try again or choose another payment method. або The Ozow payment was not completed. You can try again or choose another payment method. Покупець може повторно оплатити те саме замовлення.

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

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

Замовлення

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

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

Processing: платіж підтверджено. Це стандартний статус WooCommerce після оплати; замовлення лише з віртуальними товарами для завантаження переходять у статус Completed. Примітка до замовлення показує суму й ID транзакції Ozow, а також те, чи підтверджено платіж через GetTransaction API. ID транзакції замовлення — це TransactionId Ozow. Тестовий платіж отримує примітку TEST MODE — no money was received, do not ship this order.

On hold: причину вказано в примітці до замовлення. Ozow або банк перевіряє платіж (замовлення оновиться, коли Ozow надішле фінальний статус); оплачена сума або валюта не збігаються із замовленням; надійшов платіж за вже скасоване замовлення; або, з API Key, GetTransaction API ще не зміг підтвердити платіж чи суперечить йому. Перевірте платіж в обліковому записі Ozow і змініть статус замовлення. Якщо API не зміг відповісти, наступне сповіщення від Ozow завершить замовлення.

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

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

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

Повернення з WooCommerce не підтримуються. Поверніть платіж в обліковому записі мерчанта Ozow і вручну зафіксуйте повернення у WooCommerce.

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

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

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

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

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

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

Ozow не з'являється на оформленні замовлення: перевірте, що ліцензія активна, увімкнено Enable/Disable, заповнено Site Code і Private Key, а валюта магазину або замовлення — ZAR. Сторінка налаштувань показує попередження, якщо чогось бракує.

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

Сповіщення відповідає Invalid hash: Private Key у налаштуваннях не належить сайту Ozow, який надіслав відповідь. Скопіюйте його знову з облікового запису мерчанта Ozow.

Сповіщення відповідає Unknown site: відповідь надійшла з іншого сайту Ozow. Перевірте Site Code.

Сповіщення відповідає Order mismatch або Order not found: відповідь не належить до замовлення цього магазину. Нічого не змінюється.

Сповіщення відповідає Gateway not configured: немає Site Code або Private Key. Заповніть їх; Ozow може повторити спробу.

Сповіщення відповідає Order busy: інша відповідь Ozow для того самого замовлення оброблялася в той самий момент. Ця відповідь не застосовується; її застосує наступне сповіщення або повернення покупця.

Сповіщення відповідає Payment not confirmed yet: з API Key GetTransaction API не зміг підтвердити платіж. Замовлення на утриманні, і наступне сповіщення його завершить. Якщо воно залишається на утриманні, перевірте API Key і платіж в обліковому записі Ozow.

Покупець бачить Ozow accepts payments in South African rand (ZAR) only: замовлення в іншій валюті. Ozow для нього не можна використати.

Тестовий платіж не оплатив замовлення: шлюз працює в робочому режимі. Тестові платежі ніколи не оплачують замовлення в робочому режимі; примітка до замовлення про це повідомляє.

Замовлення On hold після оплати: прочитайте примітку до замовлення і перевірте платіж в обліковому записі Ozow, потім переведіть замовлення в статус Processing або поверніть платіж в Ozow.

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

Видалення

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

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