VibeFox Nexi XPay for WooCommerce — Допомога

Вимоги

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

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

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

Валюта: валюта магазину або замовлення має бути EUR. Для інших валют спосіб оплати приховується на оформленні замовлення.

Обліковий запис Nexi XPay: потрібен обліковий запис мерчанта Nexi XPay (інтеграція з переспрямуванням «Pagamento Semplice») з аліасом (ID термінала) та MAC-ключем вашого термінала. Тестові та робочі облікові дані розділені: тестові беруться в тестовій зоні Nexi XPay або на порталі розробників (developer.nexi.it), робочі — у вашому бек-офісі Nexi XPay після активації облікового запису мерчанта. У бек-офісі Nexi нічого налаштовувати не потрібно: адреса сповіщення надсилається з кожним платежем.

Публічний сайт: URL сповіщення має бути доступним з інтернету, без режиму обслуговування, базової автентифікації чи правила брандмауера, що блокує Nexi. Інакше платіж усе одно підтвердиться підписаним поверненням покупця.

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

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

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

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

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

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

5. Залиште Test Mode увімкненим і введіть тестовий аліас та MAC-ключ (див. Налаштування).

6. Увімкніть Enable/Disable і зробіть тестове замовлення. Коли все працює, введіть робочий аліас та MAC-ключ і зніміть позначку з Test Mode.

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

Усі налаштування розміщені на одній сторінці: WooCommerce > Settings > Payments > Nexi XPay. Над полями сторінка показує Тестовий режим увімкнено: платежі йдуть у тестове середовище Nexi XPay, реальні кошти не списуються., поки тестовий режим увімкнений, і попереджає, якщо шлюз увімкнено, але аліас або MAC-ключ поточного режиму порожні, або якщо валюта магазину не EUR. В обох випадках спосіб оплати приховується на оформленні замовлення. Пробіли та переноси рядків навколо вставлених ключів видаляються під час збереження.

Загальні

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

Title: назва способу оплати, яку бачить покупець на оформленні замовлення. За замовчуванням: Credit Card (Nexi). У тестовому режимі на оформленні замовлення до назви додається (TEST MODE).

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

Тестове середовище

Тестові платежі надсилаються на int-ecommerce.nexi.it і ніколи не списують кошти з реальних карток. Тестові аліас та MAC-ключ отримуйте в тестовій зоні Nexi XPay або на порталі розробників (developer.nexi.it).

Test Mode: Enable test mode використовує тестове середовище Nexi XPay та тестові облікові дані. Зніміть позначку, щоб приймати реальні платежі з робочими обліковими даними. За замовчуванням: увімкнено.

Test Alias: аліас (ID термінала) вашого тестового термінала Nexi XPay.

Test MAC Key: ключ обчислення MAC вашого тестового термінала Nexi XPay.

Робоче середовище

Робочі аліас та MAC-ключ відображаються у вашому бек-офісі Nexi XPay (ecommerce.nexi.it) після активації облікового запису мерчанта.

Live Alias: аліас (ID термінала) вашого робочого термінала Nexi XPay.

Live MAC Key: ключ обчислення MAC вашого робочого термінала Nexi XPay.

Оплата

URL сповіщення передається в Nexi з кожним платежем, тому в бек-офісі нічого налаштовувати не потрібно. Розділ показує цю адресу; вона має вигляд https://your-site/wp-json/wc-nexi-gateway/v1/s2s/{order_id}, а наприкінці стоїть ID замовлення. Nexi надсилає результат платежу на цей URL від сервера до сервера, а також передає його разом з поверненням покупця. Обидва підписуються однаково й перевіряються MAC-ключем середовища, в якому було здійснено платіж, аліасом цього середовища та кодом транзакції, виданим для цього замовлення. Результати, що не пройшли перевірку, відхиляються і нічого не змінюють.

Capture: коли кошти списуються.

Immediate capture: платіж списується одразу, і замовлення позначається оплаченим (за замовчуванням).

Deferred capture (authorize only): списання відповідає профілю вашого термінала. Замовлення переходить у статус «На утриманні» як авторизоване, доки ви не спишете кошти дією Capture Nexi XPay payment або в бек-офісі Nexi, а потім не встановите для замовлення статус «В обробці».

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

В обробці (за замовчуванням WooCommerce): значення за замовчуванням.

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

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

Додатково

Debug Log: Enable logging записує події платежів у WooCommerce > Status > Logs, джерело wcp_nexi_gateway. MAC-ключі, дані карток і адреси електронної пошти не записуються. Помилки та попередження, наприклад невдала перевірка MAC, записуються завжди, навіть коли опцію вимкнено. За замовчуванням: вимкнено.

Delete Data on Uninstall: Remove all plugin settings and logs when uninstalled. За замовчуванням: вимкнено.

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

