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

Вимоги

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

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

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

Валюта: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK або USD. У будь-якій іншій валюті спосіб оплати приховано на сторінці оформлення замовлення. Суми передаються з 2 десятковими знаками; підсумок з більшою кількістю десяткових знаків (наприклад, у магазині з BHD, де 3 десяткові знаки) відхиляється, а не округлюється.

Акаунт CorvusPay: вам потрібен мерчант-акаунт CorvusPay. CorvusPay видає Store ID і Secret Key для кожного магазину, окремо для тестового і робочого; вони відображаються в CorvusPay Merchant Center. Success URL і Cancel URL плагіна потрібно вказати там (див. «Налаштування»).

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

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

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

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

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

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

5. Введіть Store ID і Secret Key вашого тестового магазину CorvusPay (а для реальних платежів — і робочого магазину). Скопіюйте Success URL і Cancel URL, показані на сторінці налаштувань, до CorvusPay Merchant Center — для тестового й робочого магазину.

6. Увімкніть Enable/Disable, оформіть тестове замовлення, потім зніміть прапорець Test Mode, щоб перейти в робочий режим.

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

Усі налаштування містяться на одній сторінці: WooCommerce > Settings > Payments > CorvusPay. Над полями сторінка показує Test mode is on., поки ввімкнено тестовий режим, і попереджає, якщо шлюз увімкнено, але Store ID або Secret Key поточного режиму не заповнено (тоді його приховано на сторінці оформлення замовлення, доки їх не заповнять), а також якщо валюту магазину не підтримує CorvusPay.

Загальні

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

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

Description: текст, що показується під способом оплати на сторінці оформлення замовлення. За замовчуванням: Pay securely with your credit or debit card via CorvusPay. У тестовому режимі до нього додається (Test mode — no real payment is taken.)

Облікові дані магазину

Store ID і Secret Key видає CorvusPay для кожного магазину (окремо для тестового й робочого), вони відображаються в CorvusPay Merchant Center.

Test Mode: Enable test mode використовує тестове середовище CorvusPay (wallet.test.corvuspay.com) і тестові Store ID та Secret Key. За замовчуванням: увімкнено.

Test Store ID: числовий Store ID вашого тестового магазину CorvusPay.

Test Secret Key: Secret Key вашого тестового магазину CorvusPay, використовується для підписів HMAC-SHA256.

Live Store ID: числовий Store ID вашого робочого магазину CorvusPay.

Live Secret Key: Secret Key вашого робочого магазину CorvusPay, використовується для підписів HMAC-SHA256.

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

Success URL і Cancel URL

Скопіюйте дві адреси, показані в цьому розділі, до CorvusPay Merchant Center — для тестового й робочого магазину. CorvusPay повертає покупця на них після оплати.

Success URL: виглядає як https://your-site/wc-api/corvuspay_payment_success/. CorvusPay підписує цей запит; замовлення позначається оплаченим лише після перевірки підпису.

Cancel URL: виглядає як https://your-site/wc-api/corvuspay_payment_cancel/. CorvusPay його не підписує, тому він може скасувати лише неоплачене замовлення з номером замовлення CorvusPay, виданим цим магазином.

Оплата

Transaction Type: як списуються кошти з картки.

Sale (capture immediately): кошти списуються одразу (за замовчуванням).

Authorize only (capture in Merchant Center): суму лише резервують. Замовлення отримує статус «На утриманні»; ви виконуєте захоплення (capture) платежу в CorvusPay Merchant Center, а потім переводите замовлення в статус «Обробка».

Payment Page Language: мова сторінки оплати CorvusPay. Site language (за замовчуванням) використовує поточну мову вашого сайту, якщо CorvusPay її підтримує, інакше — англійську. Також можна вибрати хорватську, англійську, німецьку, італійську, сербську або словенську.

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

Processing (WooCommerce default): за замовчуванням.

Completed: кожне оплачене замовлення отримує статус «Виконано».

On Hold: кожне оплачене замовлення очікує вашої ручної перевірки.

Додатково

Logging: Enable debug logging записує дані до WooCommerce > Status > Logs, джерело wcp_corvuspay_gateway. Помилки записуються завжди; секрети й дані покупців — ніколи. За замовчуванням: вимкнено.

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled). Деактивація нічого не видаляє. Платіжні дані, збережені в замовленнях, залишаються завжди. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Credit/Debit Card (CorvusPay)) і оформлює замовлення. Замовлення залишається в статусі «Очікує на оплату», а сторінка Pay for order показує Redirecting to CorvusPay for payment. Please wait... і надсилає підписану форму на сторінку оплати CorvusPay. Якщо перенаправлення не почалося, покупець натискає Pay via CorvusPay. Передаються сума замовлення, валюта, короткий опис кошика та платіжні дані (щоб заздалегідь заповнити сторінку оплати). Той самий номер замовлення CorvusPay використовується повторно, поки сума не змінюється, а другий платіж за ним CorvusPay не приймає.

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

