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

Вимоги

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

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

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

Валюта: валюта магазину або замовлення має бути однією з тих, що приймає MultiSafepay, наприклад EUR, USD, GBP, PLN, CHF, SEK, DKK або NOK. Для інших валют спосіб оплати приховується під час оформлення замовлення.

Обліковий запис MultiSafepay: потрібен API-ключ вашого сайту в MultiSafepay Control. Тестовий і робочий облікові записи мають різні ключі. Більше нічого налаштовувати в MultiSafepay не потрібно: адреса сповіщень надсилається з кожним платежем.

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

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

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

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

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

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

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

5. Вставте тестовий та/або робочий API-ключ із MultiSafepay Control (див. Налаштування).

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

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

Усі налаштування розташовані на одній сторінці: WooCommerce > Settings > Payments > MultiSafepay. Заголовок сторінки показує позначку Test mode, поки ввімкнено тестовий режим. Над полями сторінка попереджає, якщо для поточного режиму немає API-ключа (тоді спосіб оплати не показується під час оформлення замовлення) або MultiSafepay не приймає валюту магазину. У списку способів оплати MultiSafepay позначено як такий, що потребує налаштування, доки для поточного режиму не буде API-ключа.

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

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

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

Description: текст під способом оплати під час оформлення. За замовчуванням: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

API-ключі

API-ключ можна знайти в MultiSafepay Control > Manage settings > Website settings. Тестовий обліковий запис (testmerchant.multisafepay.com) і робочий (merchant.multisafepay.com) мають різні ключі. Тестовий режим використовує лише тестовий ключ, а робочий режим — лише робочий.

Test mode: Use the MultiSafepay test environment (no real payments). Перемикає і адресу API, і API-ключ. Вже здійснені платежі для перевірок статусу та повернень продовжують використовувати середовище, в якому були проведені. За замовчуванням: увімкнено.

Test API key: API-ключ вашого тестового облікового запису MultiSafepay.

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

Сповіщення

Нічого налаштовувати не потрібно. Цей розділ показує адресу сповіщень, яка надсилається до MultiSafepay з кожним платежем. Вона має приблизно такий вигляд: https://your-site/?wc-api=mspg_webhook. MultiSafepay має мати змогу зв'язатися з вашим сайтом. Сповіщення лише повідомляє плагіну, який платіж змінився: статус, сума й валюта завжди зчитуються через API MultiSafepay з вашим API-ключем, перш ніж замовлення буде змінено. Сповіщення про платежі, які не належать до замовлень вашого магазину, ігноруються.

Замовлення

Order status after payment: статус оплаченого замовлення. Статус встановлюється одразу, однією зміною статусу та одним листом покупцю.

Додатково

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

Delete data on uninstall: Remove settings, logs and MultiSafepay order data when the plugin is deleted. Деактивація плагіна нічого не видаляє. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням MultiSafepay) і оформлює замовлення. Плагін створює платіж MultiSafepay на суму замовлення у валюті замовлення та надсилає покупця на сторінку оплати MultiSafepay. Там покупець обирає будь-який спосіб оплати, увімкнений у вашому обліковому записі MultiSafepay, і сплачує. Платіжні дані покупця та мова магазину передаються до MultiSafepay, а платіж відображається як Order #, номер замовлення та назва вашого сайту. У тестовому режимі під час оформлення відображається Test mode: no real payment will be made.

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

Якщо покупець скасовує оплату на сторінці MultiSafepay під час оформлення, замовлення скасовується стандартним для WooCommerce способом, запаси звільняються, а товари залишаються в кошику. Якщо покупець платив зі сторінки Pay for order, він повертається на неї, і там пояснюється, що сталося: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. або The payment session has expired. Please try again.

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

Якщо MultiSafepay не може розпочати платіж, покупець бачить коротке повідомлення, наприклад Could not connect to MultiSafepay. Please try again in a moment. або MultiSafepay cannot accept this order amount or currency. Please choose another payment method., і може обрати інший спосіб оплати. Помилка MultiSafepay додається до приміток замовлення.

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

Плагін пропонує один спосіб оплати, який веде на сторінку MultiSafepay. У WooCommerce немає окремих способів оплати для кожного методу MultiSafepay, немає вбудованих полів картки, кнопок експрес-оплати Apple Pay чи Google Pay, підписок, регулярних платежів або збережених карток, а також неможливо захопити чи анулювати кошти з WooCommerce. Дані кошика не передаються, тож MultiSafepay не пропонує для таких замовлень способи оплати з відстроченням, яким вони потрібні (наприклад, Klarna, in3 або Riverty).

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

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

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

Processing або Completed: MultiSafepay підтвердив платіж (завершено або відправлено). Статус відповідає Order status after payment. У примітці до замовлення вказано ID платежу MultiSafepay, спосіб оплати та середовище. ID транзакції — це ID замовлення MultiSafepay для платежу.

On hold before payment: платіж не розрахований (його перевіряє MultiSafepay) або зарезервований (авторизований). Щоб отримати кошти, захопіть зарезервований платіж у MultiSafepay Control. Замовлення завершується автоматично, коли MultiSafepay повідомляє, що його сплачено.

On hold after payment: MultiSafepay підтвердив суму або валюту, що відрізняються від суми замовлення; тестовий платіж було завершено, поки магазин працює в робочому режимі (реальні кошти не отримано); або платіж завершено після скасування замовлення. Примітка до замовлення пояснює це. Перевірте транзакцію в MultiSafepay Control і вручну обробіть замовлення або поверніть кошти.

On hold after a chargeback: MultiSafepay повідомив про чарджбек за оплаченим замовленням: кошти було стягнуто з вашого рахунку.

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

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

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

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

Повернення, виконані в MultiSafepay Control, додаються до приміток замовлення, коли MultiSafepay їх повідомляє. Вони не реєструються автоматично як повернення WooCommerce. За потреби створіть ручне повернення в WooCommerce без використання Refund via MultiSafepay.

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

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

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

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

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

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

MultiSafepay не з'являється під час оформлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, для поточного режиму є API-ключ (Test API key у тестовому режимі, Live API key у робочому режимі), і валюта магазину або замовлення приймається MultiSafepay. На сторінці налаштувань з'являється попередження, якщо ключ відсутній або валюта не приймається.

Оплату виконано, але замовлення залишається в статусі Pending payment: сповіщення не дійшло до вашого магазину. Перевірте, що сайт доступний з інтернету та що задано API-ключ середовища платежу, оскільки плагін зчитує статус через API MultiSafepay. Якщо API недоступний, сповіщення відповідає ERROR, і MultiSafepay повторює його. Замовлення також оновлюється, коли покупець повертається на сторінку «Замовлення отримано» і коли намагається знову оплатити те саме замовлення.

Покупець бачить помилку під час оформлення замовлення: відкрийте примітки до замовлення або увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело wcp_multisafepay_gateway. This payment method is temporarily unavailable. Please choose another payment method. зазвичай означає неправильний або відсутній API-ключ. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. означає, що MultiSafepay відхилив суму або валюту.

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

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

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

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

Видалення

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

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