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

Вимоги

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

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

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

Обліковий запис DPO Pay: вам потрібні Company Token та Service Type ID вашого облікового запису мерчанта DPO. DPO видає їх під час відкриття облікового запису; отримайте їх у свого менеджера облікового запису DPO або на dpogroup.com. DPO також може надати тестовий обліковий запис із власним токеном і service type. Окремого тестового сервера немає: DPO використовує ту саму адресу API для тестових і робочих облікових записів, а обліковий запис вибирається за токеном.

Валюта: валюта магазину має підтримуватися вашим обліковим записом DPO, наприклад USD, EUR, ZAR, KES, UGX, TZS, RWF, GHS, NGN, ZMW, XOF або AED. DPO приймає не більше 2 десяткових знаків, тож суми замовлення з 3 десятковими знаками (наприклад, KWD 12.345) оплатити неможливо.

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

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

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

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

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

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

5. Введіть тестовий та/або робочий Company Token і Service Type (див. Налаштування).

6. Надішліть URL push-сповіщення, показаний на сторінці налаштувань, у підтримку DPO і попросіть налаштувати його для вашого облікового запису.

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

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

Усі налаштування на одній сторінці: WooCommerce > Settings > Payments > DPO Pay. Якщо спосіб оплати увімкнено, але Company Token або Service Type вибраного режиму порожній, сторінка попереджає, що спосіб оплати приховано під час оформлення замовлення, а збереження показує ту саму помилку. Поки тестовий режим увімкнено, сторінка показує Test mode is on: payments are created with the test account credentials.

Загальні

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

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

Description: текст, що показується під способом оплати під час оформлення замовлення. За умовчанням: Pay securely by card or mobile money on the DPO Pay payment page.

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

DPO видає Company Token і Service Type ID для вашого облікового запису мерчанта, а також окремі — для тестового облікового запису. Отримайте їх у свого менеджера облікового запису DPO або на dpogroup.com.

Test mode: Use the test account credentials below. Коли увімкнено, нові платежі створюються з тестовим Company Token і Service Type. За умовчанням: увімкнено. Зніміть позначку, щоб приймати реальні платежі з робочими обліковими даними. Перевірки статусу наявних замовлень завжди використовують обліковий запис, яким було створено платіж.

Test Company Token: Company Token вашого тестового облікового запису DPO.

Test Service Type: числовий Service Type ID вашого тестового облікового запису DPO.

Live Company Token: Company Token вашого робочого облікового запису мерчанта DPO.

Live Service Type: числовий Service Type ID вашого робочого облікового запису мерчанта DPO.

Service Type має бути числом. Будь-яке інше значення не зберігається: сторінка показує помилку та зберігає попереднє значення. Якщо ви оновлюєтеся з версії 1.0, облікові дані цієї версії також копіюються в тестові поля.

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

Push-сповіщення негайно повідомляє вашому магазину, що платіж здійснено, навіть якщо покупець закрив браузер після оплати. У цьому розділі показано URL push-сповіщення. Він має вигляд https://your-site/wc-api/dpo_pay_notify/. Він не налаштовується в панелі: попросіть підтримку DPO налаштувати цей URL для вашого облікового запису.

Push-сповіщення DPO не мають підпису, тому їхньому вмісту ніколи не довіряють. Плагін використовує їх лише для пошуку замовлення, а потім перевіряє платіж безпосередньо в DPO. Без push-URL замовлення все одно підтверджуються, коли покупець повертається в магазин, а також автоматичними повторними перевірками через 15 хвилин після переспрямування та після закінчення часу на оплату.

Замовлення

Successful payment status: статус замовлення після перевіреної успішної оплати. Статус встановлюється негайно, без другої зміни статусу.

Розширені

Logging: Enable logging записує виклики API та сповіщення в WooCommerce > Status > Logs, джерело wcp_dpo_pay. Помилки завжди записуються. Токени маскуються, дані покупця не записуються. За умовчанням: вимкнено.

