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

Вимоги

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

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

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

Валюта магазину: HUF, EUR або USD. SimplePay не приймає інші валюти, і для них спосіб оплати не пропонується.

Облікові записи мерчанта SimplePay: SimplePay надає окремий обліковий запис мерчанта для кожної валюти, а також окремі облікові записи для робочого і тестового режимів. Для кожного облікового запису потрібні його MERCHANT і SECRET KEY з панелі мерчанта SimplePay (admin.simplepay.hu для робочого режиму, sandbox.simplepay.hu для тестового), обліковий запис > Технічні дані. Якщо ви продаєте лише в HUF, достатньо облікового запису HUF. Інші ключі не потрібні.

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

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

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

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

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

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

5. Введіть MERCHANT і SECRET KEY ваших облікових записів SimplePay для кожної валюти, в якій ви продаєте: тестові облікові записи для перевірки та робочі для реальних платежів (див. Конфігурація).

6. Скопіюйте IPN URL, який показано на сторінці налаштувань, в кожен обліковий запис мерчанта (робочий і тестовий) у панелі SimplePay.

7. Увімкніть Enable/Disable, перевірте платіж із увімкненим Sandbox mode, а потім вимкніть Sandbox mode, щоб приймати реальні платежі.

Під час оновлення з версії 1.0 єдині Merchant ID і Secret key версії 1.0 переносяться в обліковий запис валюти магазину в режимі, який був активним (тестовому або робочому). Перевірте облікові записи після оновлення.

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

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

Загальні

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

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

Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay securely with your credit or debit card via SimplePay. Угорські мерчанти мають показувати на оформленні замовлення декларацію про передачу даних SimplePay (Adattovábbítási nyilatkozat). Її можна вказати тут разом із посиланням.

Sandbox mode: Use the SimplePay sandbox спрямовує платежі в тестове середовище SimplePay і використовує тестові облікові записи. Перемикаються і адреса API, і облікові записи мерчанта. Реальні кошти не списуються. За замовчуванням: увімкнено. Зніміть позначку, щоб приймати реальні платежі за робочими обліковими записами.

Облікові записи мерчанта для робочого режиму

Облікові записи, які використовуються, коли Sandbox mode вимкнено. Заповніть облікові записи валют, у яких продає ваш магазин. Значення MERCHANT і SECRET KEY містяться в панелі мерчанта SimplePay (admin.simplepay.hu), обліковий запис > Технічні дані. Обліковий запис використовується лише тоді, коли заповнені обидва поля.

HUF account — Merchant ID: MERCHANT вашого робочого облікового запису HUF.

HUF account — Secret key: SECRET KEY вашого робочого облікового запису HUF.

EUR account — Merchant ID і EUR account — Secret key: те саме для вашого робочого облікового запису EUR.

USD account — Merchant ID і USD account — Secret key: те саме для вашого робочого облікового запису USD.

Облікові записи мерчанта для тестового режиму

Облікові записи, які використовуються, коли Sandbox mode увімкнено. Поля такі самі, як для робочих облікових записів: HUF account — Merchant ID, HUF account — Secret key та такі самі пари для EUR і USD. Значення беріть із панелі мерчанта тестового середовища SimplePay (sandbox.simplepay.hu), обліковий запис > Технічні дані.

IPN URL

IPN — це повідомлення, яке SimplePay надсилає вашому магазину, коли змінюється статус платежу. Це звичайний спосіб, у який замовлення стає оплаченим. На сторінці налаштувань показано IPN URL вашого магазину. Він має такий вигляд: https://your-site/wc-api/simplepay_payment_callback/. Вкажіть цю URL для кожного облікового запису мерчанта, робочого і тестового, у панелі SimplePay. Якщо ваш сайт використовує мовний префікс в URL або перенаправляє інші адреси, скопіюйте URL точно так, як його показують налаштування, бо перенаправлений IPN губиться.

IPN має бути підписаний SECRET KEY того облікового запису мерчанта, який він називає. IPN без дійсного підпису відхиляються. Плагін підтверджує кожен дійсний IPN для SimplePay у підписаній формі, яку вимагає SimplePay. Ці статуси IPN змінюють замовлення:

Статуси «Невдалий» і «Скасовано» встановлюються лише для останньої спроби оплати замовлення, яке ще має статус «Очікує оплати». Інші статуси записуються в журнал і не змінюють замовлення. Без IPN замовлення підтверджується лише тоді, коли покупець повертається до магазину після успішного платежу.

Замовлення

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

Додатково

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

