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

Вимоги

PrestaShop: 8.0–9.x.

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

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

Обліковий запис MakeCommerce: потрібні Shop ID та Secret key з Merchant Portal MakeCommerce (Settings > API). Тестове та робоче середовища мають окремі облікові записи та ключі. Доступні способи оплати та валюти визначаються вашим договором з MakeCommerce. Валюти з трьома десятковими знаками, наприклад KWD або BHD, не пропонуються.

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

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

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

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

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

4. Введіть Shop ID та Secret key тестового середовища і, для реальних платежів, робочі ключі (див. Налаштування). У Merchant Portal нічого налаштовувати не потрібно.

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

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

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

Усі налаштування розташовані на сторінці модуля: Modules > Module Manager > VibeFox MakeCommerce Payment > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Над полями сторінка показує Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged., поки тестовий режим увімкнено. Вона попереджає, коли метод увімкнено, але Shop ID або Secret key поточного середовища порожні, а також коли MakeCommerce не може прийняти оплату у валюті за замовчуванням для магазину. В обох випадках метод приховується в оформленні замовлення. Під час збереження пробіли з ключів видаляються.

MakeCommerce

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

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

Description: текст, що відображається під способом оплати в оформленні замовлення. За замовчуванням: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

Обліковий запис MakeCommerce

Shop ID та Secret key знаходяться в Merchant Portal MakeCommerce у розділі Settings > API. Тестовий і робочий портали мають окремі облікові записи та ключі. У розділі є посилання на обидва портали та на сторінку реєстрації MakeCommerce.

Test mode: використовує тестове середовище MakeCommerce (реальні кошти не списуються). Нові платежі створюються у вибраному середовищі з його ключами. Кожне замовлення пам'ятає середовище, в якому його сплачено: перевірки статусу та повернення завжди йдуть туди. Поки режим увімкнено, покупці бачать під способом оплати TEST MODE — MakeCommerce test environment, no real money is charged. За замовчуванням: увімкнено.

Test Shop ID: Shop ID вашого тестового облікового запису у форматі xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Test Secret key: Secret key вашого тестового облікового запису.

Live Shop ID: Shop ID вашого робочого облікового запису.

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

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

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

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

У Merchant Portal нічого налаштовувати не потрібно. Callback URLs показує для довідки адресу повернення або скасування для покупця та адресу для сповіщень про платежі. Кожна транзакція передає власні URL-адреси повернення, скасування та сповіщення, сформовані на основі цих адрес із номером кошика та доданим ключем. MakeCommerce надсилає підписане повідомлення на URL сповіщень (сервер — сервер), а через браузер покупця — на URL повернення або скасування. Підпис перевіряється за Secret key того середовища, в якому створено транзакцію. Повідомлення без дійсного підпису відхиляються.

Модуль обробляє такі статуси транзакцій MakeCommerce:

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

Додатково

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

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

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

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

На етапі оплати покупець обирає спосіб оплати (за замовчуванням Bank link or card (MakeCommerce)) і підтверджує вибір. Модуль створює транзакцію MakeCommerce на суму кошика у валюті кошика і надсилає покупця на платіжну сторінку MakeCommerce. Там покупець обирає банківське посилання або картку. Електронна пошта та країна покупця передаються в MakeCommerce, а сторінка відкривається мовою магазину, якщо її підтримує MakeCommerce (естонська, англійська, латвійська, литовська, фінська, російська, німецька, польська), інакше — англійською. На цьому етапі замовлення ще не існує.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після того, як MakeCommerce його підтвердить: за підписаним сповіщенням або за підписаним поверненням покупця з перевіркою транзакції через API MakeCommerce. Після цього замовлення створюється, і покупець бачить стандартну сторінку підтвердження замовлення з повідомленням Your MakeCommerce payment has been received. Якщо замовлення було переведено на утримання для перевірки, сторінка показує Your MakeCommerce payment was received and is being reviewed by the shop.

Якщо платіж схвалено, але ще не завершено, або MakeCommerce недоступний, сторінка Payment confirmation показує We could not confirm your payment yet. If you completed it, your order will be updated automatically — please do not pay again. з кнопками Check again та Back to checkout. Сповіщення створить замовлення, щойно платіж буде завершено.

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

Якщо MakeCommerce не може розпочати платіж, покупець залишається в оформленні замовлення з повідомленням MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. або MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. Технічна причина записується в журнал.