Покупець вибирає спосіб оплати (за замовчуванням Credit Card (Nexi)) і оформлює замовлення. Наступна сторінка показує Переспрямування на Nexi XPay для оплати... і автоматично надсилає покупця на сторінку Nexi XPay, з кнопкою Pay Now як запасним варіантом. Платіж надсилається в EUR з новим кодом транзакції, електронною поштою покупця та описом Order, номером замовлення і назвою вашого сайту. Сторінка Nexi відкривається мовою магазину, якщо це італійська, англійська, іспанська, французька, німецька, японська, китайська, арабська, російська або португальська мова; інакше — англійською.

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

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

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

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

Плагін приймає платежі лише на сторінці Nexi XPay. Він не має повернень із WooCommerce, збережених карток чи OneClick, підписок або регулярних платежів, Pay-By-Link, вбудованих полів XPay Build та способів оплати, вибраних у WooCommerce: сторінка Nexi показує способи, увімкнені на вашому терміналі.

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

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

Очікує оплати: покупця надіслано до Nexi, і він ще не оплатив або скасував оплату на сторінці Nexi.

В обробці, Виконано або На утриманні: Nexi підтвердив платіж. Статус відповідає Order Status After Payment. У примітці до замовлення показано код авторизації, код транзакції, марку картки та повідомлення Nexi. ID транзакції — це код транзакції Nexi.

На утриманні (авторизовано): вибрано відкладене списання, і платіж лише авторизовано. Спишіть його дією Capture Nexi XPay payment.

На утриманні (очікує): Nexi повідомив, що платіж очікує підтвердження. Замовлення оновиться за остаточним результатом.

На утриманні після оплати: сума або валюта, отримані від Nexi, не збіглися із замовленням (замовлення не позначено оплаченим), або надійшов успішний платіж для вже скасованого замовлення. Примітка до замовлення пояснює причину. Перевірте платіж у бек-офісі Nexi XPay та обробіть або поверніть кошти за замовленням.

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

Оплачене замовлення ніколи не понижується через пізнішу невдачу. Якщо для вже оплаченого замовлення надходить ще один успішний платіж, примітка запропонує повернути його в бек-офісі Nexi XPay, якщо це дублікат.

Відкладене списання

Для авторизованого замовлення на утриманні відкрийте замовлення, виберіть Capture Nexi XPay payment серед дій із замовленням і натисніть стрілку. Плагін спише авторизовану суму в середовищі платежу та позначить замовлення оплаченим зі статусом із Order Status After Payment. Якщо списання не вдалося, помилка показується на екрані замовлення і додається до приміток, а замовлення залишається на утриманні.

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

Повернення з WooCommerce не виконуються, тож кнопки Refund via немає. Здійсніть повернення в бек-офісі Nexi XPay, а потім вручну зафіксуйте його в WooCommerce.

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

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

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

Без активного ключа Nexi XPay не показується покупцям на оформленні замовлення. Якщо платіж усе ж розпочато, покупець бачить Цей спосіб оплати недоступний. Виберіть інший. Авторизовані адміністратори магазину й далі бачать спосіб оплати, позначений як (unlicensed — visible to admins only), тож ви можете налаштувати та протестувати плагін до покупки ключа. Нагадування з'являється на сторінці Plugins і на сторінках WooCommerce. Наявні замовлення не змінюються: платежі, які вже розпочато, як і раніше підтверджуються, а відкладені платежі можна списати.

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

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

Nexi XPay не з'являється на оформленні замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, у поточному режимі заповнені обидві облікові дані (Test Alias і Test MAC Key у тестовому режимі, Live Alias і Live MAC Key у робочому режимі) і валюта магазину або замовлення — EUR. Сторінка налаштувань у цих випадках показує попередження.

Платіж пройшов, але замовлення залишається в статусі Очікує оплати: ні сповіщення, ні повернення покупця не були прийняті. Перевірте, що магазин доступний з інтернету, що MAC-ключ і аліас відповідають середовищу (тестовому чи робочому) платежу, і увімкніть Debug Log, щоб побачити, що надіслав Nexi, у WooCommerce > Status > Logs, джерело wcp_nexi_gateway.

Сповіщення відповідає invalid_mac або invalid_alias: MAC-ключ або аліас у налаштуваннях не збігаються з терміналом, який надіслав результат. Скопіюйте їх знову з тестової зони або бек-офісу Nexi.

Сповіщення відповідає unknown_transaction: код транзакції не був виданий цим магазином для цього замовлення. Результат ігнорується.

Сповіщення відповідає not_configured або busy: аліас або MAC-ключ середовища платежу порожній, або інший запит у цей момент оновлював замовлення. Nexi повторить сповіщення.

Замовлення На утриманні після оплати: прочитайте примітку до замовлення. Вибрано відкладене списання (спишіть платіж дією із замовленням), сума або валюта не збіглися, надійшов платіж для скасованого замовлення, платіж очікує в Nexi, або як статус після оплати вибрано На утриманні.

Capture Nexi XPay payment відсутній або не працює: дія показується лише для замовлень Nexi, що перебувають на утриманні як авторизовані з відкладеним списанням. Якщо вона не працює, прочитайте помилку в примітках до замовлення; списання використовує ключі середовища, в якому було здійснено платіж.

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

Видалення

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

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