Delete Data on Uninstall: Remove all plugin data when uninstalling. Якщо опцію увімкнено, видалення плагіна стирає налаштування шлюзу та журнали плагіна. Дані замовлень завжди зберігаються. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням SimplePay (Card Payment)) і оформлює замовлення. Плагін запускає платіж карткою SimplePay на суму замовлення у валюті замовлення, з обліковим записом мерчанта цієї валюти в поточному режимі, і надсилає покупця на платіжну сторінку SimplePay. Сторінка показує те, що ваш обліковий запис мерчанта дозволяє для платежів картками. E-mail покупця і, якщо вона заповнена повністю, платіжна адреса передаються в SimplePay. Платіжна сторінка використовує мову вашого сайту, якщо SimplePay її підтримує, інакше англійську. Розпочатий платіж можна оплатити протягом 30 хвилин.

Після успішної оплати покупець повертається на сторінку «Замовлення отримано» вашого магазину. Саме лише повернення не оплачує замовлення: плагін запитує у SimplePay статус транзакції підписаним запитом, тож замовлення підтверджується, навіть якщо IPN прийшов із запізненням. Сторінка «Замовлення отримано» показує Successful transaction. SimplePay transaction ID: та ID. Якщо платіж ще не підтверджено, вона показує Your payment is being confirmed by SimplePay. SimplePay transaction ID: та ID.

Якщо платіж не пройшов, скасовано або минув час, покупець повертається до оформлення замовлення або, якщо кошик порожній, на сторінку Pay for order. Там він бачить повідомлення SimplePay з ID транзакції, наприклад Cancelled payment. You cancelled the payment або Timeout. The time allowed to complete the payment has expired. У разі невдалого платежу покупцеві пропонують перевірити введені дані та звернутися до банку, що видав картку. Покупець може спробувати знову. Кожна нова спроба отримує власний референс SimplePay, наприклад 123, 123-2, 123-3.

Якщо SimplePay не може розпочати платіж, покупець бачить The SimplePay payment could not be started. Please try again or choose another payment method. Якщо для валюти замовлення немає облікового запису мерчанта, повідомлення буде SimplePay is not available for the currency of this order. Please choose another payment method. Технічна причина додається до приміток замовлення та журналу. Менеджери магазину, які ввійшли в систему, бачать її і в повідомленні.

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

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

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

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

Pending payment: покупця відправлено до SimplePay, і він ще не сплатив, або SimplePay ще не підтвердив платіж. Примітка до замовлення показує розпочату транзакцію, суму та режим (тестовий або робочий).

Processing or Completed: платіж підтверджено. Статус відповідає Order Status After Payment. Примітка до замовлення показує ID транзакції та те, чи підтвердив платіж IPN або запит статусу. ID транзакції SimplePay зберігається як ID транзакції замовлення. Пізній успішний платіж також завершує замовлення, яке мало статус «Невдалий» або «Скасовано».

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

Failed: SimplePay повідомив, що остання спроба платежу не авторизована або є шахрайством.

Cancelled: SimplePay повідомив, що остання спроба платежу минула за часом або була скасована.

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

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

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

Повернення, зроблені в панелі мерчанта SimplePay, не синхронізуються з WooCommerce. Зареєструйте їх у WooCommerce вручну, без використання Refund via SimplePay (OTP).

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

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

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

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

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

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

SimplePay не з'являється на оформленні замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, валюта замовлення — HUF, EUR або USD, і для цієї валюти в поточному режимі заповнені і Merchant ID, і Secret key: тестові облікові записи, поки увімкнено Sandbox mode, робочі — поки його вимкнено. Сторінка налаштувань показує попередження, якщо для валюти магазину немає облікового запису.

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

IPN відповідає Invalid signature: IPN називає обліковий запис мерчанта, якого немає в налаштуваннях, або її Secret key невірний. Введіть MERCHANT і SECRET KEY точно так, як їх показує панель мерчанта SimplePay. SimplePay повторює непідтверджені IPN.

IPN відповідає Order not found або Unknown transaction: IPN стосується замовлення або транзакції, які цей магазин не розпочинав. Замовлення не змінюється.

IPN відповідає Busy, retry: замовлення в цей самий момент підтверджувалося іншим запитом. SimplePay повторить IPN.

Покупець бачить помилку під час оформлення замовлення: відкрийте примітки до замовлення або перегляньте WooCommerce > Status > Logs, джерело wcp_simplepay_gateway. Невірний secret key дає Invalid response signature from SimplePay. Check the secret key of the merchant account. Помилки SimplePay показуються як SimplePay error code(s): і далі коди.

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

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

Повернення не проходить: прочитайте повідомлення. SimplePay refunds in HUF must be whole amounts. означає, що сума в HUF містила десяткові знаки. Якщо повідомлення каже, що обліковий запис мерчанта для цього платежу не налаштовано, введіть знову обліковий запис (валюту і режим), у яких було зроблено платіж. Якщо SimplePay повернув іншу суму, повідомлення просить перевірити повернення в панелі SimplePay.

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

Видалення

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

SimplePay — торгова марка її власника. Цей плагін не пов'язаний із SimplePay і не схвалений ним.