Delete data: Delete all plugin data when the plugin is deleted. Видаляє налаштування, дані DPO, збережені в замовленнях, і журнали під час видалення. Деактивація ніколи не видаляє дані. За умовчанням: вимкнено.

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

Покупець обирає спосіб оплати (за умовчанням DPO Pay) і оформляє замовлення. Плагін створює транзакцію DPO на суму замовлення у валюті замовлення, з номером замовлення та назвою вашого сайту як описом, і перенаправляє покупця на сторінку оплати DPO. Ім'я, e-mail, телефон та адресу покупця передають для попереднього заповнення сторінки. Там покупець платить будь-яким способом, увімкненим у вашому обліковому записі DPO. Посилання на оплату діє протягом 5 годин.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після підтвердження DPO: плагін запитує у DPO результат транзакції, коли покупець повертається, коли надходить push-сповіщення та під час автоматичних повторних перевірок. Коли оплату підтверджено, покупець переходить на сторінку отримання замовлення.

Якщо оплату не підтверджено, покупець повертається до оформлення замовлення або на сторінку Pay for order з одним із цих повідомлень:

Якщо покупець натискає на сторінці DPO кнопку повернення до магазину, замовлення скасовується стандартним для WooCommerce способом, а його посилання на оплату DPO скасовується в DPO.

Коли покупець знову платить за те саме замовлення, спочатку перевіряють попереднє посилання на оплату DPO. Якщо його оплачено, замовлення завершується без повторного списання. Якщо воно ще обробляється, покупець бачить Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. Інакше старе посилання скасовується в DPO і створюється нове.

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

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

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

Замовлення

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

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

Processing, Completed або On hold: платіж перевірено. Статус відповідає Successful payment status. Примітка до замовлення показує суму, валюту, код підтвердження та початок токена транзакції DPO. Ідентифікатор транзакції — це токен транзакції DPO.

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

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

Cancelled: покупець повернувся до магазину зі сторінки DPO, або замовлення скасовано вами чи таймаутом WooCommerce для неоплачених замовлень. Неоплачене посилання на оплату DPO скасовується в DPO.

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

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

Повернення коштів з WooCommerce недоступне в цій версії. Поверніть платіж у порталі мерчанта DPO, а потім позначте замовлення як повернене у WooCommerce.

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

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

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

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

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

Усунення проблем

DPO Pay не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, а Company Token і Service Type вибраного режиму заповнені: тестові поля в тестовому режимі, робочі — в іншому разі. Сторінка налаштувань показує попередження, коли їх не вказано.

Оплата пройшла, але замовлення залишається Pending payment: ймовірно, URL push-сповіщення не налаштовано для вашого облікового запису DPO, і покупець не повернувся в магазин. Попросіть підтримку DPO налаштувати URL, показаний у налаштуваннях. Замовлення також підтверджується автоматичною повторною перевіркою через 15 хвилин після переспрямування. Увімкніть Logging і подивіться WooCommerce > Status > Logs, джерело wcp_dpo_pay.

Push-сповіщення відповідає Unknown transaction: токен транзакції не належить до замовлення DPO Pay цього магазину, наприклад сповіщення надійшло від іншого магазину на тому самому обліковому записі DPO.

Push-сповіщення відповідає Verification failed: не вдалося зв'язатися з DPO для перевірки платежу. DPO повторює сповіщення, і автоматична повторна перевірка також підтверджує замовлення.

Service Type не зберігається: він має бути числовим Service Type ID від DPO.

Покупець бачить DPO Pay is temporarily unavailable: DPO відмовив у створенні транзакції, наприклад через неправильний Company Token або Service Type, або токен іншого режиму. Код результату DPO вказано в WooCommerce > Status > Logs, джерело wcp_dpo_pay.

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

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

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

Видалення

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

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