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

Вимоги

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

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

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

Обліковий запис Nets: потрібні секретні ключі вашого облікового запису Nets Easy (тестовий і робочий). Використовуються лише секретні ключі. Ключі для оформлення замовлення не потрібні, оскільки покупці платять на розміщеній сторінці оплати Nets.

Валюти та способи оплати: плагін не обмежує валюти чи країни. Використовуйте валюти, увімкнені у вашому обліковому записі Nets; непідтримувану валюту Nets повідомляє під час створення платежу. Які способи оплати бачить покупець, залежить від вашого договору з Nets, країни та валюти.

HTTPS для вебхуків: Nets викликає лише публічні HTTPS-адреси довжиною не більше 256 символів і без «&», тож вашому сайту потрібні HTTPS і зрозумілі постійні посилання, щоб отримувати вебхуки. На інших сайтах платіж усе одно підтверджується, коли покупець повертається до магазину, або через дію із замовленням.

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

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

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

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

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

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

5. Скопіюйте тестовий секретний ключ із тестового порталу Nets Easy і вставте його в Test Secret Key (див. розділ Конфігурація).

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

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

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

Загальні

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

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

Description: опис способу оплати, який бачить покупець під час оформлення замовлення. За замовчуванням: Pay securely with Nets Easy.

Ключі API

Скопіюйте секретні ключі з порталу Nets Easy у розділі Company > Integration: тестовий портал (test.portal.dibspayment.eu) для тестового ключа та робочий портал (portal.dibspayment.eu) для робочого ключа. Ключі для оформлення замовлення не потрібні.

Test Mode: Enable test mode. Тестовий режим використовує test.api.dibspayment.eu з тестовим секретним ключем; робочий режим використовує api.dibspayment.eu з робочим секретним ключем. Повернення та списання замовлення завжди виконуються в тому середовищі, де його було оплачено. За замовчуванням: увімкнено.

Test Secret Key: ваш секретний ключ API тестового середовища Nets.

Live Secret Key: ваш секретний ключ API робочого середовища Nets.

Оплата

Сповіщення Nets (вебхуки) реєструються автоматично з кожним платежем. У порталі Nets нічого налаштовувати не потрібно. Цей розділ показує URL вебхука. Він має вигляд https://your-site/wc-api/nng_nets_nexi/. Якщо URL не є публічною HTTPS-адресою, розділ попереджає, що сайт не отримує вебхуки; тоді платежі підтверджуються, коли покупець повертається до магазину, або через дію із замовленням Nets: check payment status and capture. Реєструються такі події:

Кожен вебхук має містити випадковий секрет, який плагін створив для цього замовлення. Вебхуки без правильного секрета відхиляються. Вебхук лише повідомляє плагіну, який платіж змінився: сам платіж завжди запитується з API Nets за вашим секретним ключем.

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

Додатково

Debug log: Enable debug logging записує виклики API та зміни статусів платежів до WooCommerce > Status > Logs, джерело wcp_nets_nexi_gateway. Помилки записуються завжди. Ключі та дані покупців не записуються. За замовчуванням: вимкнено.

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

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

Покупець обирає спосіб оплати (за замовчуванням Nets Easy) і оформлює замовлення. Плагін створює платіж Nets із позиціями замовлення, доставкою та комісіями у валюті замовлення і перенаправляє покупця на розміщену сторінку оплати Nets. Адреса електронної пошти, ім'я, адреса та телефон покупця передаються в Nets, якщо Nets приймає їхній формат; на сторінці Nets розміщено посилання на ваші умови. У тестовому режимі під час оформлення замовлення показується Test mode: no real money will be charged.

Покупець оплачує і повертається на сторінку підтвердження замовлення вашого магазину. Замовлення позначається оплаченим лише після підтвердження Nets: плагін отримує платіж з API Nets, порівнює зарезервовану суму та валюту із замовленням, списує резервування і лише потім завершує замовлення. Це відбувається через вебхук, під час повернення покупця на сторінку підтвердження замовлення або через дію із замовленням Nets: check payment status and capture.

