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

Вимоги

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

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

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

Доступ до сайту з інтернету: MakeCommerce надсилає сповіщення про платежі до вашого магазину, тому сайт має бути доступним з інтернету (рекомендовано HTTPS). Брандмауер, режим обслуговування або базова автентифікація можуть блокувати їх.

Обліковий запис MakeCommerce: вам потрібні Shop ID та Secret key з MakeCommerce Merchant Portal (Settings > API). Тестове та робоче середовища мають окремі облікові записи та ключі. Доступні способи оплати та валюти визначаються вашим договором з MakeCommerce (банківські посилання діють у EUR). Валюти з трьома десятковими знаками, як-от KWD чи BHD, не підтримуються.

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

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

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

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

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

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

5. Введіть Shop ID та Secret key для тестового середовища, а для реальних платежів — робочі ключі (дивіться Налаштування). У Merchant Portal нічого налаштовувати не потрібно.

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

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

Усі налаштування знаходяться на одній сторінці: WooCommerce > Settings > Payments > MakeCommerce. Над полями сторінка відображає Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. поки увімкнено тестовий режим. Вона попереджає вас, якщо метод увімкнено, але Shop ID чи Secret key поточного середовища не заповнені, а також якщо валюта магазину не може бути списана через MakeCommerce. В обох випадках спосіб оплати приховується під час оформлення замовлення. У списку способів оплати MakeCommerce позначається як такий, що потребує налаштування, доки поточне середовище не матиме своїх ключів. Пробіли видаляються з ключів під час збереження.

General

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

Title: назва способу оплати, яку покупці бачать під час оформлення замовлення. За замовчуванням: Bank link or card (MakeCommerce).

Description: текст, що відображається під способом оплати під час оформлення замовлення. За замовчуванням: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

MakeCommerce account

Shop ID та Secret key знаходяться в MakeCommerce Merchant Portal у розділі Settings > API. Тестовий та робочий портали мають окремі облікові записи та ключі. Розділ містить посилання на обидва портали та на сторінку реєстрації MakeCommerce.

Test mode: Use the MakeCommerce test environment (no real money is charged). Нові платежі створюються у вибраному середовищі з його ключами. Кожне замовлення запам'ятовує середовище, в якому воно було оплачено: перевірки статусу та повернення коштів завжди спрямовуються туди. Під час оформлення замовлення відображається рядок TEST MODE — MakeCommerce test environment, no real money is charged. За замовчуванням: увімкнено.

Test Shop ID: Shop ID вашого тестового облікового запису у форматі xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Test Secret key: Secret key вашого тестового облікового запису.

Live Shop ID: Shop ID вашого робочого облікового запису.

Live Secret key: Secret key вашого робочого облікового запису.

Payment notifications

У Merchant Portal нічого налаштовувати не потрібно. Кожна транзакція містить власні URL-адреси повернення, скасування та сповіщення на основі адреси, показаної в цьому розділі (виглядає як https://your-site/wc-api/wc_mkc_payment/), з додаванням номера замовлення та ключа замовлення. MakeCommerce надсилає підписане повідомлення на URL сповіщення (між серверами) та через браузер покупця на URL повернення або скасування. Підпис перевіряється за допомогою Secret key того середовища, в якому була створена транзакція. Повідомлення без дійсного підпису відхиляються.

Плагін обробляє такі статуси транзакцій MakeCommerce:

Платіж також підтверджується, коли покупець повертається до магазину. Якщо покупець повернувся без підписаного повідомлення, плагін запитує статус через API MakeCommerce.

Advanced

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

Delete data: Delete the gateway settings and logs when the plugin is deleted. Замовлення та примітки до їхніх платежів зберігаються завжди. Деактивація плагіна ніколи нічого не видаляє. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Bank link or card (MakeCommerce)) і розміщує замовлення. Плагін створює транзакцію MakeCommerce на загальну суму замовлення у валюті замовлення та направляє покупця на платіжну сторінку MakeCommerce. Там покупець обирає банківське посилання або картку. Платіжний e-mail та країна передаються до MakeCommerce, і сторінка відкривається мовою магазину, якщо MakeCommerce її підтримує (естонська, англійська, латвійська, литовська, фінська, російська, німецька, польська), інакше — англійською.

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

