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

Вимоги

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

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

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

Служба Autopay: потрібні Service ID і Shared key (ключ хешування) вашої служби Autopay. Вони показані в порталі мерчанта Autopay: portal.autopay.eu для робочого режиму, testportal.autopay.eu для тестового. Тестові служби мають власні Service ID і Shared key; попросіть Autopay відкрити одну. Хеш-функція служби має бути SHA-256.

Валюта: валюта магазину має бути PLN, EUR, GBP, USD або CZK і прийматися вашою службою Autopay.

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

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

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

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

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

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

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

5. Введіть Service ID і Shared key (тестові та робочі) і оберіть валюти вашої служби.

6. У порталі Autopay задайте ITN URL, URL повернення та хеш-функцію SHA-256 для вашої служби (див. розділ «Налаштування»).

7. Увімкніть Enable/Disable. Зробіть тестове замовлення в тестовому режимі, а потім зніміть позначку з Test mode для справжніх платежів.

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

Усі параметри розміщені на одній сторінці: WooCommerce > Settings > Payments > Autopay. Над полями сторінка попереджає, якщо Service ID або Shared key вибраного середовища порожні, а також коли валюта магазину не вибрана в Currencies. В обох випадках спосіб оплати приховується під час оформлення замовлення. У списку способів оплати Autopay позначено як такий, що потребує налаштування, доки для вибраного середовища не буде облікових даних.

Загальні

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

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

Description: текст під способом оплати під час оформлення замовлення. За замовчуванням: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.

Служба Autopay

Service ID і Shared key показані в порталі мерчанта Autopay (portal.autopay.eu або testportal.autopay.eu).

Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below. За замовчуванням: увімкнено. Вимкніть його, щоб приймати справжні платежі на pay.autopay.eu з робочими обліковими даними.

Service ID (production): числовий ідентифікатор служби з portal.autopay.eu.

Shared key (production): ключ хешування робочої служби. Тримайте його в таємниці.

Service ID (test): числовий ідентифікатор служби з testportal.autopay.eu.

Shared key (test): ключ хешування тестової служби.

Currencies: валюти, які приймає ваша служба Autopay: PLN, EUR, GBP, USD, CZK. Autopay зазвичай відкриває окрему службу для кожної валюти. Спосіб оплати пропонується лише тоді, коли валюта замовлення вибрана тут. За замовчуванням: PLN.

Сповіщення про платежі (ITN) і адреса повернення

Введіть ці адреси в порталі Autopay для вашої служби — для робочого режиму та для тестового. Точні адреси показано в цьому розділі налаштувань.

ITN (transaction notification) URL: https://your-site/?wc-api=wc_ap_payment

Return URL (after payment): https://your-site/?wc-api=wc_ap_return

Без ITN URL замовлення ніколи не позначаються оплаченими. Кожне ITN перевіряється за SHA-256 хешем, створеним з Shared key відповідної служби. Сповіщення без дійсного хешу або з невідомим Service ID відхиляються. Сповіщення застосовується до замовлення, лише якщо платіж для нього було розпочато з тією самою службою Autopay. Сповіщення про платежі, розпочаті до перемикання Test mode, усе одно перевіряються правильним ключем.

Плагін обробляє такі статуси платежів в ITN:

SUCCESS: платіж здійснено; замовлення позначається оплаченим після перевірки суми та валюти.

PENDING: платіж розпочато; додається примітка.

FAILURE: платіж не пройшов; замовлення в статусі Pending payment переходить у статус Failed.

Додатково

Logging: Log payment events записує до WooCommerce > Status > Logs, джерело wcp_autopay_payment. Ключі та дані покупців ніколи не записуються. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Autopay) і оформлює замовлення. Наступна сторінка показує Thank you for your order. You are being redirected to Autopay to complete the payment. і надсилає покупця на платіжну сторінку Autopay. Якщо покупець повертається кнопкою «назад» у браузері, сторінка показує кнопку Pay with Autopay замість повторного перенаправлення.

Плагін передає суму замовлення у валюті замовлення, номер замовлення як опис (Order і номер) та e-mail для рахунку покупця. На сторінці Autopay покупець обирає спосіб оплати і платить.

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

Якщо платіж не вдався, замовлення переходить у статус Failed, і покупець може оплатити його знову з цього замовлення за посиланням Pay. Якщо платіж не вдалося розпочати, покупець бачить коротке повідомлення, наприклад Autopay payments are not configured. Please choose another payment method or contact the store. або повідомлення про те, що Autopay не може приймати платежі в цій валюті.

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

Плагін не здійснює повернення коштів з WooCommerce, не підтримує підписки чи регулярні платежі, не зберігає картки (1-Click), не має поля для коду BLIK чи форми карток на сторінці оформлення замовлення, не дає вибрати банк або платіжний канал на сторінці оформлення замовлення і використовує один Service ID для кожного середовища.

Замовлення

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

Pending payment: покупця надіслано на Autopay, а Autopay ще не підтвердив платіж.

Processing or Completed: Autopay підтвердив платіж. WooCommerce встановлює Processing, а для замовлень лише з віртуальними товарами для завантаження — Completed. Примітка до замовлення показує суму, транзакцію Autopay і дату платежу. ID транзакції — це ID транзакції Autopay (RemoteID).

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

Failed: платіж не пройшов. Покупець може оплатити замовлення знову.

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

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

Повернення коштів з WooCommerce не підтримується. Поверніть платіж у порталі Autopay, а потім зафіксуйте його в WooCommerce як ручне повернення.

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

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

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

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

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

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

Autopay не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, для вибраного середовища заповнені Service ID і Shared key, а валюта магазину вибрана в Currencies. Сторінка налаштувань показує попередження, якщо чогось бракує.

Платіж пройшов, але замовлення залишається Pending payment: Autopay не доставив ITN або магазин його відхилив. Перевірте, що ITN URL з налаштувань задано для служби в порталі Autopay (робочої або тестової), що хеш-функція — SHA-256 і що Shared key у плагіні відповідає службі. Перевірте, що магазин доступний з інтернету. Увімкніть Logging і перегляньте WooCommerce > Status > Logs, джерело wcp_autopay_payment.

Журнал показує ITN rejected: invalid hash: Shared key не відповідає службі або хеш-функція служби не SHA-256.

Журнал показує, що Service ID не налаштовано: сповіщення надійшло від служби, чий Service ID не введено в плагін.

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

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

Після оплати покупець потрапляє на головну сторінку: адресу повернення не вдалося перевірити, наприклад через те, що Service ID не введено в плагін. Статус замовлення це не змінює: він відповідає ITN.

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

Видалення

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

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