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

Вимоги

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

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

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

Обліковий запис Windcave: вам потрібен обліковий запис мерчанта Windcave з обліковими даними REST API: ім'я користувача API та API-ключ. Windcave видає їх окремо для тестового середовища UAT (uat.windcave.com) і для робочого (sec.windcave.com). Запитайте їх у служби підтримки Windcave або у свого менеджера. Ключі PxPay з цим плагіном не працюють. Способи оплати, які ви хочете пропонувати (картки, гаманці та інші), мають бути увімкнені у вашому обліковому записі Windcave.

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

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

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

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

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

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

5. Введіть ім'я користувача та ключ REST API: облікові дані UAT для тестового режиму, робочі облікові дані для реальних платежів (див. розділ «Конфігурація»).

6. Виберіть тип транзакції та способи оплати, увімкніть Enable/Disable і збережіть. Зробіть тестовий платіж з увімкненим Test mode, а потім вимкніть Test mode, щоб приймати реальні платежі.

Конфігурація

Усі налаштування розташовані на одній сторінці: WooCommerce > Settings > Payments > Windcave. Поки тестовий режим увімкнено, сторінка показує Test mode is on: payments go to the Windcave UAT environment and no real money is taken. У списку способів оплати Windcave позначається як такий, що потребує налаштування, доки в поточному режимі немає і імені користувача API, і API-ключа. Версія плагіна показана внизу сторінки.

Загальні

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

Title: назва способу оплати, яку бачать покупці під час оформлення замовлення. За замовчуванням: Credit/Debit Card (Windcave).

Description: текст під способом оплати під час оформлення замовлення. За замовчуванням: You will be redirected to the secure Windcave payment page to complete your payment.

Windcave REST API