Якщо покупець скасовує оплату на сторінці MakeCommerce або термін дії платежу закінчується, покупець повертається до оформлення замовлення (або на сторінку Pay for order) з повідомленням, наприклад The payment was cancelled. You can try again or choose another payment method. або The payment session expired. Please try again. Якщо платіж поки не вдалося підтвердити, відображається We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. Покупець може здійснити оплату повторно. Раніше створене платіжне посилання для того самого замовлення все ще працює, при цьому замовлення неможливо оплатити двічі.

Якщо MakeCommerce не може розпочати платіж, покупець бачить MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. або MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. Технічна причина додається до приміток замовлення та до журналу.

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

Банк або картка обираються на сторінці MakeCommerce, а не у вашому оформленні замовлення. Плагін не підтримує збережені картки, регулярні платежі чи WooCommerce Subscriptions, а також доставку MakeCommerce (поштомати, етикетки).

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

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

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

Processing: платіж підтверджено. Замовлення, що містять лише віртуальні завантажувані товари, набувають статусу Виконано (стандартне налаштування WooCommerce). Примітка до замовлення містить суму, транзакцію, середовище та спосіб перевірки (API MakeCommerce чи підписане сповіщення). Ідентифікатор транзакції відповідає ID транзакції MakeCommerce.

On hold: сплачена сума чи валюта відрізнялися від замовлення, сума була відсутня, статус транзакції в MakeCommerce ще не був остаточним, або надійшов платіж за скасованим замовленням. Примітка до замовлення пояснює це. Така транзакція ніколи не оплатить замовлення пізніше. Перевірте транзакцію в Merchant Portal і завершіть або поверніть замовлення вручну.

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

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

Check MakeCommerce payment status

На екрані замовлення оберіть Check MakeCommerce payment status у діях із замовленням. Плагін запитує в API MakeCommerce статус транзакцій замовлення (найновішу спочатку), застосовує його та додає примітку з результатом. Використовуйте це, коли замовлення залишається в статусі Очікується оплата, хоча покупець заплатив.

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

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via Bank link or card (MakeCommerce) (кнопка відображає ваш Title). Підтримуються повні та часткові повернення. Повернення коштів надсилається в те середовище, в якому було оплачено замовлення (тестове чи робоче), тому ключі цього середовища мають бути налаштовані. Якщо MakeCommerce не приймає повернення, WooCommerce відображає помилку, додається примітка і повернення не фіксується. Якщо MakeCommerce все ще обробляє платіж, повідомленням буде MakeCommerce is still processing this payment — try the refund again later. Успішне повернення додається до приміток до замовлення з ідентифікатором повернення MakeCommerce.

Повернення коштів, здійснені в Merchant Portal, надходять зі статусом транзакції та додаються до приміток до замовлення. Вони не реєструються автоматично як повернення WooCommerce.

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

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

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

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

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

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

MakeCommerce не з'являється під час оформлення замовлення: перевірте, чи ліцензія активна, опцію Enable/Disable увімкнено і поточне середовище має свої ключі: Test Shop ID та Test Secret key у тестовому режимі, Live Shop ID та Live Secret key у робочому режимі. Перевірте, щоб валюта магазину (або валюта замовлення на сторінці Pay for order) мала не більше двох десяткових знаків. Сторінка налаштувань відображає попередження для кожної з цих проблем.

Платіж пройшов, але замовлення залишається в статусі Очікується оплата: сповіщення не змогли дійти до сайту, наприклад через брандмауер, режим обслуговування чи базову автентифікацію. Відкрийте замовлення та виконайте дію із замовленням Check MakeCommerce payment status. Переконайтеся, що ключі середовища, в якому було здійснено платіж, встановлені: сповіщення перевіряється за допомогою Secret key цього середовища, і без нього MakeCommerce отримує помилку та повторює спроби.

Замовлення перебуває На утриманні з приміткою MakeCommerce: платіж не відповідав замовленню (сума, валюта, статус) або надійшов за скасованим замовленням. Перевірте транзакцію в Merchant Portal і завершіть або поверніть замовлення вручну.

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

Покупець бачить помилку під час розміщення замовлення: відкрийте примітки до замовлення або увімкніть Debug log і подивіться в WooCommerce > Status > Logs, джерело wcp_makecommerce_payment. Валюта, яку MakeCommerce не може списати, видає MakeCommerce cannot process payments in та код валюти.

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

Повернення коштів завершується помилкою з No MakeCommerce transaction ID found for this order: замовлення не має транзакції MakeCommerce. Здійсніть повернення коштів у Merchant Portal.

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

Видалення

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

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