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

Вимоги

WordPress: 6.0 або новіша.

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

PHP: 8.0 або новіша.

Валюта: лише євро (EUR). Спосіб оплати приховується, якщо валюта магазину або замовлення не EUR. ifthenpay приймає суми від 0,01 до 99 999,99 EUR.

Обліковий запис ifthenpay: зареєструйтеся на ifthenpay.com. Потрібен ключ способу, який ви пропонуєте: Multibanco, MB WAY або Credit Card (формат ABC-123456). Ключі показані в backoffice ifthenpay (backoffice.ifthenpay.com) або надсилаються ifthenpay, коли спосіб активовано для вашого облікового запису. ifthenpay також має активувати callback для вашого ключа (див. «Налаштування»), а ваш магазин має бути доступним з інтернету.

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

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

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

2. Натисніть Activate. Плагін створить свій антифішинговий ключ.

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

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

5. Оберіть Payment Method і введіть його ключ ifthenpay. Збережіть налаштування, щоб Callback URL відповідав обраному способу.

6. Скопіюйте Anti-phishing Key і Callback URL, показані в налаштуваннях, і попросіть ifthenpay активувати callback для вашого ключа (у backoffice або через підтримку ifthenpay).

7. Увімкніть Enable/Disable.

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

Усі налаштування розташовані на одній сторінці: WooCommerce > Settings > Payments > ifthenpay. Без ключа обраного способу він не показується на оформленні замовлення, а у списку способів оплати позначається як такий, що потребує дій. Коли ви зберігаєте увімкнений шлюз без цього ключа, сторінка показує ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout.

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

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

Description: опис способу оплати, який показується на оформленні замовлення. За замовчуванням: Pay via Multibanco, MB WAY or Credit Card. Змініть його відповідно до способу, який ви пропонуєте.

Payment Method: спосіб, який пропонується на оформленні замовлення. Потрібен лише ключ цього способу.

Ключі ifthenpay

Ключі (формат ABC-123456) показані в backoffice ifthenpay або надсилаються ifthenpay, коли спосіб оплати активовано для вашого облікового запису.

Multibanco Key: ваш ключ ifthenpay Multibanco (MB) для динамічних референсів.

MB WAY Key: ваш ключ ifthenpay MB WAY.

Credit Card Key: ваш ключ ifthenpay Credit Card. Він також перевіряє підпис повернення покупця зі сторінки картки.

Callback (сповіщення про оплату)

Callback повідомляє вашому магазину, що оплату здійснено. Попросіть ifthenpay активувати callback для кожного ключа, який ви використовуєте, з антифішинговим ключем і URL callback, наведеними нижче. Замовлення Multibanco та MB WAY підтверджуються лише через callback; платежі карткою також підтверджуються підписаним поверненням зі сторінки картки.

Anti-phishing Key: створюється плагіном, показується для копіювання. ifthenpay надсилає його назад у кожному callback; callback без нього відхиляються.

Callback URL: URL callback для обраного способу оплати з плейсхолдерами ifthenpay, показується для копіювання. Він починається з https://your-site/wc-api/ifthenpay_payment_callback/ і продовжується параметрами способу. Скопіюйте весь URL точно так, як його показують налаштування.

Антифішинговий ключ у кожному callback порівнюється з вашим. Відсутній або невірний ключ отримує відповідь 403, і замовлення не змінюється. Callback також має відповідати замовленню цього шлюзу: для Multibanco — за entity та референсом, для MB WAY — за замовленням і одним із його запитів MB WAY, для Credit Card — за замовленням і його запитом картки. Без робочого callback замовлення Multibanco та MB WAY ніколи не підтверджуються, а платежі карткою підтверджуються лише підписаним поверненням.

Додатково

Test Mode: Enable test/sandbox mode. Кредитна картка та Multibanco використовують sandbox-адреси ifthenpay; реальні гроші не списуються, і ви використовуєте тестові ключі, які надає ifthenpay. MB WAY не має sandbox: тестуйте його тестовим ключем ifthenpay. На оформленні замовлення з'являється значок TEST MODE. За замовчуванням: вимкнено.

Order Status After Payment: статус замовлення, який встановлюється після підтвердженої оплати, з однією зміною статусу та одним листом покупцеві. Замовлення, що містять лише віртуальні товари для завантаження, завжди завершує WooCommerce.

Debug Log: Enable logging. Запити API та callback записуються в WooCommerce > Status > Logs, джерело wcp_ifthenpay_gateway. Помилки завжди журналюються. Ключі, антифішинговий ключ і номери телефонів ніколи не журналюються. За замовчуванням: вимкнено.

Delete Data on Uninstall: Remove the plugin settings, the anti-phishing key and the logs when the plugin is deleted (orders are kept). За замовчуванням: вимкнено.

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

Multibanco. На оформленні замовлення покупець бачить You will receive a Multibanco reference to complete the payment. Коли замовлення оформлено, плагін створює динамічний референс Multibanco на суму замовлення. Замовлення переходить у статус «На утриманні», залишок товару зменшується, кошик очищується. На сторінці «Замовлення отримано» та в листах про замовлення, які надсилаються, поки замовлення на утриманні, показано Multibanco Payment Details: код організації (entity), референс і суму, а також Please use these details to pay at any Multibanco ATM or through your online banking. Якщо покупець знову оформить замовлення на ту саму суму, використовується той самий референс. Замовлення підтверджується, коли ifthenpay надсилає callback про оплату.

