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

Вимоги

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

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

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

HTTPS: ваш сайт має бути доступний з інтернету через HTTPS, щоб Comgate міг надсилати фонове повідомлення.

Валюта: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK або SEK. Для інших валют і для сум нижче мінімуму Comgate спосіб оплати приховується. Платежі в HUF округлюються до цілих форинтів, як того вимагає Comgate.

Обліковий запис Comgate: потрібні Merchant ID і Secret (пароль для фонової комунікації) вашого підключення магазину в клієнтському порталі Comgate, а також адреса повідомлень, встановлена там (див. розділ «Налаштування»). Comgate використовує ті самі Merchant ID і Secret для тестових і робочих платежів.

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

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

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

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

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

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

5. Введіть Merchant ID і Secret з клієнтського порталу Comgate та встановіть там адресу повідомлень (див. розділ «Налаштування»).

6. Увімкніть Enable / Disable. Залиште Test Mode увімкненим для пробного платежу, а потім вимкніть його.

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

Усі параметри розміщено на одній сторінці: WooCommerce > Settings > Payments > Comgate. Над полями сторінка попереджає, якщо Comgate увімкнено, але не заповнено Merchant ID або Secret (тоді спосіб оплати приховано на оформленні замовлення, доки обидва поля не буде заповнено), а також якщо валюта магазину не підтримується. Поки ввімкнено тестовий режим, вона показує Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live.

Загальні

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

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

Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay securely via Comgate — cards, bank transfers, wallets and more. У тестовому режимі до нього додається TEST MODE: no real money is charged. або цей рядок показується окремо, якщо опис порожній.

Підключення до Comgate

Візьміть ідентифікатор магазину (Merchant ID) і пароль (Secret) у клієнтському порталі Comgate, Integration > shop connection settings. Там же встановіть URL for passing the payment result (фонове повідомлення) на адресу, яку показано в цьому розділі. Вона має вигляд https://your-site/wc-api/comgate_payment_callback/. Comgate викликає її після кожного платежу; потім плагін перевіряє платіж через API статусу Comgate, перш ніж змінити замовлення. Адреси повернення для покупця надсилаються з кожним платежем. Якщо портал також просить адреси повернення (оплачено, скасовано, очікує), використовуйте другу адресу, яку показано в цьому розділі; вона має вигляд https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId}.

Merchant ID: ідентифікатор інтернет-магазину Comgate (merchant).

Secret: пароль для фонової комунікації (secret) цього підключення магазину.

Test Mode: Create test payments (no money is charged). Comgate використовує ті самі Merchant ID і Secret для тестових і робочих платежів; тестові платежі позначаються test=true. Повернення завжди надсилаються в режимі початкового платежу. За замовчуванням: увімкнено.

Сторінка оплати

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

Language: мова платіжної сторінки Comgate. Automatic (site language, English as fallback) (за замовчуванням) або одна з 26 мов.

Замовлення

Order Status After Payment: статус, який встановлюється після підтвердження платежу Comgate. Статус встановлюється одразу, без другої зміни статусу.

Додатково

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

Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted. Замовлення та їхні дані транзакцій Comgate завжди зберігаються. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Comgate) і оформлює замовлення. Плагін створює платіж у Comgate на суму замовлення у валюті замовлення і перенаправляє покупця на платіжну сторінку Comgate. E-mail і ім'я платника передаються в Comgate, а платіж позначається номером замовлення. Потрібна дійсна адреса e-mail для рахунку. На сторінці Comgate покупець платить одним із дозволених вами способів.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після того, як Comgate його підтвердить: плагін зчитує платіж через API статусу Comgate — і коли надходить фонове повідомлення, і коли покупець повертається. Якщо платіж ще не підтверджено, наприклад банківський переказ у дорозі, сторінка підтвердження замовлення показує Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. Якщо замовлення переведено на утримання, сторінка показує Your payment is being reviewed. We will contact you if anything else is needed.