Якщо покупець скасовує оплату на сторінці Nets, він повертається до оформлення замовлення або на сторінку Pay for order з повідомленням The Nets payment was cancelled. You can try again or choose another payment method. Покупець може знову оплатити неоплачене замовлення. Плагін спершу перевіряє попередній платіж; якщо його вже оплачено, замовлення підтверджується. Інакше попередня сесія Nets закривається, перш ніж почнеться нова. Якщо платіж за замовленням утримується для вашої перевірки, покупець бачить A payment for this order is already being reviewed by the shop. Please contact us instead of paying again.

Якщо Nets не може розпочати платіж, покупець бачить коротке повідомлення, наприклад Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method. або The payment service could not be reached. Please try again in a moment. Подробиці записуються до журналу.

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

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

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

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

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

Processing or Completed: Nets підтвердила та списала платіж. Статус відповідає налаштуванню Order Status After Payment. Примітка до замовлення показує ID платежу, ID списання та спосіб оплати. ID транзакції — це ID платежу Nets.

On hold: сума або валюта в Nets відрізняються від замовлення (не списано), списання відхилено, або покупець оплатив після скасування замовлення (зарезервовано, не списано). Примітка до замовлення пояснює причину. Після перевірки замовлення захопіть його дією Nets: check payment status and capture або скасуйте резервування в порталі Nets.

Cancelled: резервування останнього платежу замовлення скасовано, наприклад у порталі Nets.

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

Дія із замовленням

Для неоплачених замовлень із платежем Nets у списку дій із замовленням є Nets: check payment status and capture. Вона отримує платіж з Nets і захоплює відповідне резервування. Якщо нічого не змінилося, примітка пояснить причину, наприклад що покупець ще не завершив оплату.

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

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

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

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

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

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

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

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

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

Nets Nexi не з'являється під час оформлення замовлення: перевірте, чи ліцензія активна, чи увімкнено Enable/Disable і чи у вибраному режимі є секретний ключ: Test Secret Key у тестовому режимі, Live Secret Key у робочому. Сторінка налаштувань показує попередження, якщо ключ відсутній.

Платіж пройшов, але замовлення залишається в статусі Pending payment: вебхук не дійшов до вашого магазину. Перевірте, чи сайт використовує HTTPS і зрозумілі постійні посилання, щоб URL вебхука в розділі Payment був публічною HTTPS-адресою без «&», і чи задано секретний ключ середовища платежу. Потім скористайтеся дією із замовленням Nets: check payment status and capture. Замовлення також підтверджується, коли покупець повертається на сторінку підтвердження замовлення.

Webhook answers Unauthorized: вебхук не містив секрету цього замовлення. Вебхуки приймаються лише з секретом, зареєстрованим із платежем.

Webhook answers Busy, retry later, Payment lookup failed або Payment not reserved yet: інший запит оновлював замовлення, API Nets був недоступний або резервування ще не було видно. Nets повторно надсилає вебхук автоматично.

Покупець бачить помилку під час оформлення замовлення: увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело wcp_nets_nexi_gateway. This payment method is temporarily unavailable. Please choose another payment method. зазвичай означає неправильний або відсутній секретний ключ. Відхилену валюту Nets вказує в журналі.

Order is On hold after payment: прочитайте примітку до замовлення. Якщо списання відхилено, повторіть його дією Nets: check payment status and capture або спишіть у порталі Nets. Якщо сума чи валюта відрізняються, перевірте платіж у порталі Nets. Якщо покупець оплатив після скасування, перегляньте замовлення та захопіть або скасуйте резервування.

Refund via Nets Easy відсутня або не працює: повернення можливі лише після списання платежу. Перевірте в примітці до замовлення, що списання є. Повернення використовує секретний ключ середовища, в якому оплачено замовлення, тому цей ключ має бути задано.

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

Видалення

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

Nets, Nets Easy і Nexi є торговими марками їхніх власників. Цей плагін не пов'язаний із Nets або Nexi і не схвалений ними.