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

Вимоги

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

WooCommerce: 7.0 або новіша версія, встановлений і активний.

PHP: 8.0 або новіша версія з розширеннями OpenSSL і DOM.

Валюта: валюта магазину або замовлення має бути RON, EUR, USD або GBP. EUR, USD і GBP мають бути увімкнені у вашому обліковому записі Netopia. Для інших валют спосіб оплати приховується під час оформлення замовлення.

Обліковий запис Netopia: потрібен обліковий запис продавця Netopia Payments із точкою продажу. З технічних налаштувань потрібні підпис облікового запису та для кожного середовища, яке ви використовуєте (тестового і робочого), відкритий сертифікат (.cer) і закритий ключ (.key). На боці Netopia нічого налаштовувати не треба: адреса IPN передається з кожним запитом на оплату.

Публічний сайт: URL для IPN (підтвердження) має бути доступний з інтернету і не знаходитися за логіном, базовою автентифікацією або сторінкою обслуговування. Замовлення оновлюються лише через IPN від Netopia.

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

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

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

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

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

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

5. В адмін-панелі Netopia відкрийте свою точку продажу, скопіюйте підпис облікового запису та завантажте сертифікат і закритий ключ тестового і робочого середовищ. Вставте підпис і повний вміст файлів у налаштування (див. розділ Конфігурація).

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

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

Усі налаштування розташовані на одній сторінці: WooCommerce > Settings > Payments > Netopia Payments. Над полями сторінка попереджає, якщо немає підпису облікового запису, сертифіката або закритого ключа активного середовища (тоді спосіб оплати приховується під час оформлення замовлення), і показує Test mode is on: payments go to the Netopia sandbox and no real money is charged., поки тестовий режим увімкнено. У списку способів оплати Netopia позначено як такий, що потребує налаштування, доки активне середовище не заповнене. Під час збереження недійсні сертифікат або закритий ключ відхиляються з помилкою, а попереднє значення зберігається.

IPN (confirm) URL

Відображається лише для читання у верхній частині налаштувань. Має вигляд https://your-site/wc-api/netopia_payment_callback/. Він передається з кожним запитом на оплату як URL підтвердження, тож вводити його в адмін-панелі Netopia не потрібно. Netopia надсилає IPN на цю адресу; плагін розшифровує її закритим ключем активного середовища і перевіряє підпис вашого облікового запису та запит на оплату. Netopia повідомляє про такі дії:

Сповіщення з кодом помилки Netopia (наприклад, відхилена картка) переводить неоплачене замовлення у статус Failed. Сповіщення, які не можна розшифрувати, які містять інший підпис облікового запису або не відповідають запиту на оплату цього замовлення, відхиляються і нічого не змінюють.

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

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

Title: назва способу оплати, яка показується під час оформлення замовлення. За замовчуванням: Card Payment (Netopia).

Description: опис способу оплати, який показується під час оформлення замовлення. За замовчуванням: Pay securely with your credit or debit card via Netopia.

Обліковий запис Netopia

В адмін-панелі Netopia перейдіть до Seller accounts > your point of sale > Technical settings: скопіюйте підпис облікового запису і завантажте відкритий сертифікат (.cer) і закритий ключ (.key) кожного середовища. Відкрийте файли в текстовому редакторі та вставте їх повний вміст, включно з рядками BEGIN/END.

Account signature: підпис облікового запису продавця (формат XXXX-XXXX-XXXX-XXXX-XXXX), однаковий для тестового і робочого середовищ.

Test mode: Use the Netopia sandbox (sandboxsecure.mobilpay.ro) and the sandbox keys. Перемикає сторінку оплати та пару ключів. За замовчуванням: увімкнено. Вимкніть, щоб приймати справжні платежі з робочими ключами.

Sandbox public certificate (.cer): вміст файлу відкритого сертифіката тестового середовища. Він використовується для шифрування запиту на оплату.

Sandbox private key (.key): вміст файлу закритого ключа тестового середовища. Він використовується для розшифрування IPN. Після збереження його більше не показують; поле відображає A private key is saved. Залиште поле порожнім, щоб зберегти чинний ключ, або вставте новий ключ для заміни.

Live public certificate (.cer): вміст файлу відкритого сертифіката робочого середовища.

Live private key (.key): вміст файлу закритого ключа робочого середовища. Після збереження його більше не показують; залиште поле порожнім, щоб зберегти чинний ключ.

Замовлення

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

Додатково

Debug log: Log requests and IPN processing записує до WooCommerce > Status > Logs, джерело wcp_netopia_gateway. Дані картки, ключі та дані покупців не записуються. Помилки, наприклад відхилені IPN, записуються завжди, навіть якщо опцію вимкнено. За замовчуванням: вимкнено.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted (orders are kept). За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Card Payment (Netopia)) і оформлює замовлення. Наступна сторінка показує Redirecting you to Netopia for secure payment… і автоматично перенаправляє покупця на сторінку оплати Netopia; як запасні варіанти доступні кнопки Proceed to payment і Cancel order. Запит на оплату шифрується вашим сертифікатом Netopia і містить суму замовлення у валюті замовлення, Order # з номером замовлення, а також контактні дані для рахунку та доставки. У тестовому режимі запит надсилається в тестове середовище Netopia.

