VibeFox Moyasar for OpenCart — Допомога
Вимоги
OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 і новіші (перевірено на 4.1.0.3).
PHP: 8.0 або новіша версія.
Валюта: валюта оформлення замовлення має бути SAR, AED, USD, EUR, KWD, BHD або OMR. Для будь-якої іншої валюти спосіб оплати приховується під час оформлення замовлення.
Обліковий запис Moyasar: вам потрібні секретні API-ключі вашого облікового запису Moyasar (тестові та робочі). Використовуються лише секретні ключі. Публічний ключ (publishable key) не потрібен, оскільки оплата відбувається на сторінці Moyasar. Рекомендовано налаштувати вебхук у Moyasar Dashboard (див. Налаштування).
Ліцензійний ключ VibeFox: купується на vibefox.net. Один ключ працює на одному домені.
Встановлення
Завантаження — це один zip-файл з пакетами для обох версій OpenCart. Розпакуйте його на своєму комп’ютері. Він містить README.txt, пакет для OpenCart 3 wcp_moyasar_payment_gateway-oc3-(version).ocmod.zip і пакет для OpenCart 4 wcp_moyasar_payment_gateway.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.
OpenCart 3
1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл wcp_moyasar_payment_gateway-oc3-(version).ocmod.zip. Розширення не містить модифікацій OCMOD, тож оновлювати Extensions > Modifications не потрібно. Замість інсталятора можна скопіювати вміст папки upload цього пакета в кореневу папку вашого магазину.
2. Перейдіть до Extensions > Extensions і виберіть тип Payments. Знайдіть VibeFox Moyasar Payment Gateway і натисніть Install (зелена кнопка +). Вашому адміністратору потрібне право змінювати список розширень оплати.
3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань. Вставте ваш ліцензійний ключ VibeFox у поле License key в блоці ліцензії у верхній частині сторінки і натисніть Activate (див. Ліцензійний ключ).
4. Вставте секретні ключі Moyasar і натисніть Save. Під час першого збереження генерується спільний секрет вебхука, який один раз відображається над налаштуваннями. Налаштуйте вебхук у Moyasar Dashboard з цим секретом (див. Налаштування).
5. Увімкніть Enable/Disable і натисніть Save. Створіть тестове замовлення в тестовому режимі, потім вимкніть Test mode.
OpenCart 4
1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл wcp_moyasar_payment_gateway.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з назви файлу, а перейменований пакет не працює.
2. Пакет з’явиться у списку встановлених розширень на тій самій сторінці. Натисніть Install (зелена кнопка +) поруч із ним.
3. Перейдіть до Extensions > Extensions і виберіть тип Payments. Знайдіть VibeFox Moyasar Payment Gateway, натисніть Install (зелена кнопка +), а потім Edit (кнопка з олівцем).
4. Введіть ліцензійний ключ, ключі Moyasar і вебхук так само, як у кроках з 3 до 5 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях. Відрізняється лише адреса вебхука (див. Webhook URL).
Нове встановлення починається з вимкненим способом оплати і увімкненим тестовим режимом.
Налаштування
Усі параметри розміщені на сторінці розширення: Extensions > Extensions > Payments > VibeFox Moyasar Payment Gateway > Edit. Розділи переліковано ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка попереджає, якщо для поточного режиму не задано секретний ключ (тоді спосіб оплати приховується під час оформлення замовлення), якщо не збережено спільний секрет вебхука (тоді вебхук відхиляє кожен виклик) або якщо валюта за замовчуванням у магазині не підтримується. Поки розширення увімкнено в тестовому режимі, сторінка показує Тестовий режим активний: платежі імітуються, кошти не списуються. Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.
Під час збереження Title має містити від 1 до 128 символів, Sort Order має бути цілим числом (від’ємні числа дозволено), Total має бути числом, більшим або рівним 0, а геозона та статуси замовлень мають існувати; інакше нічого не зберігається. Розширення відхиляє публічний ключ, ключ іншого режиму або ключ із пропусками: решта зберігається з повідомленням Налаштування збережено, крім ключа, показаного червоним., попередній ключ зберігається, і показується причина. Якщо розширення увімкнено без секретного ключа поточного режиму, налаштування зберігаються з попередженням.
Moyasar
Enable/Disable: Enable Moyasar вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.
Title: назва способу оплати, яку бачить покупець під час оформлення замовлення. Вона також зберігається в замовленні. За замовчуванням: Pay with Moyasar. Обов’язкове поле, до 128 символів.
Description: текст, який покупець бачить на кроці Confirm Order над кнопкою підтвердження. За замовчуванням: You will be redirected to the secure Moyasar payment page to pay with mada, Visa, Mastercard, Apple Pay or STC Pay. У тестовому режимі на цьому кроці додається (Тестовий режим: реальний платіж не виконується.)
Sort Order: позиція Moyasar серед способів оплати під час оформлення замовлення. Залиште поле порожнім або введіть ціле число.
Geo Zone: пропонувати Moyasar лише для платіжних адрес у вибраній геозоні. За замовчуванням: All zones. Геозони налаштовуються в System > Localisation > Geo Zones.
Total: сума кошика в валюті за замовчуванням магазину, яку має досягти замовлення, перш ніж буде запропоновано Moyasar. Залиште поле порожнім, щоб пропонувати Moyasar за будь-якої суми.
API-ключі
Скопіюйте секретні ключі з Moyasar Dashboard > Settings > API Keys (на сторінці є посилання туди). Тестові та робочі ключі окремі. Тестовий режим використовує лише тестовий ключ, робочий режим — лише робочий ключ.
Test mode: використовує тестовий секретний ключ: платежі імітуються, кошти не списуються. За замовчуванням: увімкнено. Вимкніть його, щоб приймати реальні платежі з робочим секретним ключем. Рахунки іншого режиму для перевірки статусу та повернень коштів і далі використовують ключ свого режиму.
Test secret key: секретний ключ тестового режиму. Починається з sk_test_.
Live secret key: секретний ключ робочого режиму. Починається з sk_live_.
Збережені ключі та секрети більше ніколи не показуються. Поле залишається порожнім і відображає Збережено — залиште порожнім, щоб зберегти. Вводьте нове значення, лише якщо хочете його змінити. Щоб видалити збережене значення, позначте Clear the saved value on save під полем і натисніть Save.
Сповіщення про платежі (вебхук)
Вебхук рекомендований, але не обов’язковий. Замовлення також підтверджуються, коли покупець повертається до магазину, і через повідомлення про рахунок, яке Moyasar автоматично надсилає до вашого магазину, коли рахунок оплачено. Вебхук охоплює покупців, які закрили браузер до повернення, і повідомляє про повернення коштів, виконані в Moyasar Dashboard. Додайте його в Moyasar Dashboard > Settings > Webhooks.
Webhook URL: показується лише для читання, з кнопкою Copy. На OpenCart 3 вона має такий вигляд: https://your-store/index.php?route=extension/payment/wcp_moyasar_payment_gateway/webhook, на OpenCart 4 — https://your-store/index.php?route=extension/wcp_moyasar_payment_gateway/payment/wcp_moyasar_payment_gateway.webhook. Вона формується з адреси вітрини вашої інсталяції OpenCart. Копіюйте адресу точно так, як її показано в налаштуваннях. HTTP-метод: POST. Адреса має бути доступна з інтернету.
Webhook shared secret: введіть те саме значення, що й Shared secret вебхука в Moyasar, або позначте Generate a new secret і збережіть. Якщо нічого не збережено, Save генерує випадковий секрет. Згенерований секрет відображається один раз над налаштуваннями після збереження і більше ніколи, тож одразу скопіюйте його в Moyasar. Вебхуки без правильного спільного секрету відхиляються. Один спільний секрет підходить для обох режимів.
Оберіть для вебхука такі події (їх також перелічено в цьому розділі):
Жодні дані з вебхука чи сповіщення не довіряються безпосередньо: для кожного з них розширення зчитує рахунок через API Moyasar з секретним ключем того режиму, в якому створено рахунок, і перевіряє, що його створив цей магазин. Платежі інших інтеграцій в тому самому обліковому записі Moyasar ігноруються.
Замовлення
OpenCart створює замовлення на кроці Confirm Order без статусу (незавершене замовлення). Замовлення отримує статус лише після того, як Moyasar підтвердить рахунок. Кожне поле нижче перелічує статуси замовлень вашого OpenCart.
Status after payment: статус, який встановлюється після підтвердженого платежу. За замовчуванням: Обробляється. Оберіть Complete, якщо оплачені замовлення мають одразу завершуватися, або ваш статус перевірки, якщо кожне оплачене замовлення має чекати ручної перевірки.
Awaiting Moyasar payment status: Moyasar утримує платіж для перевірки; замовлення переходить до Status after payment, коли Moyasar його підтверджує. За замовчуванням: Очікування.
Moyasar payment on hold status: Moyasar повідомив суму або валюту, що відрізняються від суми замовлення, або рахунок було оплачено після того, як замовлення скасували чи присвоїли йому інший статус. Замовлення не позначається як оплачене. За замовчуванням: Очікування, оскільки в OpenCart немає статусу «На утриманні». Ви можете створити власний статус у System > Localisation > Order Statuses і вибрати його тут.
Payment error status: платіж, що перевіряється, не пройшов. За замовчуванням: Невдало.
Refunded status: встановлюється після повного повернення коштів зі сторінки замовлення. За замовчуванням: Повернено.
Додатково
Debug log: записує виклики API та сповіщення у файл moyasar_p_debug.log.php у папці журналів OpenCart (storage/logs). Файл не можна відкрити з веб-браузера, а після досягнення 5 МБ його переміщують до moyasar_p_debug.old.log.php. Помилки та попередження записуються завжди. Ключі API, дані карток і дані покупців ніколи не записуються. За замовчуванням: вимкнено.
Log: показує поточний розмір журналу та його останні записи. Натисніть Clear log, щоб очистити його.
Clean uninstall: якщо увімкнено, видалення розширення також видаляє налаштування шлюзу та журнал. Платіжні дані, збережені разом із замовленнями (ідентифікатори рахунків і платежів Moyasar), зберігаються, щоб повернення коштів лишалися відстежуваними. За замовчуванням: вимкнено.
Імпорт / Експорт
Export: Download JSON зберігає налаштування у файл JSON. Ключі та секрети не експортуються.
Import: вставте раніше експортований JSON і натисніть Import, щоб відновити налаштування. Збережені ключі та секрети зберігаються.
Оформлення замовлення
На кроці Payment Method покупець обирає спосіб оплати (за замовчуванням Pay with Moyasar). На кроці Confirm Order покупець бачить ваш опис. OpenCart створює замовлення на цьому кроці, все ще без статусу. Коли покупець натискає Confirm Order, розширення створює рахунок Moyasar на суму замовлення у валюті замовлення і перенаправляє покупця на його сторінку оплати. Там покупець платить будь-яким методом, активним у вашому обліковому записі Moyasar. На OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options, і натискає внизу сторінки оформлення замовлення Confirm Order. У рахунку відображаються Order #, номер замовлення та назва вашого магазину.
Замовлення позначається оплаченим лише після підтвердження Moyasar: розширення зчитує рахунок через API Moyasar і перевіряє, що він оплачений, належить до цього замовлення і має точно таку ж суму та валюту, як замовлення. Потім замовлення отримує статус стандартним для OpenCart способом, зі звичайними листами про замовлення та оновленням залишків, а покупець бачить сторінку успішного замовлення OpenCart з повідомленням Your payment with Moyasar has been received. Якщо Moyasar утримує платіж для перевірки, сторінка показує Your payment is being reviewed by Moyasar. The order will be updated automatically when Moyasar confirms it — please do not pay again. Якщо замовлення утримується для вашої перевірки, сторінка показує We have received your payment and are reviewing your order. We will contact you if anything is needed — please do not pay again. Якщо платіж, що перевіряється, згодом не пройде, сторінка показує Your Moyasar payment was not completed. Please contact us about this order.
Якщо покупець повертається, не сплативши (наприклад, кнопкою «назад» на сторінці оплати), він повертається до оформлення замовлення з одним із таких повідомлень: The payment at Moyasar was not completed. You can try again or choose another payment method., Your Moyasar payment was declined or has expired. Please try again or choose another payment method. або, якщо платіж ще неможливо перевірити, We could not confirm your payment with Moyasar yet. If you completed the payment, the order will be updated automatically in a few minutes — please check your e-mail before paying again. На OpenCart 4 ці повідомлення показуються над сторінкою оформлення замовлення. Кошик зберігається.
Покупець може спробувати знову. OpenCart 3 створює нове замовлення щоразу, коли показується крок Confirm Order, а OpenCart 4 зберігає одне замовлення для оформлення і оплачує те саме замовлення знову. Розширення спершу перевіряє відкриті рахунки того самого кошика: якщо відкрита сторінка оплати цього замовлення все ще має той самий режим, суму та валюту, вона повторно використовується; інакше старий рахунок анулюється в Moyasar і створюється новий, тож старий уже не можна оплатити. Якщо з’ясовується, що один з попередніх рахунків кошика вже оплачено, підтверджується саме цей платіж замість створення нового.
OpenCart 4 зберігає замовлення в оформленні, доки не буде показано сторінку успіху. Якщо це замовлення було закрито без оплати (наприклад, ви його скасували або платіж не пройшов), покупця повертають до оформлення з повідомленням Your previous order was cancelled or its payment failed. Please confirm the order again., а наступне натискання Confirm Order оплачує нове замовлення. Замовлення кошика, яке було оплачено, а потім скасовано або повернено, більше не утримує кошик.
Якщо Moyasar не може розпочати платіж, покупець залишається на кроці Confirm Order з коротким повідомленням над кнопкою, наприклад The Moyasar payment service is not responding. Please try again in a few minutes., і може обрати інший спосіб оплати. Подробиці записуються в журнал.
Вебхук і повідомлення про рахунок також працюють, коли магазин перебуває в режимі обслуговування, бо OpenCart 3 пропускає запити платіжних розширень, а в OpenCart 4 розширення додає для них стартову дію, яка також пропускає повернення покупця з Moyasar.
Розширення приймає лише разові платежі на сторінці Moyasar. На вашому оформленні замовлення немає форми картки, немає збережених карток і токенізації, немає підписок і немає окремих авторизації та списання.
Замовлення та повернення коштів
Статуси замовлень
Без статусу (незавершене замовлення): покупця перенаправлено до Moyasar, і він не оплатив, Moyasar ще не підтвердив платіж, або платіж було відхилено, він прострочений чи скасований. У Sales > Orders такі замовлення показуються лише з фільтром Order Status, встановленим на Missing Orders.
Status after payment (за замовчуванням Обробляється): платіж підтверджено. Примітка показує, яким чином платіж було підтверджено (вебхук, повідомлення про рахунок, повернення покупця або оформлення замовлення), ідентифікатор рахунку, ідентифікатор платежу та спосіб оплати, наприклад марку картки та останні чотири цифри.
Awaiting Moyasar payment status (за замовчуванням Очікування): Moyasar утримує платіж для перевірки. Замовлення переходить до Status after payment, коли Moyasar підтверджує платіж, або до Payment error status, коли платіж не проходить.
Moyasar payment on hold status (за замовчуванням Очікування): Moyasar повідомив суму або валюту, що відрізняються від суми замовлення, або рахунок було оплачено після того, як ви скасували замовлення або змінили його статус. Замовлення не позначається як оплачене, але фактично списана сума фіксується для повернень. Примітка пояснює це. Перевірте платіж у Moyasar Dashboard, а потім виконайте замовлення або поверніть кошти.
Payment error status (за замовчуванням Невдало): платіж, що перевіряється, не пройшов.
Refunded status (за замовчуванням Повернено): платіж повністю повернено через розширення.
Оплачене або повернене замовлення ніколи не змінюється назад через наступні події. Якщо ви вже самостійно встановили статус «оплачено», платіж фіксується, а статус не змінюється. Якщо оплачується другий рахунок уже оплаченого кошика (наприклад, з двох вкладок браузера), оплачене замовлення не змінюється. Примітка просить вас повернути дублікат платежу в Moyasar Dashboard.
Примітки — це записи в History замовлення, які покупець не бачить.
Вкладка VibeFox Moyasar Payment Gateway
У Sales > Orders відкрийте замовлення, оплачене через Moyasar. Унизу сторінки замовлення, поруч із History і Additional, вкладка VibeFox Moyasar Payment Gateway показує Moyasar invoice (із позначкою Test mode для тестових платежів), Moyasar payment, Method, Status, суми Paid / refunded, форму повернення коштів, історію повернень і Moyasar notes замовлення. Вкладка показується користувачам, які мають доступ до розширення.
Повернення коштів
На вкладці VibeFox Moyasar Payment Gateway введіть Amount (підставляється сума, яку ще не повернуто), за бажанням Reason (optional), і натисніть Refund via Moyasar. Підтвердіть питання Повернути цю суму через Moyasar? Цю дію неможливо скасувати. Підтримуються повне та часткове повернення. Вам потрібне право змінювати розширення (встановлюється в System > Users > User Groups). Повернення виконуються в тій сумі та валюті, які списав Moyasar, тож після розбіжності сум можна повернути не більше, ніж покупець фактично сплатив, а не суму замовлення. Повне повернення платежу карткою, здійсненого менш як 2 години тому, надсилається як анулювання (void: скасування до розрахунку, без комісій); платежі через STC Pay та всі інші випадки повертаються звичайним чином. Повернення використовує секретний ключ режиму, в якому було здійснено платіж (тестовий або робочий), тому цей ключ має бути заданий. Розширення спершу перевіряє в Moyasar валюту, статус і суму, доступну до повернення. Якщо Moyasar не приймає повернення, вкладка показує помилку, і повернення не реєструється. Успішне повернення або анулювання додається до історії повернень і приміток. Повне повернення встановлює замовленню Refunded status без сповіщення покупця і без повернення товарів на склад, як і ручна зміна статусу. Часткове повернення статус не змінює. Повернення доступні, коли Moyasar підтвердив платіж.
Повернення товарів у Sales > Returns не повертають гроші через Moyasar.
Повернення та анулювання, виконані в Moyasar Dashboard, надходять через вебхук. Якщо Moyasar показує більшу повернуту суму, ніж зафіксувало розширення, до замовлення додається примітка. Статус замовлення автоматично не змінюється. За потреби оновіть його вручну, без використання Refund via Moyasar.
Ліцензійний ключ
Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Moyasar Payment Gateway — це перший блок на сторінці Extensions > Extensions > Payments > VibeFox Moyasar Payment Gateway > Edit, над налаштуваннями. Вставте ключ у License key і натисніть Activate. Після цього блок показує ключ у прихованому вигляді, статус (наприклад, дату, до якої ліцензія активна, і ваш домен), а також кнопки Check now, щоб перевірити статус знову, Change key, щоб ввести інший ключ, і Remove key, щоб вилучити ключ із цього магазину. Нижче розташовано рядок Product: opencart-payment-moyasar і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише адміністратори з правом Modify для розширення. Тексти блоку відповідають мові адмін-панелі (включено англійську та російську).
Якщо ключ не прийнято, блок вказує причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on і дату. Після зміни адреси магазину або після звільнення місця для домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, розширення продовжує працювати з останнім відомим статусом.
Один ключ працює на одному домені. Вилучення ключа з магазину не звільняє його місце для домену. Звільніть місце у своєму обліковому записі на vibefox.net.
Без активного ключа Moyasar не показується покупцям під час оформлення замовлення. Якщо платіж все одно розпочато, покупець бачить This payment method is not available. Please choose another one. Адміністратор, який увійшов в адмін-панель в тому самому браузері, усе ще бачить спосіб оплати в магазині, позначений як (unlicensed — visible to admins only), тож ви можете налаштувати та протестувати розширення, перш ніж купувати ключ. На OpenCart 4 такого попереднього перегляду немає: магазин не бачить входу в адмін-панель, тож без активного ключа спосіб оплати приховано для всіх. Після того як ви один раз відкрили сторінку Edit, на Dashboard адмін-панелі з’являється нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не змінюються: платежі, що вже розпочато, як і раніше підтверджуються, а повернення коштів працюють.
Коли термін дії ліцензії спливає, розширення продовжує працювати, але оновлення та підтримка потребують продовження. Статус перевіряється автоматично, коли ви відкриваєте Dashboard або сторінку Edit в адмін-панелі: раз на день протягом перших 14 днів після введення ключа, потім раз на тиждень. Cron-завдання не потрібне. Видалення розширення завжди вилучає ліцензійний ключ і статус ліцензії.
Усунення несправностей
Moyasar не відображається під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено і для поточного режиму задано секретний ключ: Test secret key у тестовому режимі або Live secret key у робочому. Сторінка налаштувань показує попередження, якщо ключ відсутній. Покупець має платити в SAR, AED, USD, EUR, KWD, BHD або OMR (валюті, вибраній у магазині). Також перевірте, що платіжна адреса належить до вибраної Geo Zone і що сума замовлення досягає значення Total, заданого в налаштуваннях.
Платіж пройшов, але замовлення залишається без статусу: підтвердження не дійшли до вашого магазину. Налаштуйте вебхук: у Moyasar Dashboard перевірте, що він існує, що його URL повністю збігається з Webhook URL з налаштувань, що метод — POST, вибрано всі чотири події, а спільний секрет збігається із збереженим у Webhook shared secret. Замовлення також отримує статус, коли покупець повертається до магазину або намагається знову оплатити той самий кошик.
Вебхук відповідає Unauthorized: спільний секрет у Moyasar відрізняється від збереженого. Введіть секрет вебхука Moyasar у Webhook shared secret і збережіть, або позначте Generate a new secret, збережіть і вставте показаний секрет у Moyasar.
Вебхук відповідає Webhook secret not configured: спільний секрет не збережено, наприклад після видалення за допомогою Clear the saved value on save. Натисніть Save, щоб згенерувати його, і скопіюйте в Moyasar.
Вебхук відповідає Key not configured: рахунок створено в режимі (тестовому або робочому), секретний ключ якого порожній. Введіть цей ключ.
Вебхук відповідає Verification failed або Try again later: рахунок не вдалося прочитати через API Moyasar, кошик у той самий момент оновлював інший запит, або не вдалося встановити статус замовлення. Moyasar повторить вебхук. Увімкніть Debug log, щоб побачити причину.
Адреса вебхука в браузері показує Method not allowed: це нормально. Адреса приймає лише POST-запити від Moyasar.
Помилка під час збереження через ключ: вставлено публічний ключ (pk_...) або ключ іншого режиму, або ключ містить пропуски. Попереднє значення збережено. Тестові ключі починаються з sk_test_, робочі — з sk_live_.
Покупець бачить помилку після Confirm Order: увімкніть Debug log і перегляньте поле Log на сторінці розширення. Повідомлення Цей спосіб оплати недоступний. означає, що сесія оформлення більше не відповідає замовленню, або спосіб оплати тим часом було вимкнено: покупець перезавантажує оформлення замовлення. Повідомлення Цей спосіб оплати тимчасово недоступний. Оберіть інший спосіб оплати або зв’яжіться з нами. зазвичай вказує на неправильний або відсутній секретний ключ. Повідомлення Платіж за це замовлення вже отримано і перевіряється. Зв’яжіться з нами, а не сплачуйте повторно. означає, що в кошика вже є оплачений рахунок, статус замовлення для якого не вдалося встановити; перевірте журнал.
Замовлення має статус утримання після оплати: прочитайте Moyasar notes на вкладці VibeFox Moyasar Payment Gateway. Сплачена сума або валюта відрізнялися від замовлення, або платіж надійшов після скасування замовлення. Виконайте замовлення або поверніть кошти.
На вкладці немає форми повернення коштів: вкладка вказує причину: платіж ще не підтверджено, він повністю повернений або ваша група користувачів не має права змінювати розширення.
Повернення не проходить: прочитайте повідомлення. Якщо платіж було здійснено в іншому режимі, введіть секретний ключ цього режиму. Якщо сума більша за ту, що ще можна повернути через Moyasar, частина платежу вже повернута, наприклад у Moyasar Dashboard. Якщо Moyasar не підтвердив повернуту суму, перевірте платіж у Moyasar Dashboard, перш ніж повторювати спробу.
Для розробників: розширення викликає події OpenCart moyasar_p_supported_currencies та moyasar_p_invoice_params, щоб змінити підтримувані валюти та дані рахунку.
Видалення
Перейдіть до Extensions > Extensions, виберіть тип Payments і натисніть Uninstall (червона кнопка −) поруч із VibeFox Moyasar Payment Gateway. Ліцензійний ключ і статус ліцензії цього розширення завжди вилучаються. OpenCart завжди видаляє власні налаштування розширення: Enable/Disable, Sort Order, Geo Zone, Total і статуси замовлень із розділу Orders, які під час повторного встановлення повертаються до значень за замовчуванням. Також видаляється подія OpenCart розширення (в OpenCart 4 — також його події та стартова дія, яка пропускає вебхук у режимі обслуговування). Якщо Clean uninstall увімкнено, видаляються решта налаштувань шлюзу (назва, опис, тестовий режим, ключі, спільний секрет вебхука, журнал налагодження) та журнал. Якщо вимкнено, їх зберігають для наступного повторного встановлення. Рахунки, платежі та повернення Moyasar завжди зберігаються, тож старі замовлення можна повернути й після повторного встановлення. Наявні замовлення зберігають свої примітки про платежі.
На OpenCart 4, щоб також видалити файли розширення, перейдіть до Extensions > Installer після видалення і натисніть Uninstall (помаранчева кнопка −) поруч із VibeFox Moyasar Payment Gateway у списку встановлених розширень, потім Delete (червона кнопка з кошиком), щоб видалити завантажений пакет.
Moyasar — торговельна марка її власника. Це розширення не пов’язане з Moyasar і не схвалене Moyasar.