Якщо покупець скасовує оплату на сторінці CorvusPay, неоплачене замовлення скасовується, а покупець повертається до оформлення замовлення з незмінним кошиком і повідомленням The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. Якщо платіж було розпочато зі сторінки Pay for order, а кошик порожній, WooCommerce показує The CorvusPay payment was cancelled and the order was not paid. на сторінці кошика. Якщо запит на Success URL не вдається перевірити, покупець бачить We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again., а замовлення не змінюється.

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

Замовлення підтверджується лише тоді, коли CorvusPay повертає покупця на Success URL; сповіщень між серверами немає. Якщо покупець закрив браузер одразу після оплати, замовлення залишається в статусі «Очікує на оплату». У плагіні немає повернень коштів, захоплення (capture) та анулювання з WooCommerce (серверний API CorvusPay вимагає клієнтський сертифікат), збережених карток, підписок, оплати частинами, IBAN / PIS та CorvusWallet.

Замовлення

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

Pending payment: покупця було перенаправлено до CorvusPay, і він ще не повернувся. Якщо покупець сплатив, але не повернувся, перевірте платіж у CorvusPay Merchant Center і завершіть замовлення вручну.

Processing, Completed або On Hold: платіж Sale підтверджено. Статус визначається налаштуванням Order Status After Payment. У примітці до замовлення вказано номер замовлення CorvusPay, код авторизації та тип картки. ID транзакції замовлення — це ID транзакції CorvusPay або, якщо CorvusPay його не надсилає, номер замовлення CorvusPay, за яким платіж можна знайти в Merchant Center.

On hold, авторизовано: вибрано Authorize only. Виконайте захоплення (capture) платежу в CorvusPay Merchant Center, а потім переведіть замовлення в статус «Обробка».

On hold, невідповідність суми/валюти: сплачена сума або валюта не збігається із замовленням. Не відправляйте товар, доки не перевірите платіж у CorvusPay Merchant Center.

On hold, платіж за скасоване замовлення: успішний платіж надійшов після того, як замовлення було скасовано, наприклад за тайм-аутом неоплачених замовлень. Виконайте замовлення або поверніть платіж у CorvusPay Merchant Center.

Cancelled: покупець скасував оплату на сторінці CorvusPay.

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

Refunds: повернення коштів, захоплення (capture) й анулювання з WooCommerce не підтримуються. Виконуйте їх у CorvusPay Merchant Center і вручну фіксуйте повернення в WooCommerce.

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

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

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

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

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

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

CorvusPay не з'являється на сторінці оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, Store ID і Secret Key поточного режиму заповнено (Test Store ID і Test Secret Key у тестовому режимі, Live Store ID і Live Secret Key у робочому режимі), а валюту магазину підтримує CorvusPay. У кожному з цих випадків на сторінці налаштувань показується попередження.

Платіж пройшов, але замовлення залишається в статусі «Очікує на оплату»: імовірно, Success URL не внесено в CorvusPay Merchant Center або Secret Key у WooCommerce не відповідає магазину. Увімкніть Logging і знайдіть INVALID signature у WooCommerce > Status > Logs, джерело wcp_corvuspay_gateway. Замовлення залишається неоплаченим і в тому разі, якщо покупець закрив браузер до повернення; тоді перевірте платіж у Merchant Center і завершіть замовлення вручну.

Покупець бачить We could not confirm this CorvusPay payment: запит на Success URL було відхилено: бракувало обов'язкових полів, номер замовлення CorvusPay не було видано для цього замовлення, Secret Key цього магазину порожній або підпис не збігся. Замовлення не змінюється. Причину вказано в журналі.

Покупець бачить This order total cannot be paid via CorvusPay: підсумкова сума дорівнює нулю або має понад 2 десяткові знаки.

Покупець бачить CorvusPay is not configured або CorvusPay does not accept payments in …: не заповнено Store ID або Secret Key поточного режиму, або валюту замовлення не підтримано.

Замовлення в статусі On hold: прочитайте примітку до замовлення. Вибрано Authorize only, сплачена сума або валюта не збіглася із замовленням, або платіж надійшов після скасування замовлення.

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

Видалення

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

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