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

Вимоги

PrestaShop: від 8.0 до 9.x.

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

Валюта: валюта кошика має бути однією з тих, які приймає MultiSafepay, наприклад EUR, USD, GBP, PLN, CHF, SEK, DKK або NOK. Для інших валют спосіб оплати під час оформлення замовлення не показується.

Обліковий запис MultiSafepay: потрібен API-ключ вашого сайту в MultiSafepay Control. Тестовий і робочий облікові записи мають різні ключі. Більше нічого налаштовувати в MultiSafepay не потрібно: адреса сповіщень надсилається з кожним платежем.

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

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

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

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

2. Після завершення завантаження натисніть Configure або пізніше знайдіть VibeFox MultiSafepay Gateway у списку модулів і натисніть Configure.

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

4. Вставте тестовий та/або робочий API-ключ із MultiSafepay Control (див. Налаштування).

5. Увімкніть Enable/Disable і натисніть Save. Перевірте оплату з увімкненим Test mode, потім вимкніть його, щоб приймати справжні платежі.

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

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

Усі налаштування розташовані на сторінці модуля: Modules > Module Manager > VibeFox MultiSafepay Gateway > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Над полями сторінка показує Test mode: new payments use the MultiSafepay test environment (no real payments)., поки увімкнено тестовий режим. Вона попереджає, якщо для поточного режиму немає API-ключа (тоді спосіб оплати не показується під час оформлення замовлення), і якщо MultiSafepay не приймає валюту за замовчуванням вашого магазину. Сторінка не зберігається без Title.

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

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

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

Description: текст під способом оплати під час оформлення замовлення. За замовчуванням: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

API-ключі

API-ключ знаходиться в MultiSafepay Control > Manage settings > Website settings. Розділ містить посилання на тестовий обліковий запис (testmerchant.multisafepay.com) і робочий (merchant.multisafepay.com). Ключі в них різні. Тестовий режим використовує лише тестовий ключ, робочий — лише робочий ключ.

Test mode: Use the MultiSafepay test environment (no real payments). Перемикає і адресу API, і API-ключ. Платежі, які вже були здійснені, для перевірки статусу та повернень і далі використовують середовище, в якому були створені. За замовчуванням: увімкнено. Поки режим увімкнено, покупці бачать під способом оплати Test mode: no real payment will be made.

Test API key: API-ключ вашого тестового облікового запису MultiSafepay.

Live API key: API-ключ вашого робочого облікового запису MultiSafepay.

Збережені ключі більше не відображаються. Поле залишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити.

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

Сповіщення

Нічого налаштовувати не потрібно. Поле Notification URL показує адресу, яка надсилається в MultiSafepay з кожним платежем. Із зрозумілими URL вона виглядає так: https://your-shop/module/wcp_multisafepay_gateway/webhook, можливо з кодом мови, наприклад /en/. Сповіщення лише повідомляє модулю, який платіж змінився: статус, сума і валюта завжди зчитуються через API MultiSafepay з вашим API-ключем до створення або зміни замовлення. Сповіщення про платежі, які не були розпочаті у вашому магазині, ігноруються. Сповіщення працює, поки магазин у режимі обслуговування, і не блокується обмеженням за країною для вашого магазину.

Замовлення

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

Додатково

Debug log: Log API calls and notifications записує в logs/mspg_debug.log.php у папці модуля. Файл не можна відкрити з веб-браузера. Помилки та попередження записуються завжди. API-ключі та дані клієнтів ніколи не записуються. За замовчуванням: вимкнено.

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

Delete data on uninstall: якщо увімкнено, під час видалення модуля видаляються налаштування й журнал. Платіжні дані MultiSafepay за замовленнями та статус замовлення завжди зберігаються, тож повернення коштів за старими замовленнями залишаються можливими. Вимкнення модуля нічого не видаляє. За замовчуванням: вимкнено.

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

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

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після підтвердження MultiSafepay: сповіщенням або перевіркою через API MultiSafepay, коли покупець повертається. Тоді замовлення створюється, і покупець бачить стандартну сторінку підтвердження замовлення з повідомленням Your payment with MultiSafepay has been received. Для замовлення на утриманні сторінка показує We are confirming your payment with MultiSafepay. The order will be updated automatically — please do not pay again. Якщо платіж згодом не вдався, сторінка показує Your MultiSafepay payment was not completed. Please contact us about this order. Якщо MultiSafepay ще не підтвердив платіж, коли покупець повертається (наприклад, очікується банківський переказ), сторінка Payment confirmation показує той самий текст підтвердження і кнопку Check again. Сповіщення створить замовлення, щойно MultiSafepay повідомить про платіж.

Якщо покупець скасовує оплату на сторінці MultiSafepay, або платіж відхилено чи він прострочений, покупець повертається до оформлення замовлення зі збереженим кошиком і одним із таких повідомлень: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. або The payment session has expired. Please try again.

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

Якщо MultiSafepay не може розпочати платіж, покупець залишається в оформленні замовлення з коротким повідомленням, наприклад Could not connect to MultiSafepay. Please try again in a moment. або MultiSafepay cannot accept this order amount or currency. Please choose another payment method. Технічна причина записується в журнал.

