VibeFox Paysera for PrestaShop — Допомога

Вимоги

PrestaShop: 8.0–9.x.

PHP: 8.0 або новіший. Модуль не встановлюється на старіших версіях PHP.

Проєкт Paysera: потрібні ідентифікатор проєкту та пароль проєкту (sign key) вашого проєкту Paysera. Способи оплати, які бачить покупець, — це способи, увімкнені в цьому проєкті. Для callback-повідомлення в Paysera нічого налаштовувати не потрібно: його URL передається з кожним запитом на оплату.

Доступний магазин: замовлення створює callback-повідомлення Paysera, тож ваш магазин має бути доступним з інтернету, а не за логіном, базовою автентифікацією чи файрволом. Callback-повідомлення працює, навіть коли магазин перебуває в режимі обслуговування.

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

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

1. В адмін-панелі перейдіть до Modules > Module Manager і натисніть Upload a module. Оберіть ZIP-файл модуля.

2. Коли завантаження завершиться, натисніть Configure або пізніше знайдіть VibeFox Paysera Payment у списку модулів і натисніть Configure.

3. Вставте ліцензійний ключ VibeFox у License key у блоці ліцензії вгорі сторінки Configure і натисніть Activate (див. Ліцензійний ключ).

4. Введіть Project ID і Project password з вашого облікового запису Paysera (див. розділ «Налаштування»).

5. За бажанням: увімкніть Allow test payments у проєкті Paysera і Test payments у модулі, щоб спробувати процес без списання коштів. Вимкніть їх перед початком продажів.

6. Увімкніть Enable/Disable і натисніть Save.

Під час встановлення модуль створює два статуси замовлення: Awaiting Paysera payment і Paysera payment on hold. PrestaShop додає новий платіжний модуль для всіх валют, країн і груп клієнтів. Обмежити їх можна в Payment > Preferences.

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

Усі налаштування розміщені на сторінці модуля: Modules > Module Manager > VibeFox Paysera Payment > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Над полями сторінка показує Paysera is hidden at checkout until the project ID and the project password are entered., доки одне з них не заповнено, і Test mode is on: customers are not charged. Turn off "Test payments" and select "Production" before accepting real orders., поки ввімкнено тестові платежі або пісочницю.

Paysera

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

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

Description: текст, що відображається під способом оплати під час оформлення замовлення. За замовчуванням: Pay securely via Paysera.

Проєкт Paysera

Ідентифікатор проєкту та пароль проєкту знаходяться у вашому обліковому записі Paysera в розділі Projects and activities: оберіть ваш проєкт і відкрийте General project settings.

Callback URL: адреса, за якою Paysera підтверджує кожен платіж. Якщо увімкнено зрозумілі URL, вона має такий вигляд: https://your-shop/module/wcp_paysera_payment/callback, можливо, з кодом мови. Вона передається з кожним платежем автоматично, тож у Paysera нічого налаштовувати не потрібно, але адреса має бути доступною з інтернету. Замовлення створюються лише цими підписаними callback-повідомленнями.

Project ID: числовий ідентифікатор вашого проєкту Paysera. Приймаються лише цифри: будь-яке інше значення виводить помилку Project ID must be a number: the numeric ID of your Paysera project., і нічого не зберігається.

Project password: пароль проєкту (sign key). Він підписує запити на оплату і перевіряє callback-повідомлення Paysera. Збережений пароль більше не показується. Поле залишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити.

Clear saved password: позначте Project password і натисніть Save, щоб видалити збережений пароль. Порожнє поле зберігає попереднє значення.

Тестування

Test payments: надсилає платежі в тестовому режимі, тож кошти не списуються. Paysera повертає успішний тестовий платіж, не списуючи кошти з покупця. Спочатку увімкніть Allow test payments у налаштуваннях проєкту Paysera. Поки цю опцію увімкнено, тестові платежі позначають замовлення як оплачені; коли її вимкнено, тестовий платіж переводить замовлення в очікування. За замовчуванням: off. Поки опцію увімкнено, покупці бачать під способом оплати напис TEST MODE — no money will be charged.

Environment: куди надсилається покупець. Для звичайного проєкту Paysera, зокрема для тестових платежів, залишайте Production. За замовчуванням: Production.

Додатково

