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

Вимоги

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

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

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

Обліковий запис Montonio: вам потрібні ключ доступу та секретний ключ вашого магазину з Montonio Partner System. Ключі sandbox і live різні, тож для кожного середовища, яке ви використовуєте, потрібна окрема пара. Більше нічого налаштовувати в Montonio не потрібно: адреса сповіщень надсилається з кожним платежем.

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

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

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

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

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

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

4. У Montonio Partner System відкрийте Stores > your store > API keys і скопіюйте ключ доступу та секретний ключ sandbox. Вставте їх у налаштування і залиште увімкненим Sandbox mode.

5. Увімкніть Enable/Disable, натисніть Save і перевірте платіж у sandbox. Потім введіть ключі live і вимкніть Sandbox mode.

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

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

Усі налаштування розташовані на сторінці модуля: Modules > Module Manager > VibeFox Montonio Payment > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Над полями сторінка попереджає, якщо відсутні ключі поточного середовища (спосіб оплати тоді приховується на етапі оформлення замовлення), якщо валюта магазину не EUR або PLN, і показує Sandbox mode is on: payments are simulated and no real money is charged., поки sandbox увімкнено. Title не може бути порожнім.

Montonio

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

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

Description: текст під способом оплати на етапі оформлення замовлення. За замовчуванням: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

API-ключі

Ключі беруться в Montonio Partner System: Stores > your store > API keys. Ключі sandbox і live різні. Sandbox використовує лише ключі sandbox, режим live — лише ключі live.

Sandbox mode: використовує sandbox Montonio (тестові платежі, без реальних коштів). Перемикаються і адреса API Montonio, і пара ключів. За замовчуванням: увімкнено. Вимикайте лише після введення ключів live. Платежі, зроблені в іншому середовищі, для підтверджень і повернень і далі використовують ключі свого середовища.

Sandbox access key: ключ доступу (UUID) вашого магазину в sandbox Montonio.

Sandbox secret key: секретний ключ вашого магазину в sandbox Montonio.

Live access key: ключ доступу (UUID) вашого магазину в live-середовищі Montonio.

Live secret key: секретний ключ вашого магазину в live-середовищі Montonio.

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

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

Notification URL: адреса, на яку Montonio надсилає сповіщення про платежі. З зрозумілими URL вона має такий вигляд: https://your-shop/module/wcp_montonio_payment/webhook. Вводити її нікуди не потрібно: модуль передає її Montonio з кожним платежем.

Додатково

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

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

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

Сповіщення про платежі

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

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

На етапі оплати покупець обирає спосіб оплати (за замовчуванням Bank payment (Montonio)) і підтверджує вибір. Модуль створює платіж Montonio на суму кошика у валюті кошика і надсилає покупця на сторінку оплати Montonio. Там покупець обирає банк і сплачує. Банки країни платника покупця показуються першими (для кошиків у PLN — Польща). Платіж відображається як Order і номер кошика. Сторінка Montonio відкривається мовою магазину, якщо це німецька, англійська, естонська, фінська, литовська, латвійська, польська або російська; в інших випадках — англійською. У режимі sandbox під описом на етапі оформлення замовлення показується SANDBOX MODE — test payment, no real money is charged. На цьому етапі замовлення ще не існує.

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

Якщо Montonio повідомляє, що платіж ще в очікуванні, коли покупець повертається, відкривається сторінка Payment confirmation з тим самим текстом і кнопкою Check again. Кнопка запитує в Montonio поточний статус платежу. Сповіщення створює замовлення, щойно воно надходить.

Якщо платіж скасовано або відхилено, покупець повертається до оформлення замовлення з одним із повідомлень: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. або Montonio could not complete the payment. Please try again or choose another payment method. Кошик зберігається. Перед створенням нового платежу модуль запитує в Montonio про попередній. Якщо він уже оплачений, замовлення створюється і другий платіж не виконується.

Якщо Montonio не може розпочати платіж, покупець залишається на оформленні замовлення з коротким повідомленням, наприклад Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method. Технічна причина записується в журнал.