Модуль пропонує один спосіб оплати, який веде на сторінку MultiSafepay. Немає окремих способів оплати PrestaShop для кожного методу MultiSafepay, немає вбудованих полів картки, кнопок експрес-оплати Apple Pay чи Google Pay, підписок, періодичних платежів чи збережених карток, а також неможливо захопити чи анулювати кошти з PrestaShop. Дані кошика не передаються, тож способи оплати з відстроченням, яким вони потрібні (наприклад, Klarna, in3 або Riverty), для цих замовлень MultiSafepay не пропонує.

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

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

Замовлення ще немає: покупця було відправлено до MultiSafepay, і він не сплатив, або MultiSafepay ще не підтвердив платіж. Існує лише кошик.

Payment accepted або Delivered: MultiSafepay підтвердив платіж (завершений або відправлений). Статус відповідає Order status after payment. Платіж записується з ID замовлення MultiSafepay як ID транзакції, а примітка показує платіж, спосіб оплати і середовище.

MultiSafepay payment on hold before payment: платіж ще не остаточно проведений (його перевіряє MultiSafepay) або зарезервований (авторизований). Щоб отримати кошти, спишіть зарезервований платіж у MultiSafepay Control. Замовлення автоматично переходить в оплачений статус, коли MultiSafepay повідомляє, що платіж завершено.

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

MultiSafepay payment on hold after a chargeback: MultiSafepay повідомив про чарджбек за оплачене замовлення: кошти було стягнуто з вашого рахунку.

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

Refunded: платіж повністю повернуто через модуль.

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

Блок оплати MultiSafepay

На сторінці замовлення відображається блок MultiSafepay payment з ID замовлення MultiSafepay, способом оплати, статусом, сумою оплати та повернення, позначкою Test mode для тестових платежів, історією повернень і MultiSafepay notes замовлення.

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

У блоці MultiSafepay payment введіть суму (підставляється сума, яку ще не повернуто), за бажанням причину і натисніть Refund via MultiSafepay. Підтвердіть запитання Refund this amount through MultiSafepay? This cannot be undone. Підтримуються повні та часткові повернення. Потрібне право редагувати замовлення; доступ до сторінок модулів не потрібен. Повернення здійснюються в тій сумі та валюті, які MultiSafepay стягнув, тож після розбіжності суми можна повернути лише до суми, фактично сплаченої покупцем, а не до суми замовлення. Повернення надсилається в середовище, в якому було здійснено платіж (тестове або робоче), тому API-ключ цього середовища має бути заданий. Якщо MultiSafepay не приймає повернення, блок показує MultiSafepay refund failed: з помилкою MultiSafepay, і повернення не фіксується. Успішне повернення додається до історії повернень і приміток з ID повернення MultiSafepay. Повне повернення переводить замовлення в статус Refunded. Часткове повернення статус не змінює. Повернення доступні, щойно MultiSafepay повідомив про платіж.

Модуль не створює кредитових нот. Стандартні кнопки повернення PrestaShop на сторінці замовлення не повертають гроші через MultiSafepay.

Повернення, зроблені в MultiSafepay Control, додаються до приміток, коли MultiSafepay про них повідомляє. Статус замовлення та кредитові ноти автоматично не змінюються. За потреби оновіть їх вручну.

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

Модуль працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox MultiSafepay Gateway є першим блоком на сторінці Modules > Module Manager > VibeFox MultiSafepay Gateway > Configure, над налаштуваннями. Введіть ключ у поле License key і натисніть Activate. Після цього блок показує ключ у замаскованому вигляді, статус (наприклад, дату, до якої дійсна ліцензія, і ваш домен), а також кнопки Check now, щоб перевірити статус ще раз, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ із цього магазину. Нижче розташовані рядок Product: presta-payment-multisafepay і посилання 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.

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

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

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

MultiSafepay не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, для поточного режиму є API-ключ (Test API key у тестовому режимі, Live API key у робочому режимі) і валюту кошика приймає MultiSafepay. Сторінка налаштувань показує попередження, якщо ключ відсутній або валюту магазину не приймають. У Payment > Preferences перевірте, чи дозволено модуль для валюти кошика, країни покупця та групи покупця.

Платіж пройшов, але замовлення не створено: сповіщення не дійшло до вашого магазину. Перевірте, що магазин доступний з інтернету і що задано API-ключ середовища платежу, бо модуль зчитує статус через API MultiSafepay. Якщо API недоступний або ключа немає, сповіщення відповідає ERROR, і MultiSafepay повторює його. Замовлення також створюється, коли покупець повертається до магазину і коли намагається знову сплатити той самий кошик.

Сповіщення відповідає Invalid request: у запиті не було коректного ID транзакції. Сповіщення від MultiSafepay завжди його містять.

Покупець бачить помилку під час вибору MultiSafepay: увімкніть Debug log і перегляньте поле Log на сторінці модуля. This payment method is temporarily unavailable. Please choose another payment method. зазвичай означає неправильний або відсутній API-ключ. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. означає, що MultiSafepay відхилив суму або валюту.

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

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

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

Видалення

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

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