Debug log: записує події платежів у logs/wc_psr_debug.log.php у папці модуля. Файл не можна відкрити з веб-браузера. Помилки та попередження записуються завжди, решта кроків — лише поки ця опція увімкнена. Паролі та дані покупців ніколи не записуються. За замовчуванням: off.

Log: показує розмір журналу та його останні записи. Натисніть Clear log, щоб його очистити.

Delete data: якщо увімкнено, при видаленні модуля видаляються його налаштування та журнал. Дані замовлень (замовлення, записи платежів Paysera, статуси замовлень) завжди зберігаються. За замовчуванням: off.

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

На етапі оплати покупець обирає спосіб оплати (за замовчуванням Paysera) і підтверджує замовлення. Модуль формує підписаний запит на оплату із сумою кошика в мінімальних одиницях валюти кошика, ім’ям, e-mail і платіжною адресою покупця, а також мовою сторінки магазину (литовська, латвійська, естонська, російська, німецька, польська, інакше англійська). Покупець переходить до платіжного вікна Paysera і вибирає там банк, картку або інший спосіб. На цьому етапі замовлення ще не існує.

Paysera підтверджує платіж серверним callback-повідомленням. Замовлення позначається оплаченим лише після підтвердження Paysera підписаним callback-повідомленням; повернення покупця до магазину ніколи не створює і не оплачує замовлення. Коли покупець повертається після callback-повідомлення, показується стандартна сторінка підтвердження замовлення. Якщо банк прийняв платіжне доручення, але ще не виконав його, замовлення створюється у статусі Awaiting Paysera payment, а сторінка показує Paysera is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Для замовлення на утриманні сторінка показує Your payment is being reviewed. We will contact you if anything else is needed.

Якщо покупець повертається до callback-повідомлення, сторінка Payment confirmation пояснює, що замовлення буде створено, щойно Paysera підтвердить платіж, і пропонує Check again та Back to checkout.

Якщо покупець скасовує платіж у вікні Paysera, він повертається до оформлення замовлення з повідомленням The Paysera payment was cancelled. You can try again or choose another payment method. Якщо Paysera повідомляє, що платіж не було виконано, виводиться The payment was not completed. You can try again or choose another payment method. Кошик зберігається в обох випадках. Якщо в кошика вже є замовлення, нова спроба одразу веде на сторінку підтвердження замовлення, а не на другий платіж.

Якщо платіж не вдається розпочати, покупець залишається на оформленні замовлення з повідомленням Paysera payments are temporarily unavailable. Please choose another payment method. або, для некоректної суми замовлення, з This order cannot be paid via Paysera. Причина записується в журнал.

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

Модуль не підтримує повернення коштів з адмін-панелі, вибір банку чи способу оплати на сторінці оформлення замовлення, підписки, збережені картки та служби доставки або кур’єрські служби Paysera.

Замовлення

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

No order yet: покупця перенаправлено до Paysera, а callback-повідомлення ще не надійшло, або покупець скасував платіж. Існує лише кошик.

Payment accepted: Paysera підтвердила платіж із відповідними сумою та валютою. Платіж записується з ідентифікатором запиту Paysera як ID транзакції, а примітка показує запит і спосіб оплати; для тестових платежів додається позначка (TEST — no money charged).

Awaiting Paysera payment: Paysera прийняла платіжне доручення, але банк його ще не виконав. Замовлення переходить у Payment accepted, коли Paysera підтверджує платіж.

Paysera payment on hold: платіж потребує ручної перевірки. Сплачена сума або валюта відрізняється від кошика чи суми замовлення; TEST-платіж надійшов, коли Test payments було вимкнено (кошти не списувалися); або платіж підтверджено після того, як покупець його скасував. Платіж не записується. Примітка пояснює причину, а блок Paysera просить вас перевірити платіж у вашому обліковому записі Paysera, а потім перевести замовлення в Payment accepted або скасувати його та повернути платіж через Paysera.

Cancelled: платіж, підтверджений пізніше для скасованого замовлення, не змінює його статус. Примітка пропонує відновити замовлення (перевести в Payment accepted) або повернути платіж через Paysera. Пізніший TEST-платіж або невідповідність суми для скасованого замовлення також додає лише примітку.

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

Блок платежу Paysera

На сторінці замовлення показано блок Paysera payment з ідентифікатором замовлення Paysera (номер кошика та спроба), ідентифікатором запиту Paysera, середовищем і позначкою TEST payment, статусом платежу, запитаною та сплаченою сумами, способом оплати та примітками модуля.

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