Якщо платіж скасовано або він завершився за часом, покупець повертається на оформлення замовлення (або в кошик) з повідомленням The Comgate payment was cancelled or has expired. You can try again or choose another payment method. Покупець може знову оплатити неоплачене замовлення, наприклад зі сторінки Pay for order. Попередня спроба перевіряється першою, тож платіж, який уже пройшов, не списується двічі, а якщо вона ще відкрита, скасовується в Comgate. Пізній платіж за старішою спробою все одно оплачує неоплачене замовлення.

Якщо Comgate не може розпочати платіж, покупець бачить коротке повідомлення, наприклад The Comgate payment could not be started. Please try again or choose another payment method., що Comgate не приймає цю суму чи валюту, або що обраний спосіб оплати Comgate недоступний. Технічна причина записується в журнал.

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

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

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

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

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

Processing or Completed: Comgate повідомив про платіж як PAID з тією самою сумою та валютою. Статус відповідає налаштуванню Order Status After Payment. ID транзакції замовлення — це ID транзакції Comgate; усі спроби зберігаються разом із замовленням. Тестові платежі отримують примітку Comgate test payment — no money was charged.

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

Cancelled: поточний платіж Comgate скасовано або він завершився за часом. Якщо Comgate підтверджує платіж після того, як WooCommerce скасував неоплачене замовлення (наприклад, повільний банківський переказ), замовлення відкривається знову як оплачене з приміткою перевірити запаси перед відвантаженням.

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

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

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

Повернення, зроблені в порталі Comgate, не передаються назад у магазин. За потреби створіть ручне повернення в WooCommerce без Refund via цього способу оплати.

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

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

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

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

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

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

Comgate не з'являється під час оформлення: перевірте, що ліцензія активна, Enable / Disable увімкнено, заповнено Merchant ID і Secret, валюта замовлення підтримується, а сума замовлення не менша за мінімум Comgate (наприклад, 1 CZK, 0,10 EUR або 100 HUF). Сторінка налаштувань показує попередження, коли облікових даних бракує або валюта не підтримується.

Платіж пройшов, але замовлення залишається Pending payment: Comgate не доставив фонове повідомлення. Перевірте URL for passing the payment result в порталі Comgate, що ваш сайт доступний з інтернету через HTTPS (без режиму обслуговування чи захисту паролем), і журнал (увімкніть Debug Log). Comgate повторює недоставлені повідомлення; плагін відповідає помилкою щоразу, коли не обробив повідомлення, тож воно буде надіслано повторно. Замовлення також підтверджується, коли покупець повертається до магазину.

Notification answers Invalid merchant or secret: Merchant ID або Secret у налаштуваннях не збігаються з підключенням магазину в порталі Comgate.

Notification answers Gateway not configured: Merchant ID або Secret у налаштуваннях порожні. Comgate повторить спробу, щойно їх буде заповнено.

Notification answers Order not found, Unknown transaction or Reference mismatch: повідомлення належить платежу, який цей магазин не створював для цього замовлення. Замовлення не змінюється.

Notification answers Status verification failed, Status verification rejected or Busy, retry later: API статусу Comgate не відповів, відхилив запит або замовлення в цей момент обробляв інший запит. Comgate повторює повідомлення.

Покупець бачить We could not verify the Comgate payment: посилання повернення не відповідало замовленню. Якщо кошти списано, повідомлення все одно підтвердить замовлення. Перевірте платіж у порталі Comgate, перш ніж покупець заплатить знову.

Покупець бачить The order total is below the minimum amount accepted by Comgate або A valid billing e-mail address is required for Comgate payments: замовлення в такому вигляді не можна оплатити через Comgate.

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

Refund fails: прочитайте повідомлення. Comgate rejected the refund: the amount exceeds the refundable amount. означає, що сума більша за залишок до повернення; платіж у статусі, відмінному від PAID, повернути не можна. Comgate could not be reached. The refund was not made — please try again later. означає проблему з'єднання.

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

Видалення

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

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