Банк або картка обираються на сторінці MakeCommerce, а не в оформленні замовлення вашого магазину. Модуль не підтримує збережені картки, регулярні платежі чи підписки, а також доставку MakeCommerce (поштомати, етикетки).

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

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

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

Payment accepted: платіж підтверджено. Він фіксується з ID транзакції MakeCommerce, а примітка показує суму, транзакцію, середовище та спосіб перевірки (API MakeCommerce або підписане сповіщення).

MakeCommerce payment on hold: сплачена сума або валюта відрізнялися від кошика (наприклад, кошик змінили після початку платежу), суми не було, транзакція в MakeCommerce ще не була остаточною, хоча її позначено як завершену, або платіж надійшов після скасування замовлення. Примітка пояснює причину. Якщо сплачена валюта є валютою замовлення, у замовленні фіксується фактично сплачена сума. Транзакція з невідповідністю ніколи не оплачує замовлення пізніше; транзакція, яка ще не була остаточною, завершує замовлення, коли MakeCommerce повідомляє про її завершення. Перевірте транзакцію в Merchant Portal, а потім виконайте замовлення або поверніть платіж.

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

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

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

На сторінці замовлення відображається блок MakeCommerce payment з усіма транзакціями MakeCommerce кошика (дата, ID транзакції, позначка Test для тестових платежів, сума, статус і результат MakeCommerce), сплачені та повернені суми, історія повернень і MakeCommerce notes замовлення. Кнопки блоку потребують лише права редагувати замовлення, а не доступу до модулів.

Check MakeCommerce payment status: запитує в API MakeCommerce статус транзакцій кошика (спочатку найновіші), застосовує його та додає примітку з результатом. Використовуйте, коли покупець каже, що заплатив, але замовлення не було завершено.

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

У блоці MakeCommerce payment введіть суму (підставляється сума, яку ще не повернуто), за бажанням причину, і натисніть Refund via MakeCommerce. Підтвердіть запитання Refund this amount via MakeCommerce? Підтримуються повні та часткові повернення. Повернення обмежені сумою та валютою транзакції MakeCommerce, тому після невідповідності суми можна повернути не більше того, що покупець фактично сплатив, а не суму замовлення. Повернення надсилається в те середовище, в якому було здійснено платіж (тестове або робоче), тож ключі цього середовища мають бути налаштовані. Причина передається в MakeCommerce як коментар до повернення; якщо причини немає, коментар — Refund for order та номер замовлення. Якщо MakeCommerce не приймає повернення, блок показує помилку, додається примітка і повернення не фіксується. Якщо MakeCommerce ще обробляє платіж, виводиться повідомлення MakeCommerce is still processing this payment — try the refund again later. Успішне повернення додається до історії повернень і приміток із ID повернення MakeCommerce. Повне повернення переводить замовлення в статус Refunded. Часткове повернення статус не змінює. Повернення доступні після того, як MakeCommerce підтвердив платіж.

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

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

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

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

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

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

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

MakeCommerce не з'являється в оформленні замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено і в поточному середовищі є ключі: Test Shop ID та Test Secret key у тестовому режимі, Live Shop ID та Live Secret key у робочому режимі. Перевірте, що валюта кошика має не більше двох десяткових знаків. У розділі Payment > Preferences перевірте, що модуль дозволено для валюти кошика, країни покупця та групи покупця.

Платіж пройшов, але замовлення не створено: сповіщення не змогли дійти до магазину, наприклад через брандмауер або базову автентифікацію. Замовлення також створюється, коли покупець повертається до магазину або натискає Check again. Перевірте, що ключі того середовища, в якому здійснено платіж, налаштовані: сповіщення перевіряється за Secret key цього середовища, і без нього MakeCommerce отримує помилку та повторює спробу. Увімкніть Debug log, щоб побачити сповіщення.

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

Сповіщення відхиляються: повідомлення з неправильним підписом, для іншого кошика, іншого магазину або транзакції, не створеної для кошика, відхиляється, і нічого не змінюється. Перевірте, що Shop ID та Secret key належать одному обліковому запису та одному середовищу MakeCommerce.

Покупець бачить помилку під час вибору MakeCommerce: увімкніть Debug log і перегляньте поле Log на сторінці модуля. Валюта, яку MakeCommerce не може списати, дає повідомлення MakeCommerce cannot process payments in і код валюти.

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

Повернення не вдається з повідомленням No MakeCommerce transaction ID found for this order: у замовлення немає підтвердженого платежу MakeCommerce. Поверніть його в Merchant Portal.

Видалення

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

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