Повернення коштів з адмін-панелі не підтримуються: протокол платіжного вікна Paysera не має API для повернень. Оформлюйте повернення у вашому обліковому записі Paysera. Коли Paysera повідомляє про повернення, до замовлення додається примітка з поверненою сумою, а статус замовлення не змінюється. За потреби зафіксуйте повернення в PrestaShop вручну.

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

Модуль працює з ліцензійним ключем VibeFox з сайту vibefox.net. Блок ліцензії License — VibeFox Paysera Payment є першим блоком на сторінці Modules > Module Manager > VibeFox Paysera Payment > Configure, над налаштуваннями. Вставте ключ у License key і натисніть Activate. Після цього блок показує ключ у прихованому вигляді, статус (наприклад, дату, до якої активна ліцензія, і ваш домен) та кнопки Check now, щоб перевірити статус ще раз, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ з цього магазину. Нижче них є рядок Product: presta-payment-paysera і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише співробітники з правом Configure для модуля. Тексти блоку відповідають мові адмін-панелі (включено англійську та російську).

Якщо ключ не прийнято, блок пояснює причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on і дату. Після зміни адреси магазину або після звільнення місця для домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, модуль продовжує працювати за останнім відомим статусом.

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

Без активного ключа Paysera не показується покупцям під час оформлення замовлення. Якщо оплату все ж розпочато, покупець бачить This payment method is not available. Please choose another one. Вітрина магазину не знає, що ви увійшли в адмін-панель, тож спосіб оплати приховується і для вас: ви можете налаштувати модуль до купівлі ключа, але не можете протестувати його під час оформлення замовлення. Нагадування з’являється в Modules > Module Manager на вкладці Alerts. Наявні замовлення не змінюються: платежі, які вже розпочато, як і раніше підтверджуються callback-повідомленням.

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

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

Paysera не з’являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, і введено Project ID та Project password. Сторінка налаштувань показує попередження, доки чогось із цього не вистачає. У Payment > Preferences перевірте, що модуль дозволено для валюти кошика, країни покупця та групи покупця.

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

Callback відповідає Invalid signature: Project password не збігається з проєктом, або callback-повідомлення надійшло не від Paysera. Скопіюйте пароль проєкту ще раз. Якщо ви змінили проєкт або пароль, платежі, розпочаті до зміни, більше не можна перевірити.

Callback відповідає Project ID mismatch: Project ID у налаштуваннях відрізняється від проєкту, який здійснив платіж.

Callback відповідає Order not found: кошик у callback-повідомленні не має платежу Paysera в цьому магазині, наприклад тому, що платіж було розпочато в іншому магазині з тим самим проєктом.

Callback відповідає Gateway not configured, Busy або Temporary error: ідентифікатор або пароль проєкту порожній, інше callback-повідомлення для того самого кошика ще виконується, або замовлення не вдалося створити (наприклад, модуль вимкнено). Paysera повторює callback-повідомлення. Увімкніть Debug log, щоб побачити причину.

Paysera відхиляє платіжне вікно або повідомляє, що проєкт не існує: перевірте Environment. Звичайний проєкт Paysera працює лише з Production; Sandbox потребує проєкту, створеного в пісочниці Paysera.

Тестовий платіж не оплачує замовлення: TEST-платіж оплачує замовлення, лише поки Test payments увімкнено. Інакше замовлення переводиться в очікування з приміткою, що кошти не списано. Також увімкніть Allow test payments у проєкті Paysera.

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

Покупець бачить Paysera payments are temporarily unavailable: перегляньте поле Log. Ідентифікатор або пароль проєкту може бути порожнім, або одна з адрес магазину, переданих у Paysera, довша за 255 символів.

Видалення

Перейдіть до Modules > Module Manager, відкрийте меню поруч із VibeFox Paysera Payment і виберіть Uninstall. Ліцензійний ключ і статус ліцензії цього модуля завжди видаляються. Якщо Delete data увімкнено, налаштування модуля та журнал видаляються. Якщо вимкнено, усі налаштування зберігаються для повторного встановлення. Записи платежів Paysera та статуси замовлень Awaiting Paysera payment і Paysera payment on hold завжди зберігаються. Наявні замовлення зберігають свої примітки про платежі та ідентифікатори транзакцій.

Paysera є торговельною маркою її власника. Цей модуль не пов’язаний із Paysera і не схвалений нею.