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

Вимоги

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

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

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

Валюта магазину: EUR. Paytrail приймає тільки євро. Для будь-якої іншої валюти спосіб оплати приховується під час оформлення замовлення. Суми надсилаються в центах.

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

Обліковий запис Paytrail: вам потрібні ваші Merchant ID та Secret key, які відображаються в панелі Paytrail Merchant Panel (реквізити облікового запису або інтеграції). Для тестування обліковий запис не потрібен: тестовий режим використовує загальнодоступний тестовий рахунок Paytrail. Самі способи оплати активуються у вашому обліковому записі Paytrail.

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

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

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

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

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

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

5. Щоб спочатку протестувати плагін, увімкніть Test mode. Для реальних платежів зніміть прапорець і введіть ваші Merchant ID та Secret key. У Paytrail не потрібно налаштовувати URL-адресу зворотного виклику.

6. Увімкніть Enable/Disable і збережіть зміни.

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

Усі налаштування зібрані на одній сторінці: WooCommerce > Settings > Payments > Paytrail. Над полями сторінка відображає Test mode is active., поки активний тестовий режим. У робочому режимі плагін попереджає, якщо відсутні Merchant ID або Secret key, а також якщо валюта магазину не є EUR. В обох випадках Paytrail не відображається під час оформлення замовлення. У списку способів оплати Paytrail позначається як такий, що потребує налаштування, поки в робочому режимі немає облікових даних.

Під час збереження значення Merchant ID, яке містить будь-що, крім цифр, не зберігається: виводиться помилка і зберігається попереднє значення.

General

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

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

Description: текст, який відображається покупцям під час оформлення замовлення. За замовчуванням: Pay securely with Finnish online banking, card, mobile payment or invoice on the Paytrail payment page.

API credentials

Ваші Merchant ID та Secret key відображаються в панелі Paytrail Merchant Panel (реквізити облікового запису або інтеграції). Підтримуються платежі лише в EUR.

Test mode: Use the Paytrail test account. Нові платежі використовують загальнодоступний тестовий обліковий запис Paytrail (Merchant ID 375917) замість ваших власних облікових даних. Реальні гроші не списуються. Покупці бачать Test mode: no real payment will be made. під час оформлення замовлення. Secret key тестового рахунку є публічним, тому будь-хто міг би симулювати платіж для замовлення, створеного в тестовому режимі. Ніколи не залишайте тестовий режим увімкненим у робочому магазині. За замовчуванням: вимкнено.

Merchant ID: ваш Paytrail Merchant ID (лише цифри). Використовується, коли тестовий режим вимкнено.

Secret key: ваш Paytrail Secret key. Використовується, коли тестовий режим вимкнено.

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

Orders

У цьому розділі відображається URL-адреса зворотного виклику, яка виглядає як https://your-site/wc-api/ptg_paytrail/. Paytrail підтверджує кожен платіж між серверами за цією адресою. Вона надсилається з кожним платежем, тому в панелі Paytrail нічого не потрібно налаштовувати, однак сайт має бути доступний з інтернету.

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

Advanced

Debug log: Log API requests and callbacks. Записується у WooCommerce > Status > Logs, джерело wcp_paytrail_gateway, без персональних даних або ключів. Помилки записуються завжди. За замовчуванням: вимкнено.

Delete data on uninstall: Delete settings, logs and Paytrail order data when the plugin is deleted. Деактивація плагіна ніколи нічого не видаляє. Без даних про транзакції Paytrail повернення коштів за старими замовленнями з WooCommerce стане неможливим. За замовчуванням: вимкнено.

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

Покупець вибирає спосіб оплати (за замовчуванням Paytrail) та оформлює замовлення. Плагін створює платіж Paytrail на загальну суму замовлення в євро та передає разом із ним рядки замовлення: товари, доставку та збори, кожен зі своєю ставкою ПДВ з точністю до одного десяткового знака. Рядки завжди в сумі дають повну суму платежу; різниця округлення включається в один із рядків або надсилається окремим рядком Rounding. Адреси платника та доставки надсилаються, лише якщо вони заповнені повністю, а задовгі значення скорочуються до лімітів Paytrail. Мова сторінки оплати — фінська, шведська або англійська відповідно до локалі магазину.

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