Модуль приймає лише банківські платежі (ініціювання платежу). Він не підтримує оплату картками, BLIK, Apple Pay чи Google Pay, Pay Later або фінансування, доставку Montonio, підписки, збережені способи оплати та вибір банку на вашому сайті.

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

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

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

Payment accepted: Montonio підтвердив платіж (PAID) з точною сумою та валютою кошика. Платіж записується з UUID замовлення Montonio як ID транзакції, а примітка показує банк, UUID, суму та середовище.

Montonio payment on hold: банк ще не підтвердив платіж (AUTHORIZED); замовлення стає Payment accepted, коли Montonio повідомляє PAID. Замовлення також переводиться на утримання, якщо Montonio повідомив суму або валюту, відмінні від суми кошика, якщо платіж sandbox надійшов, коли магазин працює в режимі live (платіж не записується, бо кошти не отримано), або якщо платіж надійшов після скасування замовлення. Примітка пояснює причину. Перевірте платіж у Montonio Partner System і виконайте замовлення або поверніть платіж.

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

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

Оплачені, скасовані чи повернені замовлення ніколи не відкриваються знову через наступні сповіщення. Якщо для вже оплаченого замовлення надходить другий платіж, замовлення не змінюється. Примітка просить повернути другий платіж у Montonio Partner System.

Блок Montonio payment

На сторінці замовлення показано блок Montonio payment з UUID замовлення Montonio, середовищем (з позначкою Sandbox для тестових платежів), банком, статусом платежу, сплаченою та поверненою сумою, історією повернень і Montonio notes замовлення.

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

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

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

Модуль не створює кредитних накладних. Стандартні кнопки повернення PrestaShop на сторінці замовлення не повертають гроші через Montonio. Повернення, зроблені в Montonio Partner System, додаються до приміток, коли Montonio їх повідомляє. Статус замовлення та кредитні накладні автоматично не змінюються. За потреби оновіть їх вручну.

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

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

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

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

Вирішення проблем

Montonio не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено, задано обидва ключі поточного середовища (Sandbox access key і Sandbox secret key у режимі sandbox, Live access key і Live secret key у режимі live) і що валюта кошика EUR або PLN. Сторінка налаштувань показує попередження, якщо ключі відсутні або валюта магазину не підтримується. У Payment > Preferences перевірте, чи дозволено модуль для валюти кошика, країни покупця та групи покупця.

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

Сповіщення відповідає Invalid token: підпис, термін дії або ключ доступу токена не збіглися. Перевірте, що ключ доступу та секретний ключ скопійовано правильно і вони належать до потрібного середовища, а також що час на сервері правильний. Токен, підписаний ключем іншого середовища, також відхиляється.

Сповіщення відповідає Payment does not belong to this order: платіж створено не цим магазином для цього кошика. Так буває, коли два магазини використовують один обліковий запис Montonio і ті самі номери кошиків.

Сповіщення відповідає Gateway not configured: ключі Montonio не задані або відсутні ключі середовища платежу. Введіть ключі; Montonio повторить сповіщення.

Сповіщення відповідає Temporarily unavailable: кошик у той самий момент підтверджував інший запит, або замовлення не вдалося створити (наприклад, модуль вимкнено). Montonio повторить сповіщення. Причину дивіться в полі Log.

Покупець бачить помилку під час вибору Montonio: перегляньте поле Log на сторінці модуля. This payment method is temporarily unavailable. Please choose another payment method. зазвичай означає неправильні або відсутні ключі. Montonio could not start the payment. Please check your order details or choose another payment method. означає, що Montonio відхилив дані платежу; причина записана в журнал.

Замовлення після оплати в статусі Montonio payment on hold: прочитайте примітки в блоці Montonio payment (див. Статуси замовлення), потім виконайте замовлення або поверніть платіж.

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

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

Для розробників модуль пропонує хуки actionWcpMontonioSupportedCurrencies, actionWcpMontonioOrderData і actionWcpMontonioLocale для зміни підтримуваних валют, даних платежу та мови сторінки Montonio.

Видалення

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

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