Введіть облікові дані REST API, видані Windcave (ім'я користувача та API-ключ, а не ключі PxPay). Робочі та UAT-облікові дані можна зберегти поруч. Тестовий режим використовує лише облікові дані UAT, робочий режим — лише робочі облікові дані.

Test mode: Use the Windcave UAT test environment (uat.windcave.com). Реальні кошти не списуються. Нові платежі використовують облікові дані UAT. Повернення і захоплення завжди надсилаються в те середовище, у якому було сплачено замовлення. За замовчуванням: вимкнено.

Production API username: ім'я користувача REST API для sec.windcave.com.

Production API key: ключ REST API для sec.windcave.com.

UAT API username: ім'я користувача REST API для uat.windcave.com (тестовий режим).

UAT API key: ключ REST API для uat.windcave.com (тестовий режим).

Оплата

Transaction type: спосіб списання платежу. За замовчуванням: Purchase.

Purchase (capture immediately): кошти списуються в момент, коли покупець сплачує.

Auth (authorise now, capture later): кошти лише резервуються. Замовлення переходить у статус «На утриманні», а ви списуєте кошти дією Capture Windcave payment у діях замовлення або знімаєте резерв, повернувши повну суму. Незахоплені авторизації спливають через кілька днів.

Payment methods: способи, які показуються на сторінці оплати Windcave: Cards, Account2Account (банківський переказ у Новій Зеландії), Apple Pay, Google Pay, PayPal, Alipay, WeChat Pay, UnionPay, Interac, humm. Їх треба увімкнути у вашому обліковому записі Windcave. Залиште поле порожнім, щоб показувати всі способи, увімкнені в обліковому записі. За замовчуванням: Cards.

Додатково

Debug log: Log API requests and payment events. Журнал розташований у WooCommerce > Status > Logs, джерело wcp_windcave_payment_gateway. Помилки та попередження завжди записуються; ця опція додає запити до API і події платежів. API-ключі, дані картки та персональні дані покупців маскуються. За замовчуванням: вимкнено.

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted. Платіжні дані, збережені в замовленнях (ідентифікатори транзакцій Windcave, потрібні для повернень), завжди зберігаються. За замовчуванням: вимкнено.

URL сповіщень

Вам не потрібно налаштовувати URL сповіщень у Windcave. Плагін передає свої адреси повернення та адресу сповіщень з кожною платіжною сесією. Windcave надсилає сповіщення (Fail-Proof Result Notification) на https://your-site/wc-api/windcave_p_notification/. Ні повернення покупця, ні сповіщення не підписуються Windcave, тому плагін ніколи не довіряє їм самостійно: він завжди отримує результат сесії через REST API Windcave, використовуючи ваші облікові дані того середовища, у якому було створено сесію.

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

Покупець вибирає спосіб оплати (за замовчуванням Credit/Debit Card (Windcave)) і оформляє замовлення. Плагін створює платіжну сесію Windcave на суму замовлення у валюті замовлення і надсилає покупця на Windcave Hosted Payment Page. Номер замовлення передається як референс мерчанта разом із мовою магазину, а також ім'ям, адресою електронної пошти, телефоном і адресами для виставлення рахунку та доставки покупця. У тестовому режимі блок Checkout показує під способом оплати повідомлення Test mode: payments go to the Windcave UAT environment, no real money is taken.

Після оплати покупець повертається на сторінку «Замовлення отримано» вашого магазину. Замовлення позначається оплаченим лише після підтвердження Windcave: плагін запитує у REST API Windcave результат сесії як тоді, коли покупець повертається, так і тоді, коли надходить сповіщення від Windcave. Блокування для кожного замовлення гарантує, що платіж буде застосовано лише один раз. Якщо результат ще невідомий, сторінка «Замовлення отримано» перевіряє його ще раз і показує We are waiting for Windcave to confirm your payment. You will receive an e-mail as soon as it is confirmed — please do not pay again.

Якщо покупець повернувся без завершеної оплати, на сторінці оформлення замовлення (або на сторінці Pay for order, якщо спроба почалася там) показується одне з таких повідомлень:

Declined: ваш платіж відхилено. Спробуйте ще раз або виберіть інший спосіб оплати.

Cancelled or expired: платіж не було завершено на сторінці Windcave. Ваше замовлення збережено: ви можете спробувати ще раз або вибрати інший спосіб оплати.

Not confirmed yet: ми ще не змогли підтвердити ваш платіж. Якщо ви його завершили, не оплачуйте повторно: лист із підтвердженням надійде, щойно Windcave його підтвердить.

Return could not be processed: ми не змогли обробити ваше повернення зі сторінки оплати. Якщо з вас списали кошти, зв'яжіться з нами, перш ніж платити знову.

Кошик не очищується і залишок товару не зменшується, доки покупець не сплатить. Покупець може повторно оплатити неоплачене замовлення, наприклад зі сторінки Pay for order. Нова спроба спершу перевіряє попередню сесію: якщо вона вже оплачена, другий платіж не створюється; якщо покупець ніколи не користувався сторінкою оплати і замовлення не змінилося, його повертають на ту саму сторінку. Якщо попередній платіж у цей момент підтверджується, покупець бачить Your previous payment for this order is being confirmed right now. Please wait a minute and check your e-mail before trying again.

Якщо Windcave не може розпочати платіж, покупець бачить коротке повідомлення: що Windcave не зміг розпочати платіж з даними цього замовлення або що платіжна служба тимчасово недоступна. Причина додається до приміток замовлення. Якщо в поточному режимі немає облікових даних, покупець бачить This payment method is not available at the moment. Please choose another payment method or contact us.

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

Плагін не має підписок і періодичних платежів, збережених карток, вбудованої форми картки на вашому сайті (покупець завжди платить на сторінці Windcave), підтримки API PxPay 2.0 і не додає надбавок. Якщо Windcave додає надбавку, замовлення зіставляється з основною транзакцією.

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

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

Pending payment: покупця перенаправлено на Windcave, і він ще не сплатив, або Windcave ще не підтвердив платіж. Якщо покупець скасує оплату або сесія завершиться, замовлення залишиться в статусі «Очікує оплати», і буде додано примітку.

Processing or Completed: платіж Purchase підтверджено. WooCommerce ставить статус «Обробляється», або «Виконано» для замовлень без доставки, як зазвичай. У примітці до замовлення вказано суму, ідентифікатор транзакції Windcave, код авторизації, тип картки з замаскованим номером і середовище (UAT або робоче). Ідентифікатор транзакції замовлення — це ідентифікатор транзакції Windcave.

On hold (authorised): платіж Auth схвалено, але ще не захоплено. Примітка до замовлення пояснює, як його захопити або зняти резерв.

On hold (does not match): Windcave передав суму, валюту, референс мерчанта або тип транзакції, які відрізняються від замовлення (наприклад, замовлення було змінено після початку оплати). У примітці перелічено розбіжності. Перевірте платіж у Windcave Payline перед відправкою і за потреби поверніть кошти.

Failed: платіж відхилено. У примітці показано текст і код відповіді Windcave. Покупець може спробувати ще раз.

Якщо для скасованого замовлення надходить схвалений платіж або для вже оплаченого замовлення надходить другий схвалений платіж, замовлення не змінюється. Примітка з ідентифікатором транзакції просить вас повернути кошти у Windcave Payline (або вручну відновити скасоване замовлення).

Захоплення (режим Auth)

Відкрийте замовлення, виберіть Capture Windcave payment у діях замовлення і натисніть кнопку оновлення. Дія з'являється лише для замовлення у статусі «На утриманні» з авторизацією, яку ще не захоплено або не знято з резерву. Списується вся сума замовлення, захоплення додається до приміток, а замовлення переходить далі як оплачене (зазвичай «Обробляється»). Якщо Windcave не приймає захоплення, на екрані замовлення з'являється Windcave capture failed: з причиною, і причина додається до приміток замовлення.

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

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

Для незахопленого платежу Auth можливе лише повне повернення: воно знімає (анулює) авторизацію. Часткова сума спричиняє помилку з вимогою повернути повну суму або спершу захопити платіж.

Якщо Windcave відхиляє повернення, WooCommerce показує Windcave declined the refund: з причиною, і повернення не фіксується. Якщо Windcave ще обробляє повернення, WooCommerce показує Windcave has not confirmed the refund yet. See the order notes., і повернення не фіксується. Перевірте транзакцію у Windcave Payline: якщо її схвалено, зафіксуйте повернення вручну; інакше спробуйте ще раз. Повторна спроба того самого повернення не надсилається до Windcave двічі. Повернення, зроблені у Windcave Payline, магазину не передаються.

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

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

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

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

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

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

Windcave does not appear at checkout: перевірте, що ліцензія активна, Enable/Disable увімкнено і в поточному режимі є обидві облікові дані: UAT API username та UAT API key у тестовому режимі, Production API username та Production API key у робочому режимі.

The payment went through, but the order stays Pending payment: плагін ще не зміг отримати результат від Windcave. Відкрийте примітки до замовлення: у примітці вказано, коли сесію не вдалося перевірити і чому. Переконайтеся, що облікові дані середовища, в якому відбувся платіж, збережені й правильні. Перевірка повторюється, коли Windcave знову надсилає сповіщення (плагін відповідає помилкою, доки результат не можна перевірити, щоб Windcave повторив спробу), і коли покупець відкриває сторінку «Замовлення отримано». Ваш сервер має приймати запити від Windcave на адресу https://your-site/wc-api/windcave_p_notification/.

Authentication failed in the order notes or the log: ім'я користувача або ключ REST API неправильні, або належать до іншого середовища. Облікові дані UAT працюють лише в тестовому режимі, робочі — лише в робочому. Ключі PxPay не працюють.

The customer sees that Windcave could not start the payment with the details of this order: Windcave відхилив запит на сесію, наприклад через валюту або спосіб оплати, який не увімкнено у вашому обліковому записі. Точна причина вказана в примітках до замовлення та в журналі.

Order is On hold after payment: прочитайте примітку до замовлення. Або платіж є Auth, який чекає на захоплення, або сплачена сума, валюта чи референс мерчанта не збігалися із замовленням. Захопіть, відправте або поверніть платіж.

Test payments and live payments: UAT і робоче середовище розділені. Кожна сесія перевіряється в тому середовищі, в якому була створена, а повернення та захоплення надсилаються в середовище платежу, навіть якщо ви пізніше перемкнете Test mode. Замовлення, створені версією 1.0 плагіна, використовують середовище старого налаштування API URL.

Refund fails with a message about the environment: платіж було здійснено в UAT або в робочому середовищі, а облікові дані цього середовища не збережено. Введіть їх і спробуйте ще раз.

Capture Windcave payment is missing in the order actions: дія показується лише для замовлень у статусі «На утриманні», оплачених через Auth, які ще не захоплено або не знято з резерву.

Where to find details: помилки та попередження завжди записуються в WooCommerce > Status > Logs, джерело wcp_windcave_payment_gateway. Увімкніть Debug log, щоб також записувати запити до API та події платежів.

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

Видалення

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

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