Покупець оплачує карткою на сторінці Netopia і повертається на сторінку підтвердження замовлення вашого магазину. Саме повернення не позначає замовлення оплаченим. Замовлення позначається оплаченим лише після підтвердження Netopia через IPN. До того часу на сторінці підтвердження замовлення показується Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. Для замовлення в статусі On hold показується Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. Якщо оплату скасовано, показується The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time.

Якщо картку відхилено, замовлення переходить у статус Failed, і покупець може оплатити його знову зі сторінки замовлення. Якщо плагін налаштовано неправильно, сторінка оплати показує Netopia gateway is not configured properly. Please contact the store administrator.

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

Плагін приймає оплату картками лише за протоколом карткових платежів Netopia v1. Він не підтримує повернення коштів і захоплення через WooCommerce, збережені картки чи оплату в один клік, підписки, розстрочку, SMS, банківські перекази або криптоплатежі, а також Netopia API v2.

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

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

Pending payment: покупця перенаправлено до Netopia, або Netopia ще не надіслала IPN.

Processing or Completed: Netopia підтвердила платіж. Статус відповідає налаштуванню Order status after payment. Примітка до замовлення показує суму, замаскований номер картки і транзакцію Netopia; тестові платежі позначено [sandbox]. ID транзакції — це ID транзакції Netopia.

On hold: платіж є попередньою авторизацією, яка очікує на захоплення в адмін-панелі Netopia, або перевіряється в Netopia. Замовлення позначається оплаченим, коли Netopia його підтверджує. Замовлення також переходить у On hold, якщо сума або валюта рахунку в Netopia відрізняються від замовлення, якщо захоплено лише частину суми або якщо Netopia підтвердила оплату скасованого замовлення. Примітка до замовлення пояснює причину. Перевірте транзакцію в адмін-панелі Netopia і завершіть замовлення або оформіть повернення вручну.

Failed: Netopia повідомила про помилку, наприклад відхилену картку. Покупець може оплатити знову.

Cancelled: Netopia скасувала платіж, або покупець натиснув Cancel order до переходу в Netopia.

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

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

Повернення коштів не оформлюються через WooCommerce: протокол карткових платежів Netopia v1 не має виклику повернення, тому кнопки Refund via немає. Оформіть повернення транзакції в адмін-панелі Netopia. Після цього Netopia надішле IPN про зарахування, і плагін автоматично зареєструє повернення в замовленні з причиною Refund initiated by Netopia. Часткові повернення залишають статус замовлення без змін; коли повертати більше нічого, WooCommerce переводить замовлення в статус Refunded. Для замовлень у EUR, USD і GBP сума повернення, яку Netopia вказує в RON, перераховується назад у валюту замовлення. Повернення ніколи не реєструється двічі і не перевищує залишок. Запаси автоматично не поповнюються.

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

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

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

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

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

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

Netopia не з'являється під час оформлення замовлення: перевірте, чи ліцензія активна, чи увімкнено Enable/Disable, чи активне середовище заповнене (Account signature плюс сертифікат і закритий ключ тестового середовища в тестовому режимі, або робочого — у робочому режимі) і чи валюта магазину або замовлення — RON, EUR, USD або GBP. Сторінка налаштувань показує попередження, якщо щось відсутнє.

Платіж пройшов, але замовлення залишається в статусі Pending payment: IPN не дійшла до вашого магазину або була відхилена. Перевірте, чи URL IPN (підтвердження) з налаштувань доступний з інтернету (без режиму обслуговування, базової автентифікації та брандмауера, що блокує запити). Увімкніть Debug log і знайдіть рядки IPN у WooCommerce > Status > Logs, джерело wcp_netopia_gateway. Саме лише повернення покупця ніколи не позначає замовлення оплаченим.

Log shows failed decrypting data: закритий ключ не відповідає сертифікату середовища, яке використала Netopia. IPN розшифровується ключем активного середовища, а для платежів, розпочатих до перемикання тестового режиму, — ключем іншого середовища. Netopia повторить надсилання.

Log shows signature mismatch: Account signature не збігається з точкою продажу, яка надіслала IPN. Скопіюйте її знову з адмін-панелі Netopia.

Log shows unknown payment request: IPN не відповідає запиту на оплату, який ваш магазин надіслав для цього замовлення в цьому середовищі (тестовому або робочому). Нічого не змінюється.

Log shows gateway not configured: відсутній закритий ключ або підпис облікового запису. Netopia повторить IPN, і платіж буде зареєстровано, щойно налаштування будуть заповнені.

Error on save about the certificate or private key: вставлений текст не є дійсним сертифікатом або ключем. Вставте повний вміст файлу, включно з рядками BEGIN/END. Попереднє значення збережено.

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

A refund made in Netopia does not appear on the order: IPN про зарахування не дійшла до магазину або була відхилена. Перегляньте журнал. За потреби створіть повернення вручну в WooCommerce.

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

Видалення

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

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