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

Вимоги

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

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

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

Валюта: валюта магазину або замовлення має бути EUR або PLN. Для будь-якої іншої валюти спосіб оплати приховується на оформленні замовлення.

Обліковий запис Montonio: вам потрібні ключ доступу та секретний ключ вашого магазину з Montonio Partner System. Ключі sandbox і live різні, тож потрібна пара для кожного середовища, яке ви використовуєте. Більше нічого в Montonio налаштовувати не потрібно: адреса сповіщень надсилається з кожним платежем.

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

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

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

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

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

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

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

5. У Montonio Partner System відкрийте Stores > your store > API keys і скопіюйте ключ доступу та секретний ключ sandbox. Вставте їх у налаштування та залиште ввімкненим Sandbox mode.

6. Увімкніть Enable/Disable і протестуйте платіж у sandbox. Потім введіть ключі live та вимкніть Sandbox mode.

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

Усі налаштування розміщено на одній сторінці: WooCommerce > Settings > Payments > Montonio. Над полями сторінка попереджає, коли відсутні ключі поточного середовища (тоді спосіб оплати приховується на оформленні замовлення), і коли валюта магазину не EUR та не PLN, а поки sandbox увімкнено, показує Sandbox mode is on: payments are simulated and no real money is charged. У списку способів оплати Montonio позначається як такий, що потребує налаштування, доки не заповнено обидва ключі поточного середовища.

Загальні

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

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

Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

Ключі API

Ключі знаходяться в Montonio Partner System: Stores > your store > API keys. Ключі sandbox і live різні. Sandbox використовує лише ключі sandbox, режим live — лише ключі live. Цей розділ налаштувань також показує адресу сповіщень. Вона має такий вигляд: https://your-site/wc-api/wc_mnt_payment/. Вводити її нікуди не потрібно: плагін надсилає її до Montonio з кожним платежем.

Sandbox mode: Use the Montonio sandbox (test payments, no real money). Перемикає і адресу API Montonio, і пару ключів. За замовчуванням: увімкнено. Вимикайте лише після введення ключів live.

Sandbox access key: ключ доступу (UUID) вашого магазину в sandbox Montonio.

Sandbox secret key: секретний ключ вашого магазину в sandbox Montonio.

Live access key: ключ доступу (UUID) вашого магазину в робочому середовищі Montonio.

Live secret key: секретний ключ вашого магазину в робочому середовищі Montonio.

Додатково

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

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

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

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

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

Покупець обирає спосіб оплати (за замовчуванням Bank payment (Montonio)) і оформлює замовлення. Плагін створює платіж Montonio на суму замовлення у валюті замовлення та надсилає покупця на сторінку оплати Montonio. Там покупець обирає банк і сплачує. Банки країни платника покупця показуються першими (для замовлень у PLN — Польща). Платіж відображається як Order і номер замовлення. Сторінка Montonio відкривається мовою магазину, якщо це німецька, англійська, естонська, фінська, литовська, латвійська, польська або російська; в іншому разі — англійською. У режимі sandbox на оформленні замовлення під описом відображається SANDBOX MODE — test payment, no real money is charged.

Замовлення позначається оплаченим лише після підтвердження Montonio зі статусом PAID та точними сумою й валютою замовлення. Після оплати покупець повертається на сторінку підтвердження замовлення вашого магазину. Доки Montonio не підтвердив платіж, на цій сторінці показано Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. Якщо платіж скасовано або відхилено, покупець повертається на сторінку Pay for order і бачить одне з повідомлень: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. або Montonio could not complete the payment. Please try again or choose another payment method.

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

Якщо Montonio не може розпочати платіж, покупець бачить коротке повідомлення, наприклад Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method., і може обрати інший спосіб оплати. Помилка Montonio додається до приміток замовлення та журналу.

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

Плагін приймає лише банківські платежі (ініціювання платежу). Він не підтримує оплату картками, BLIK, Apple Pay чи Google Pay, Pay Later або фінансування, доставку Montonio, підписки, збережені способи оплати та вибір банку на вашому сайті.

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

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

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

Обробляється або Виконано: Montonio підтвердив платіж (PAID). Замовлення отримує стандартний статус WooCommerce для оплачених замовлень. У примітці до замовлення показано банк, UUID платежу Montonio, суму та середовище. ID транзакції — це UUID платежу Montonio.

На утриманні: банк ще не підтвердив платіж (AUTHORIZED); замовлення стане оплаченим, коли Montonio повідомить PAID. Замовлення також переводиться на утримання, якщо Montonio повідомив суму або валюту, відмінні від замовлення, якщо платіж у sandbox надійшов, поки магазин працює в режимі live, або якщо платіж надійшов після скасування замовлення. Примітка до замовлення пояснює причину. Перевірте платіж у Montonio Partner System і виконайте замовлення або поверніть кошти.

Невдало: покупець не завершив платіж або банк його відхилив. Лише останній платіж неоплаченого замовлення може призвести до невдалого статусу. Покупець може спробувати знову зі сторінки Pay for order.

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

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

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via Bank payment (Montonio) (на кнопці використовується назва способу оплати). Повні та часткові повернення підтримуються для замовлень, оплачених через Montonio. Повернення надсилається до середовища, в якому було здійснено платіж (sandbox або live), тож ключі цього середовища мають бути заповнені. Якщо Montonio не приймає повернення, WooCommerce показує помилку, і повернення не фіксується. Надіслане повернення додається до приміток замовлення з його статусом і ID повернення Montonio.

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

Повернення, зроблені в Montonio Partner System, додаються до приміток замовлення, коли Montonio їх повідомляє. Вони не фіксуються автоматично як повернення WooCommerce. За потреби створіть ручне повернення в WooCommerce.

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

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

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

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

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

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

Montonio не з'являється на оформленні замовлення: переконайтеся, що ліцензія активна, Enable/Disable увімкнено, заповнені обидва ключі поточного середовища (Sandbox access key і Sandbox secret key у режимі sandbox, Live access key і Live secret key у режимі live), а валюта магазину або замовлення — EUR чи PLN. Сторінка налаштувань показує попередження, коли ключів бракує або валюта не підтримується.

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

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

Сповіщення відповідає Payment does not belong to this order або Wrong environment: платіж не було створено цим магазином для цього замовлення, або його створено в іншому середовищі (sandbox або live). Це трапляється, коли два магазини використовують один обліковий запис Montonio та однакові номери замовлень.

Сповіщення відповідає Gateway not configured: ключі Montonio не задано. Введіть ключі; Montonio повторить сповіщення.

Покупець бачить помилку під час оформлення замовлення: відкрийте примітки до замовлення або увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело wcp_montonio_payment. This payment method is temporarily unavailable. Please choose another payment method. зазвичай означає неправильні або відсутні ключі. Montonio could not start the payment. Please check your order details or choose another payment method. означає, що Montonio відхилив дані платежу; причину наведено в примітці.

Замовлення на утриманні після оплати: прочитайте примітку до замовлення. Банк ще не підтвердив платіж, оплачені сума чи валюта відрізняються від замовлення, платіж у sandbox надійшов у режимі live, або платіж надійшов після скасування замовлення. Перевірте платіж у Montonio Partner System.

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

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

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

Видалення

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

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