Після успішного платежу покупець бачить сторінку отриманого замовлення. Після скасованого або невдалого платежу покупець переходить на сторінку Pay for order із повідомленням The Paytrail payment was cancelled or failed. You can try again or choose another payment method. Якщо платіж ще не завершено, повідомлення буде The Paytrail payment has not been completed yet. You can try again or choose another payment method.

Якщо Paytrail не може запустити платіж, покупець бачить коротке повідомлення, наприклад Could not connect to Paytrail. Please try again in a moment., Paytrail is temporarily unavailable. Please choose another payment method. (неправильні облікові дані) або Paytrail could not start the payment. Please check your billing details and try again, or choose another payment method. Технічна причина додається до приміток замовлення та до журналу. Замовлення на суму, що перевищує максимальний ліміт Paytrail, не можуть бути оплачені через Paytrail.

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

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

Покупець вибирає спосіб оплати на сторінці Paytrail, а не під час оформлення замовлення у вашому магазині. Плагін не має токенізації карток чи збережених карток, не підтримує WooCommerce Subscriptions, модель shop-in-shop, ручну активацію рахунків-фактур та звіти про взаєморозрахунки.

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

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

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

Processing or Completed: платіж підтверджено. Статус визначається налаштуванням Order status after payment. Примітка до замовлення показує транзакцію, спосіб оплати, використаний у Paytrail, та суму. ID транзакції є ідентифікатором транзакції Paytrail.

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

Failed: остання спроба оплати не вдалася або була скасована покупцем. Покупець може спробувати оплатити знову.

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

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

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via Paytrail (на кнопці відображається ваш Title). Підтримуються повні та часткові повернення, лише на суму (без повернення окремих товарних позицій). Кнопка доступна лише для замовлень із підтвердженим платежем Paytrail. Повернення коштів використовує облікові дані того режиму, у якому було здійснено платіж, тому для реального платежу мають бути налаштовані робочі облікові дані.

Якщо спосіб оплати не підтримує прямі повернення, плагін автоматично запускає повернення електронною поштою: Paytrail надсилає покупцеві листа з проханням ввести банківський рахунок. Для цього в замовленні має бути вказана адреса електронної пошти платника. У примітці до замовлення вказується, який саме вид повернення було розпочато.

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

Повернення коштів, здійснені в панелі продавця Paytrail, не синхронізуються назад із WooCommerce.

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

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

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

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

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

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

Paytrail не з'являється під час оформлення замовлення: переконайтеся, що ліцензія активна, опцію Enable/Disable увімкнено і або активний Test mode, або заповнені Merchant ID та Secret key. Перевірте, що валюта магазину (або валюта замовлення на сторінці Pay for order) — EUR. Сторінка налаштувань відображає попередження для кожної з цих проблем.

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

Зворотний виклик або повернення відповідає Payment verification failed.: підпис є недійсним або платіж не належить до спроби оплати цього замовлення. Замовлення не змінюється. Переконайтеся, що Secret key є правильним і відповідає зазначеному Merchant ID.

Платіж не створюється: у примітці до замовлення та в журналі відображається помилка Paytrail, наприклад Paytrail API error (401): … у разі неправильних облікових даних. Увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело wcp_paytrail_gateway.

Merchant ID не зберігається: він повинен містити лише цифри. Скопіюйте його знову з панелі Paytrail Merchant Panel.

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

Повернення коштів не вдається: прочитайте повідомлення. This order has no confirmed Paytrail payment. Refund it manually. означає відсутність підтвердженого платежу Paytrail для повернення. Повідомлення про відсутність робочих облікових даних означає, що платіж було здійснено в робочому режимі, а робочі облікові дані не налаштовані. Якщо спосіб оплати підтримує лише повернення електронною поштою, для замовлення потрібна адреса електронної пошти платника.

Хуки для розробників: фільтр ptg_payment_request змінює запит на створення платежу перед тим, як він буде підписаний і надісланий; фільтр ptg_icon змінює іконку під час оформлення замовлення.

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

Видалення

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

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