MB WAY. Покупець вводить MB WAY phone number (912 345 678, +351 912 345 678 або 351#912345678 для інших країн); телефон для рахунку заповнюється. Плагін надсилає запит на оплату на телефон, замовлення переходить у статус «На утриманні», залишок товару зменшується, кошик очищується. На сторінці «Замовлення отримано» написано A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. Усі запити замовлення зберігаються, тож раніше підтверджений у застосунку запит і далі приймається. Замовлення підтверджується через callback.

Кредитна картка. Покупець бачить You will be redirected to a secure page to enter your card details. і переходить на сторінку карток ifthenpay. Замовлення залишається у статусі «Очікує оплати», доки не буде оплачене, і залишок товару до того не зменшується. Після успішної оплати покупець повертається до вашого магазину. Повернення приймається лише з дійсним підписом ifthenpay, ключем замовлення, секретом цієї спроби та запитом картки замовлення; тоді замовлення позначається оплаченим. Якщо повернення неможливо перевірити, замовлення не змінюється, а на сторінці «Замовлення отримано» показано Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. Невдалий платіж карткою переводить замовлення у статус «Невдалий», а скасований залишає його у статусі «Очікує оплати». В обох випадках покупець потрапляє на сторінку Pay for order з повідомленням The card payment was not completed. You can try again or choose another payment method. або The card payment was cancelled. You can try again or choose another payment method.

Замовлення позначається оплаченим лише після підтвердження оплати ifthenpay, а сума перевіряється до копійки щодо суми замовлення. Якщо оплату не вдається почати, покупець бачить коротке повідомлення, наприклад The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. або The payment service is temporarily unavailable. Please try again in a few minutes.

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

Плагін пропонує один спосіб ifthenpay за раз. Він не підтримує Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX або Pay-by-Link, підписки та збережені картки, автоматичне закінчення строку дії або скасування неоплачених референсів Multibanco та опитування статусу платежу.

Замовлення

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

On hold (waiting for payment): видано референс Multibanco або надіслано запит MB WAY. Неоплачені референси не скасовуються автоматично; за потреби скасуйте такі замовлення самостійно.

Pending payment: розпочато платіж карткою, який ще не підтверджено, або його скасовано.

Processing or Completed: оплату підтверджено. Статус відповідає Order Status After Payment. У примітці до замовлення показано код організації (entity) та референс Multibanco, транзакцію MB WAY або ID запиту картки.

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

Failed: покупець повернувся зі сторінки картки з помилкою.

Повторне сповіщення про оплату для вже оплаченого замовлення лише додає примітку, щоб ви перевірили дублікат платежу в backoffice ifthenpay. Замовлення з поверненням коштів і замовлення, скасовані після оплати, ніколи не відкриваються знову.

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

Повернення коштів із WooCommerce не підтримуються. Поверніть платіж у backoffice ifthenpay і вручну зафіксуйте його у WooCommerce. Callback про повернення (DEVOLVIDO) лише додає примітку до замовлення. Інші статуси, які повідомляє ifthenpay, теж лише додають примітку.

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

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

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

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

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

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

ifthenpay не з'являється на оформленні замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, заповнено ключ обраного Payment Method, валюта EUR і сума в межах від 0,01 до 99 999,99 EUR. На сторінці Pay for order враховується валюта замовлення.

Покупець сплатив, але замовлення залишається On hold або Pending payment: callback не доходить до вашого магазину. Перевірте, що ifthenpay активував URL callback і антифішинговий ключ для ключа, який ви використовуєте, і що URL відповідає обраному способу. Сайт має бути доступним з інтернету, а не на localhost і не за логіном. Шукайте рядки Callback rejected у WooCommerce > Status > Logs, джерело wcp_ifthenpay_gateway.

Callback відповідає 403 Forbidden: антифішингового ключа в callback немає або він відрізняється від ключа в налаштуваннях. Надішліть ifthenpay ще раз ключ, показаний у налаштуваннях.

Callback відповідає 503 Not configured: антифішинговий ключ ще не створено. Відкрийте сторінку налаштувань один раз; ifthenpay повторить callback.

Callback відповідає Order not found: референс або запит не належить до замовлення цього шлюзу, наприклад через те, що спосіб оплати змінили після оформлення замовлення.

Чому оплачене замовлення перевели в On hold? Отримана сума відрізнялася від суми замовлення, або оплата надійшла після скасування замовлення. Прочитайте примітку до замовлення, перевірте платіж у backoffice ifthenpay і вручну завершіть або поверніть замовлення.

Не вдалося надіслати запит MB WAY: номер телефону не прив'язано до MB WAY або його записано в неправильному форматі. Використовуйте 912 345 678 або 351#912345678 для номерів інших країн.

Тестовий режим і MB WAY: у ifthenpay немає sandbox для MB WAY; використовуйте тестовий ключ, наданий ifthenpay.

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

Видалення

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

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